Trong trường hợp xảy ra lỗi, DPA dự kiến sẽ trả về mã trạng thái HTTP cùng với phản hồi HTTP PHẢI bao gồm đối tượng JSON kèm theo thêm thông tin về lỗi. Phần nội dung phản hồi lỗi PHẢI chứa một bản sao của ErrorResponse.
{
"errorMessage": string,
"cause": enum(ErrorCause)
}
Phản hồi lỗi DPA PHẢI tương ứng với thông tin sau:
- Người dùng hiện đang chuyển vùng và truy vấn DPA đã bị tắt đối với người dùng này. DPA trả về lỗi 403 với USER_ROAMING là nguyên nhân gây ra lỗi.
- DPA trả về mã lỗi 404 NOT_LOOK cho biết GTAF biết rằng khoá người dùng không hợp lệ (tức là khoá người dùng không tồn tại) với INVALID_NUMBER.
- DPA trả về mã lỗi 410 GONE với BAD_CPID vì lỗi này báo cho GTAF biết rằng ứng dụng sẽ nhận được một khóa người dùng mới nếu khóa_loại = CPID và CPID đã hết hạn.
- DPA sẽ trả về mã lỗi 501 NOT_IMPLEMENTED cho biết rằng mã này không hỗ trợ cuộc gọi này với nguyên nhân lỗi DỊCH_VỤ_DỊCH_VỤ.
- DPA trả về một lỗi 429 TOO MANY với yêu cầu TOO_MANY_ nghĩa là có tiêu đề Thử lại sau khi chỉ ra rằng GTAF đang gửi quá nhiều yêu cầu đến DPA.
- DPA trả về lỗi CONFLICT 409 cho biết không thể hoàn thành yêu cầu do có xung đột với trạng thái hiện tại của DPA.
- Dịch vụ tạm thời không khả dụng. DPA sẽ trả về một DỊCH VỤ 503 KHÔNG DÙNG ĐƯỢC với tiêu đề Thử lại sau khi cho biết thời điểm có thể thực hiện một yêu cầu mới.
- DPA trả về mã lỗi 500 LỖI MÁY CHỦ NỘI BỘ cho tất cả các lỗi chưa được chỉ định khác ERROR_CAUSE_UNSPECIFIED là nguyên nhân gây ra lỗi.
Trong trường hợp xảy ra lỗi trong khi mua hàng, các mã lỗi sau đây đại diện cho các kết quả giao dịch không thành công:
- DPA trả về mã lỗi YÊU CẦU BAD 400 để cho GTAF biết rằng mã gói đã mua không hợp lệ.
- DPA trả về mã lỗi 402 PAYMENT bắt buộc cho GTAF biết rằng người dùng không có đủ số dư để hoàn tất giao dịch mua.
- DPA trả về mã lỗi CONFLICT 409 cho GTAF biết rằng gói mà bạn mua sẽ không tương thích với tổ hợp sản phẩm hiện tại của người dùng. Ví dụ: nếu chính sách gói dữ liệu của nhà mạng không cho phép kết hợp gói trả sau và gói trả trước, việc cố gắng mua gói trả trước cho người dùng trả sau sẽ dẫn đến lỗi CONFLICT 409.
- DPA trả về mã lỗi 403 FORBIDDEN cho GTAF biết rằng giao dịch hiện tại là bản sao của một giao dịch đã phát hành trước đó. Mã
DPA PHẢI trả về các nguyên nhân lỗi sau đây để phản hồi:
- Nếu giao dịch trước đó là không thành công, thì lỗi sẽ cho biết lý do lỗi.
- Nếu giao dịch trước đó thành công, DUPLICATE_TRANSACTION.
- Nếu giao dịch trước đó vẫn đang chờ xử lý, REQUEST_QUEUED.