โค้ดตอบกลับสถานะ

ระบบอาจแสดงรหัสสถานะต่อไปนี้ในการตอบกลับ HTTP

รหัส HTTP คำอธิบาย HTTP หมายเหตุ
2xx ตกลง ไม่ใช่ข้อผิดพลาด แสดงผลเมื่อดำเนินการสำเร็จ นอกจากนี้ คุณควรใช้รหัสนี้ในกรณีที่ตรรกะทางธุรกิจไม่สําเร็จ (เช่น booking_failure ใน CreateBookingResponse ได้รับการป้อนข้อมูล)
400 คำขอไม่ถูกต้อง Bad Request/Invalid Arguments (merchant, service, slot not found, trying to book an invalid slot, cancelling a booking that never existed)
401 ไม่ได้รับอนุมัติ ไม่ได้รับการตรวจสอบสิทธิ์ (ข้อมูลเข้าสู่ระบบไม่ถูกต้อง ให้ลองลงชื่อเข้าใช้อีกครั้ง) คำขอไม่มีข้อมูลเข้าสู่ระบบการตรวจสอบสิทธิ์ที่ถูกต้องสำหรับการดำเนินการ
403 ต้องห้าม สิทธิ์ถูกปฏิเสธ/ไม่ได้รับอนุญาต (รู้จักผู้โทรและปฏิเสธ) ไม่ควรใช้การตอบกลับนี้สำหรับการปฏิเสธที่เกิดจากทรัพยากรบางอย่างหมด (ใช้ Too Many Requests แทนสำหรับข้อผิดพลาดเหล่านั้น) ห้ามใช้ Forbidden หากไม่สามารถระบุตัวผู้ที่โทรเข้ามาได้ (ใช้ Unauthorized แทนสำหรับข้อผิดพลาดเหล่านั้น)
404 ไม่พบ ไม่พบ (ไม่พบทรัพยากร, URL ไม่ถูกต้อง รวมถึง RPC ที่ไม่ถูกต้อง)
409 ปมปัญหา ระบบยกเลิกการดำเนินการ ซึ่งมักเกิดจากปัญหาการทำงานพร้อมกัน เช่น การตรวจสอบตัวจัดลำดับไม่สำเร็จหรือการยกเลิกธุรกรรม
429 มีคำขอมากเกินไป ทรัพยากรบางอย่างหมดแล้ว เช่น อาจใช้โควต้าต่อผู้ใช้ครบแล้ว หรือระบบไฟล์ทั้งระบบไม่มีพื้นที่ว่าง
499 คำขอที่ลูกค้าปิดแล้ว การดำเนินการถูกยกเลิก โดยปกติแล้วผู้โทรจะเป็นผู้ยกเลิก
500 ข้อผิดพลาดภายในเซิร์ฟเวอร์ ข้อผิดพลาดภายใน ซึ่งหมายความว่าอินตัวแปรบางรายการที่ระบบพื้นฐานคาดไว้ใช้งานไม่ได้ รหัสข้อผิดพลาดนี้สงวนไว้สำหรับข้อผิดพลาดร้ายแรง
501 ไม่ได้ใช้งาน การดำเนินการนี้ยังไม่เสร็จสิ้นหรือไม่รองรับ/เปิดใช้ในบริการนี้
503 ไม่สามารถให้บริการได้ ไม่พร้อมให้บริการนี้ในขณะนี้ ปัญหานี้อาจเกิดจากเงื่อนไขชั่วคราว ซึ่งแก้ไขได้ด้วยการลองอีกครั้งโดยลดจำนวน
504 เกตเวย์หมดเวลา กำหนดเวลาหมดอายุก่อนที่การดำเนินการจะเสร็จสมบูรณ์ สําหรับการดําเนินการที่เปลี่ยนสถานะของระบบ ระบบอาจแสดงข้อผิดพลาดนี้แม้ว่าการดําเนินการจะเสร็จสมบูรณ์แล้วก็ตาม ตัวอย่างเช่น การตอบกลับที่สำเร็จจากเซิร์ฟเวอร์อาจล่าช้านานพอที่จะทำให้พ้นกำหนดเวลา

บางครั้งอาจมีรหัสข้อผิดพลาดหลายรหัส บริการควรแสดงรหัสข้อผิดพลาดที่เฉพาะเจาะจงที่สุดซึ่งเกี่ยวข้อง