ออบเจ็กต์: ErrorResponse
จัดทุกอย่างให้เป็นระเบียบอยู่เสมอด้วยคอลเล็กชัน
บันทึกและจัดหมวดหมู่เนื้อหาตามค่ากำหนดของคุณ
เนื้อหาการตอบกลับ
เนื้อหา HTTP สำหรับการตอบกลับ HTTP ทั้งหมดที่ไม่ใช่ 200
ตัวอย่างคำตอบจะมีลักษณะดังนี้
{
"responseHeader": {
"responseTimestamp": "1481899949611"
},
"errorResponseCode": "INVALID_IDENTIFIER",
"errorDescription": "Unknown paymentIntegratorAccountId: PIAID1",
}
การแสดง JSON
{
"responseHeader" : {
object(ResponseHeader
)
} ,
"errorResponseCode" : string ,
"errorDescription" : string ,
}
ช่อง
responseHeader
object(ResponseHeader
)
ต้องระบุ : ส่วนหัวทั่วไปของคำตอบทั้งหมด
errorResponseCode
string
ไม่บังคับ : ระบุรหัสใดรหัสหนึ่งที่ระบุไว้ใน
ในตารางด้านล่าง
โค้ดตอบกลับข้อผิดพลาดและรหัส HTTP ที่แนะนำ
INVALID_API_VERSION
400
ใช้ในกรณีที่ผู้ผสานรวมระบบไม่รองรับ API ของคำขอ
เวอร์ชัน
INVALID_PAYLOAD_SIGNATURE
401
ใช้หากลายเซ็นของเพย์โหลดเป็นข้อมูลที่ไม่ทราบ หรือ
คีย์ที่ไม่ได้ใช้งาน
INVALID_PAYLOAD_ENCRYPTION
400
ใช้ในกรณีที่การเข้ารหัสเพย์โหลดเป็นข้อมูลที่ไม่รู้จักหรือ
คีย์ที่ไม่ได้ใช้งาน
REQUEST_TIMESTAMP_OUT_OF_RANGE
400
ใช้หาก request_timestamp
ไม่ใช่ ±60 ของ
กันเลย
INVALID_IDENTIFIER
404
ใช้เมื่อตัวระบุที่ส่งในคำขอไม่ถูกต้องหรือ
ไม่รู้จัก ซึ่งอาจรวมถึง paymentIntegratorAccountId
googlePaymentToken
captureRequestId
ฯลฯ ประเภทของฟิลด์ที่ไม่ถูกต้อง
ควรระบุใน errorDescription
IDEMPOTENCY_VIOLATION
412
ใช้หากคำขอละเมิดข้อกำหนดด้านข้อมูลประจำตัวสำหรับ
คำขอ
INVALID_FIELD_VALUE
400
ใช้เมื่อคำขอมีค่าสำหรับช่องที่ไม่ได้อยู่ใน
ชุดค่าที่รองรับ
MISSING_REQUIRED_FIELD
400
ใช้เมื่อไม่ได้ตั้งค่าช่องที่จำเป็นในคำขอ
PRECONDITION_VIOLATION
400
ใช้หากเกิดการละเมิดข้อจำกัดในการดำเนินการ (เช่น เมื่อ
คำขอรับเงินคืน เกินจำนวนเงินคงเหลือเมื่อวันที่
ธุรกรรมนั้น)
USER_ACTION_IN_PROGRESS
400
ใช้ในกรณีที่ไม่สามารถประมวลผลคำขอได้ในขณะนี้เนื่องจาก
รบกวนการดำเนินการของผู้ใช้ในกระบวนการ
ทำหน้าที่ล็อกระบบ ต้องไม่ ใช้รหัสนี้เพื่อ
ระบุความล้มเหลวที่เกิดจากการติดตั้งภายใน
การเกิดขึ้นพร้อมกัน
INVALID_DECRYPTED_REQUEST
400
ใช้ในกรณีที่เพย์โหลดคำขอสามารถถอดรหัสได้ แต่
ไม่สามารถแยกวิเคราะห์ข้อความผลลัพธ์
errorDescription
string
ไม่บังคับ : ระบุรายละเอียดของสถานะนี้สำหรับ
จำนวนครั้งในการแก้ไขข้อผิดพลาด โปรดทราบว่าระบบจะไม่แสดงข้อมูลนี้ให้ผู้ใช้เห็น
อาจมีข้อความอธิบายที่ไม่ใช่ข้อความที่ละเอียดอ่อนซึ่งใช้ในการแก้ไขข้อบกพร่อง
โปรดทราบว่าค่าบางค่าสำหรับ errorResponseCode
ควรเป็น
พร้อมกับรายละเอียดเพิ่มเติมในช่องนี้ (เช่น
INVALID_IDENTIFIER
ควรมีข้อมูลใน
ช่องนี้เพื่อระบุว่าประเภทของตัวระบุไม่ถูกต้อง)
คำเตือน: อย่าใส่โทเค็นใน
ข้อความนี้ เว้นแต่จะกำหนดเป็นสาธารณะ
สงวนลิขสิทธิ์ Java เป็นเครื่องหมายการค้าจดทะเบียนของ Oracle และ/หรือบริษัทในเครือ
อัปเดตล่าสุด 2025-07-25 UTC
[null,null,["อัปเดตล่าสุด 2025-07-25 UTC"],[],["Non-200 HTTP responses contain a body with error details. This body includes a `responseHeader`, `errorResponseCode`, and `errorDescription`. The `errorResponseCode` field specifies the error type (e.g., `INVALID_IDENTIFIER`, `INVALID_API_VERSION`), accompanied by an advised HTTP code. The optional `errorDescription` provides debugging information for support. Required field is `responseHeader` and fields `errorResponseCode` and `errorDescription` are optional. The content specifies that the field `errorResponseCode` requires certain HTTP code.\n"]]