Xác thực

API IDEAS AI sử dụng API Keys để xác thực yêu cầu. Mỗi yêu cầu phải bao gồm API key của bạn trong header Authorization.

Tạo API Key

Vào Workspace của bạn trong IDEAS AI System.
Điều hướng đến Teams → API Keys.
Nhấn Tạo Key mới, đặt tên mô tả (ví dụ: production-app) và thiết lập ngày hết hạn tùy chọn.
Sao chép key ngay lập tức — nó sẽ không được hiển thị lại sau khi tạo.

Giữ API key của bạn bí mật. Không commit nó vào version control. Sử dụng biến môi trường để lưu trữ trong ứng dụng của bạn.

Tìm hiểu thêm: Quản lý API Keys

Sử dụng API Key

Bao gồm API key như Bearer token trong header Authorization của mỗi yêu cầu:


Authorization: Bearer YOUR_API_KEY

Ví dụ sử dụng cURL:


curl -X GET https://api.ideas-ai.edu.vn/v1/agents \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

Ví dụ sử dụng JavaScript:


const response = await fetch('https://api.ideas-ai.edu.vn/v1/agents', {
  headers: {
    'Authorization': `Bearer ${process.env.IDEAS_API_KEY}`,
    'Content-Type': 'application/json',
  },
})
const data = await response.json()

Quyền hạn Key

API keys kế thừa quyền hạn vai trò của thành viên workspace đã tạo chúng.

Vai trò	Đọc	Ghi	Hành động Admin
Sinh viên	Có	Không	Không
Nhà nghiên cứu	Có	Có	Không
Quản trị viên	Có	Có	Có

Nếu API key bị xâm phạm, hãy thu hồi ngay lập tức từ Workspace → Teams → API Keys và tạo key mới.

Các bước tiếp theo

Tổng quan API — hiểu URL gốc và định dạng phản hồi
JavaScript SDK — sử dụng SDK thay vì gọi HTTP thuần