Tài liệu API
Cập nhật lần cuối: 2026-07-06
Thông tin chung
- Base URL:
https://api.hamicodeviet.com - Xác thực: Bearer token (JWT) qua header
Authorization: Bearer <token> - Định dạng: JSON
- CORS: Cho phép từ
hamicodeviet.comvàapp.hamicodeviet.com
Nhóm route
| Nhóm | Đường dẫn | Mô tả |
|---|---|---|
| Auth | /auth | Đăng ký, đăng nhập, xác minh, đặt lại mật khẩu |
| Guardian | /guardian | Người giám hộ, liên kết |
| Consent | /consent | Quản lý đồng thuận |
| Country Policy | /country-policy | Chính sách theo quốc gia |
| Courses | /courses | Duyệt, đăng ký khóa học |
| Progress | /progress | Theo dõi tiến độ |
| Payments | /payments | Thanh toán PayPal |
| Admin | /admin | Quản trị hệ thống |
| Products | /products | Sản phẩm marketplace |
| Entitlements | /entitlements | Quyền AI |
| Refunds | /refunds | Hoàn tiền |
| GDPR | /gdpr | Xuất/xóa dữ liệu |
| AI | /ai | Hội thoại AI, bộ nhớ (proxy đến aiagent.iai.one) |
| CodeLab | /codelab | Thực hành code |
| Marketplace | /marketplace | Chợ sản phẩm |
| School | /school | Quản lý trường học |
| Contact | /contact | Form liên hệ |
| Portfolio | /portfolio | Portfolio cá nhân |
| Certificates | /certificates | Chứng chỉ |
| Notifications | /notifications | Thông báo trong ứng dụng |
| Features | /features | Tính năng hệ thống |
| Projects | /projects | Dự án người dùng |
| Factory | /factory | Course Factory |
| Creator | /creator | Creator Studio |
Giới hạn tỷ lệ
Xem chi tiết tại giới hạn tỷ lệ. Header phản hồi:
X-RateLimit-Limit— Giới hạnX-RateLimit-Remaining— Còn lạiX-RateLimit-Reset— Thời gian reset
Định dạng lỗi
{
"error": "rate_limited",
"message": "Quá nhiều yêu cầu. Vui lòng thử lại sau.",
"retryAfter": 60
}Health check
GET /health # API health
GET /health/email # Email system healthAI API endpoint
Hệ thống AI được vận hành bởi nền tảng tự học aiagent.iai.one. API HaMi Code Việt đóng vai trò proxy:
- Chat:
POST /ai/chat— Gửi tin nhắn đến AI agent - Quota:
GET /ai/quota— Kiểm tra hạn mức sử dụng - Conversations:
GET /ai/conversations— Danh sách hội thoại - Memory:
GET /ai/memory— Xem bộ nhớ AI (gói Starter trở lên)
Tất cả yêu cầu đi qua api.hamicodeviet.com/ai, được xác thực JWT và giới hạn tỷ lệ trước khi chuyển tiếp đến aiagent.iai.one.