Khởi động nhanh
Hướng dẫn này giúp bạn xác thực người dùng và gọi API đầu tiên trong vài phút. Mọi ví dụ dùng API thật của hệ sinh thái xAI.
Điều kiện
Một tài khoản xAI Identity (đăng ký dùng thử tại identity.xai.io.vn). Ứng dụng của bạn nên chạy trên một subdomain *.xai.io.vn để dùng SSO bằng cookie chia sẻ.
Bước 1 — Xác thực người dùng
Gọi endpoint introspection để biết người dùng đã đăng nhập hay chưa. Cookie xv_session được trình duyệt gửi tự động trên mọi subdomain .xai.io.vn.
// Kiểm tra người dùng đã đăng nhập (trình duyệt tự gửi cookie xv_session)
const res = await fetch('https://identity.xai.io.vn/api/session', {
credentials: 'include',
});
const session = await res.json();
if (!session.authenticated) {
// Chưa đăng nhập → chuyển tới trang đăng nhập trung tâm
const back = encodeURIComponent(location.href);
location.href =
'https://identity.xai.io.vn/login?client_id=my-app&redirect=' + back;
}Bước 2 — Gọi API sản phẩm
Ví dụ: niêm phong dấu vân tay của một hóa đơn lên sổ cái với xAI Blockchain. Sandbox công khai chạy chế độ mock, không cần ví.
curl -X POST 'https://blockchain.xai.io.vn/api/anchor' \
-H 'Content-Type: application/json' \
-d '{
"scenario": "e_invoice",
"payloadId": "INV-2026-001",
"dataFields": { "taxId": "0312345678", "amount": 500000000 }
}'Bước 3 — Dùng API thông minh
xAI Governance cung cấp các API chạy trên Workers AI. Ví dụ phân loại rủi ro hệ thống AI theo EU AI Act:
const res = await fetch('https://governance.xai.io.vn/api/ai/classify-risk', {
method: 'POST',
credentials: 'include',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({ description: 'Chấm điểm tín dụng tự động', lang: 'vi' }),
});
const { tier, obligations } = await res.json();Bước tiếp theo