Mã lỗi
Ba nhóm: mã nghiệp vụ exitcode (HTTP 200), mã hệ thống từ Platform của RAR, và mã VRF_ do AgentGW tự trả.
Mã nghiệp vụ exitcode (HTTP 200)
| exitcode | Thông điệp | Nghĩa |
|---|---|---|
| 0 | — | Thành công, chứng thư số trên chip hợp lệ |
| 1 | Invalid idcard strings | Chuỗi số CCCD không hợp lệ |
| 2 | invalidType licenseID | Định dạng license_id không hợp lệ |
| 3 | Invalid device_type | device_type không hợp lệ |
| 4 | Invalid DIACHI | dia_chi không hợp lệ |
| 5 | invalid vendor name | Tên nhà cung cấp không hợp lệ |
| 6 | invalid certificate | Chứng thư số trên chip không hợp lệ |
| 7 | invalid user | Tài khoản kết nối không hợp lệ |
| 8 | check licenseID failed | Kiểm tra giấy phép thất bại |
| 9 | license is expired | Giấy phép hết hạn |
| 10 | Error checking user credentials | Lỗi khi kiểm tra thông tin xác thực tài khoản |
| 11 | Invalid credentials | Thông tin xác thực không hợp lệ |
Mã hệ thống từ Platform (RAR)
AgentGW chuyển nguyên về cho bên gọi.
| HTTP | error_code | Mô tả |
|---|---|---|
| 400 | BAD_REQUEST | Body thiếu hoặc sai định dạng; chữ ký không hợp lệ |
| 401 | UNAUTHORIZED | Token không hợp lệ hoặc hết hạn |
| 403 | FORBIDDEN / ACCESS_DENIED | license_id không khớp thông tin đã đăng ký |
| 409 | CONFLICT | request_id đã được xử lý hoặc đang xử lý |
| 429 | TOO_MANY_REQUESTS | Gửi quá nhiều trong thời gian ngắn |
| 500 | INTERNAL_SERVER_ERROR | Lỗi nội bộ; có thể thử lại sau |
| 502 | BAD_GATEWAY | Không nối được hệ thống khác; dữ liệu trả về sai định dạng |
| 504 | GATEWAY_TIMEOUT | Quá thời gian xử lý, đã thử lại nhưng chưa thành công |
Mã từ AgentGW (tiền tố VRF_)
| HTTP | error_code | Mô tả |
|---|---|---|
| 400 | VRF_MISSING_HEADER | Thiếu header bắt buộc |
| 400 | VRF_INVALID_BODY | Không đọc được body, JSON sai, hoặc thiếu id_card / dscert |
| 400 | VRF_INVALID_ID_CARD | id_card không phải chuỗi 1–12 chữ số |
| 405 | VRF_METHOD_NOT_ALLOWED | Sai method |
| 413 | VRF_BODY_TOO_LARGE | Body quá lớn (mặc định 1 MB) |
| 429 | VRF_RATE_LIMITED | Vượt giới hạn: mặc định 100 request / giây / IP, burst 200 |
| 500 | VRF_CRYPTO_FAIL | Không mã hoá được id_card hoặc dscert qua HSM (không nối được HSM, HSM trả lỗi) |
| 500 | VRF_INTERNAL | Lỗi nội bộ AgentGW |
| 502 | VRF_PLATFORM_UNREACHABLE | Không nối được Platform |
| 502 | VRF_PLATFORM_ERROR | Gọi Platform thất bại |
| 504 | VRF_PLATFORM_TIMEOUT | Gọi Platform quá thời gian |
Nguyên tắc xử lý
| Nhóm lỗi | Thử lại? |
|---|---|
| 400, 401, 403 | Không, cho tới khi tìm ra và sửa nguyên nhân |
| 500, 503 | Được, theo cơ chế giãn cách tăng dần (backoff); lặp lại lâu thì báo Ban kỹ thuật RAR |
- Hiện thông báo phù hợp cho người dùng, ghi nhật ký nội bộ, không lộ chi tiết kỹ thuật ra ngoài.
- Gặp lỗi chữ ký / xác thực, kiểm lần lượt: đường dẫn khoá → khoá đúng môi trường → thứ tự chuỗi ký →
request_time→license_id→device_type→dia_chi→id_card→dscert.
Hành vi đo được trên Sandbox có chỗ khác bảng này, xem Kết quả kiểm thử Sandbox.