Bắt đầu nhanh

Quizzz API cho phép bạn quản lý nội dung tài khoản của mình qua giao thức HTTPS — bao gồm bài kiểm tra, danh sách học viên, bài tập, kết quả và trang cá nhân công khai của giáo viên. Đây là một REST API tiêu chuẩn: các URL hướng tài nguyên, nội dung yêu cầu và phản hồi bằng định dạng JSON, cùng các mã trạng thái HTTP chuẩn mực.

Bạn không muốn viết mã lệnh mà thích ra lệnh bằng ngôn ngữ tự nhiên? Hãy kết nối tài khoản với Claude qua Bộ kết nối Claude (MCP) và trò chuyện trực tiếp. Hoặc Mở Quizzz ↗ để quản lý thủ công trên giao diện web.

URL gốc (Base URL)

Môi trường	Base URL
Môi trường chính thức (Production)	https://quizzz.techtranslab.com

Tất cả các endpoint bên dưới đều bắt đầu từ URL gốc này, ví dụ: https://quizzz.techtranslab.com/api/v1/profile.

Lấy khóa API (API Key)

Khả năng truy cập API được cung cấp trên gói tài khoản Pro. Tạo khóa từ phần cài đặt tài khoản tại mục Khóa API (API Keys), chọn các phạm vi quyền hạn (scopes) cần cấp, sau đó sao chép giá trị khóa — khóa này chỉ hiển thị một lần duy nhất khi tạo và bắt đầu bằng tiền tố qz_.

Chưa có gói Pro? Sử dụng Bộ kết nối Claude (MCP)

REST API dưới đây yêu cầu gói Pro, nhưng Bộ kết nối Claude (MCP) thì không giới hạn gói tài khoản — tính năng này hoạt động cả trên gói miễn phí và hoàn toàn không cần khóa API.

Hãy bảo mật khóa API như mật khẩu: khóa mang toàn bộ quyền hạn theo các phạm vi bạn đã cấp. Hãy lưu trữ khóa an toàn ở phía máy chủ (server-side) và tuyệt đối không nhúng vào mã nguồn chạy ở phía trình duyệt khách (client-side).

Xác thực (Authentication)

Gửi khóa dưới dạng Bearer token trong tiêu đề Authorization của mọi yêu cầu HTTP:

curl https://quizzz.techtranslab.com/api/v1/info \
  -H "Authorization: Bearer qz_khoa_api_cua_ban"

Yêu cầu thiếu khóa hoặc khóa không hợp lệ sẽ nhận phản hồi lỗi 401. Khóa thiếu phạm vi quyền hạn (scope) mà endpoint đó yêu cầu sẽ nhận lỗi 403.

Các nhóm phạm vi quyền hạn (Scopes)

Theo mặc định, khóa API mới tạo sẽ có toàn quyền (full access) trên tài khoản của bạn. Khi tạo khóa, bạn có thể tùy chọn giới hạn khóa trong một hoặc nhiều nhóm phạm vi quyền hạn — trong hộp thoại tạo khóa, mở rộng mục Scopes và chỉ đánh dấu chọn các nhóm cần thiết. Mỗi endpoint đều nêu rõ phạm vi yêu cầu trong bảng tài liệu tham chiếu.

Nhóm phạm vi	Quyền hạn	Nội dung bao gồm
info	api:info:read	Thông tin tài khoản
profile	api:profile:read, api:profile:write	Trang cá nhân công khai
branding	api:branding:read, api:branding:write	Thương hiệu trang & SEO
quiz	api:quiz:read, api:quiz:write	Bài kiểm tra & tạo đề
student	api:student:read, api:student:write	Danh sách học viên
assignment	api:assignment:read, api:assignment:write	Giao bài tập / Liên kết chia sẻ
collection	api:collection:read, api:collection:write	Bộ sưu tập bài thi
result	api:result:read	Kết quả làm bài

Giới hạn tốc độ (Rate limits)

API chỉ khả dụng trên gói Pro — các khóa thuộc các gói tài khoản khác sẽ bị từ chối với mã 401. Tài khoản Pro có hạn mức là 30 yêu cầu mỗi phút (requests per minute) cho mỗi tài khoản.

Vượt quá giới hạn trên sẽ nhận phản hồi mã 429. Các nỗ lực xác thực thất bại liên tiếp sẽ bị điều tiết (throttled) riêng.

Lệnh gọi API đầu tiên của bạn

Thử truy vấn thông tin tài khoản để kiểm tra khóa API đã hoạt động chính xác:

curl https://quizzz.techtranslab.com/api/v1/info \
  -H "Authorization: Bearer qz_khoa_api_cua_ban"

{
  "data": {
    "teacher_id": "…",
    "email": "[email protected]",
    "plan_tier": "pro",
    "locale": "en"
  }
}

Từ đây, bạn có thể xem tiếp Tài liệu API chi tiết.