Trung tâm tích hợp
Sự kiện & mã lỗi
Dành cho nhà cung cấp, đội phát triển và đối tác tích hợp. Mỗi API liên kết với dịch vụ, ngữ cảnh và bằng chứng.
Mã lỗi rõ nghĩa
Không khớp là kết quả nghiệp vụ; 401/403/503 là lỗi giao thức, quyền hoặc dịch vụ.
| HTTP | Mã mẫu | Hành vi khuyến nghị |
|---|---|---|
| 422 | CAPTURE_QUALITY_LOW | Thu nhận chưa đạt; hướng dẫn thử lại. |
| 422 | PRESENTATION_REJECTED | Không tiếp tục phiên; chuyển phương án thay thế theo chính sách. |
| 409 | SESSION_EXPIRED | Tạo phiên mới, không phát lại dữ liệu cũ. |
| 403 | DEVICE_UNTRUSTED | Từ chối phiên và chuyển đội vận hành kiểm tra thiết bị. |
| 403 | SCOPE_NOT_ALLOWED | Kiểm tra quyền ứng dụng khách, tổ chức và mục đích. |
| 429 | RATE_LIMITED | Tôn trọng Retry-After, giới hạn số lần thử lại. |
| 503 | PROCESSING_UNAVAILABLE | Không suy diễn thành công; dùng phương án thay thế. |
Sự kiện có thể đến trùng hoặc khác thứ tự
| Thành phần | Yêu cầu |
|---|---|
| eventId / requestId / traceId | Dùng mã sự kiện để chống xử lý trùng; traceId chỉ hỗ trợ truy vết. |
| eventTime / phiên bản | Xử lý theo trạng thái và phiên bản; không chỉ dựa vào thứ tự đến. |
| chữ ký / xác thực | Cơ chế chữ ký webhook hoặc mTLS cần được thỏa thuận; không tự chấp nhận lệnh gọi ngược (callback). |
| thử lại / hàng đợi lỗi (dead-letter) | Giới hạn thử lại, có đối soát và xử lý thủ công khi cần. |