API & SDK

Xác thực

Bảo mật là ưu tiên hàng đầu. API IDEAS AI sử dụng API Keys để xác thực yêu cầu — một cơ chế đơn giản nhưng đủ mạnh: mỗi yêu cầu chỉ cần kèm theo API key của bạn trong header Authorization là được.

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.

Sử dụng API Key

Sau khi đã có key, việc sử dụng rất đơn giản: đính kèm nó dưới dạng 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

Bạn không cần cấu hình phân quyền phức tạp: API keys tự động 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