API Reference
Last updated: 2026-07-06
General Information
- Base URL:
https://api.hamicodeviet.com - Authentication: Bearer token (JWT) via
Authorization: Bearer <token>header - Format: JSON
- CORS: Allowed from
hamicodeviet.comandapp.hamicodeviet.com
Route Groups
| Group | Path | Description |
|---|---|---|
| Auth | /auth | Signup, login, verify, password reset |
| Guardian | /guardian | Guardian, links |
| Consent | /consent | Consent management |
| Country Policy | /country-policy | Country-specific policies |
| Courses | /courses | Browse, enroll in courses |
| Progress | /progress | Track progress |
| Payments | /payments | PayPal payments |
| Admin | /admin | System administration |
| Products | /products | Marketplace products |
| Entitlements | /entitlements | AI entitlements |
| Refunds | /refunds | Refunds |
| GDPR | /gdpr | Data export/deletion |
| AI | /ai | AI conversations, memory (proxy to aiagent.iai.one) |
| CodeLab | /codelab | Code practice |
| Marketplace | /marketplace | Product marketplace |
| School | /school | School management |
| Contact | /contact | Contact form |
| Portfolio | /portfolio | Personal portfolio |
| Certificates | /certificates | Certificates |
| Notifications | /notifications | In-app notifications |
| Features | /features | System features |
| Projects | /projects | User projects |
| Factory | /factory | Course Factory |
| Creator | /creator | Creator Studio |
Rate Limits
See rate limits for details. Response headers:
X-RateLimit-Limit— LimitX-RateLimit-Remaining— RemainingX-RateLimit-Reset— Reset time
Error Format
{
"error": "rate_limited",
"message": "Too many requests. Please try again later.",
"retryAfter": 60
}Health Checks
GET /health # API health
GET /health/email # Email system healthAI API Endpoint
The AI system is powered by the self-learning platform at aiagent.iai.one. The HaMi Code Việt API acts as a proxy:
- Chat:
POST /ai/chat— Send a message to an AI agent - Quota:
GET /ai/quota— Check usage quota - Conversations:
GET /ai/conversations— List conversations - Memory:
GET /ai/memory— View AI memory (Starter tier and above)
All requests go through api.hamicodeviet.com/ai, authenticated with JWT and rate-limited before being forwarded to aiagent.iai.one.