Tài liệu API
Mã lỗi API
Mỗi lỗi của API Nhịp Số mang một mã (trường type). API bản đồ /v1/maps trả type là đường dẫn tới trang của mã đó. Chọn một mã để xem nguyên nhân và cách khắc phục.
| HTTP | Mã lỗi | Ý nghĩa |
|---|---|---|
| 400 | VALIDATION_ERROR | Parameter sai hoặc thiếu |
| 400 | ORIGIN_INVALID | Origin nhập vào không đúng định dạng (khoảng trắng, wildcard…) |
| 400 | ORIGINS_REQUIRED | Public key cần ít nhất một origin hợp lệ |
| 401 | UNAUTHORIZED | Thiếu hoặc sai xác thực |
| 401 | INVALID_CREDENTIALS | Email hoặc mật khẩu sai |
| 401 | INVALID_TOKEN | Token không hợp lệ |
| 401 | TOKEN_EXPIRED | Token đã hết hạn |
| 403 | FORBIDDEN | Không đủ quyền |
| 403 | ORIGIN_NOT_ALLOWED | Public key gọi từ origin không nằm trong allowlist (hoặc allowlist rỗng) |
| 403 | EMAIL_NOT_VERIFIED | Email chưa được xác minh |
| 404 | NOT_FOUND | Resource không tồn tại |
| 409 | EMAIL_TAKEN | Email đã được đăng ký |
| 410 | GONE | Tài nguyên đã hết hiệu lực (vd. lượt dữ liệu cũ) — tải lại siêu dữ liệu |
| 429 | RATE_LIMITED | Vượt giới hạn request |
| 429 | QUOTA_EXCEEDED | Vượt hạn mức sử dụng tháng |
| 503 | SERVICE_UNAVAILABLE | Tạm thời chưa có dữ liệu — thử lại sau (kèm Retry-After) |
| 500 | INTERNAL_ERROR | Lỗi server ngoài dự kiến |