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)

exitcodeThông điệpNghĩa
0—Thành công, chứng thư số trên chip hợp lệ
1Invalid idcard stringsChuỗi số CCCD không hợp lệ
2invalidType licenseIDĐịnh dạng license_id không hợp lệ
3Invalid device_typedevice_type không hợp lệ
4Invalid DIACHIdia_chi không hợp lệ
5invalid vendor nameTên nhà cung cấp không hợp lệ
6invalid certificateChứng thư số trên chip không hợp lệ
7invalid userTài khoản kết nối không hợp lệ
8check licenseID failedKiểm tra giấy phép thất bại
9license is expiredGiấy phép hết hạn
10Error checking user credentialsLỗi khi kiểm tra thông tin xác thực tài khoản
11Invalid credentialsThô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.

HTTPerror_codeMô tả
400BAD_REQUESTBody thiếu hoặc sai định dạng; chữ ký không hợp lệ
401UNAUTHORIZEDToken không hợp lệ hoặc hết hạn
403FORBIDDEN / ACCESS_DENIEDlicense_id không khớp thông tin đã đăng ký
409CONFLICTrequest_id đã được xử lý hoặc đang xử lý
429TOO_MANY_REQUESTSGửi quá nhiều trong thời gian ngắn
500INTERNAL_SERVER_ERRORLỗi nội bộ; có thể thử lại sau
502BAD_GATEWAYKhông nối được hệ thống khác; dữ liệu trả về sai định dạng
504GATEWAY_TIMEOUTQuá thời gian xử lý, đã thử lại nhưng chưa thành công

Mã từ AgentGW (tiền tố VRF_)

HTTPerror_codeMô tả
400VRF_MISSING_HEADERThiếu header bắt buộc
400VRF_INVALID_BODYKhông đọc được body, JSON sai, hoặc thiếu id_card / dscert
400VRF_INVALID_ID_CARDid_card không phải chuỗi 1–12 chữ số
405VRF_METHOD_NOT_ALLOWEDSai method
413VRF_BODY_TOO_LARGEBody quá lớn (mặc định 1 MB)
429VRF_RATE_LIMITEDVượt giới hạn: mặc định 100 request / giây / IP, burst 200
500VRF_CRYPTO_FAILKhông mã hoá được id_card hoặc dscert qua HSM (không nối được HSM, HSM trả lỗi)
500VRF_INTERNALLỗi nội bộ AgentGW
502VRF_PLATFORM_UNREACHABLEKhông nối được Platform
502VRF_PLATFORM_ERRORGọi Platform thất bại
504VRF_PLATFORM_TIMEOUTGọi Platform quá thời gian

Nguyên tắc xử lý

Nhóm lỗiThử lại?
400, 401, 403Khô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

Hành vi đo được trên Sandbox có chỗ khác bảng này, xem Kết quả kiểm thử Sandbox.