รหัสสถานะต่อไปนี้จะแสดงผลในการตอบสนองของ HTTP ได้
รหัส HTTP | คำอธิบาย HTTP | หมายเหตุ |
---|---|---|
2xx | ตกลง | ไม่ใช่ข้อผิดพลาด แต่ส่งคืนสำเร็จ ควรใช้เงื่อนไขนี้หากเกิดความล้มเหลวในตรรกะทางธุรกิจ (เช่น มีการป้อนข้อมูล booking_failure ใน CreateBookingResponse ) |
400 | คำขอไม่ถูกต้อง | อาร์กิวเมนต์คำขอไม่ถูกต้อง/อาร์กิวเมนต์ไม่ถูกต้อง (ผู้ขาย บริการ ช่องไม่พบ พยายามจองช่วงที่ไม่ถูกต้อง, ยกเลิกการจองที่ไม่เคย มีอยู่) |
401 | ไม่ได้รับอนุญาต | ยังไม่ตรวจสอบสิทธิ์ (ข้อมูลเข้าสู่ระบบไม่ถูกต้อง ลองเข้าสู่ระบบอีกครั้ง) คำขอไม่มีข้อมูลเข้าสู่ระบบการตรวจสอบสิทธิ์ที่ถูกต้องสำหรับการดำเนินการ |
403 | ห้ามใช้ | สิทธิ์ถูกปฏิเสธ/ไม่ได้รับอนุญาต (รู้จักผู้โทรและปฏิเสธ) ต้องไม่ใช้การตอบกลับนี้สำหรับการปฏิเสธที่เกิดจากการใช้ทรัพยากรบางส่วนมากเกินไป (ใช้ Too Many Requests แทนสำหรับข้อผิดพลาดเหล่านั้น)
ระบบจะไม่ใช้ Forbidden หากระบุตัวผู้โทรไม่ได้ (ใช้ Unauthorized แทนสำหรับข้อผิดพลาดเหล่านั้น) |
404 | ไม่พบ | ไม่พบ (ไม่พบทรัพยากร, URL ไม่ถูกต้อง รวมถึง RPC ที่ไม่ถูกต้อง) |
409 | ปมปัญหา | การดำเนินการถูกล้มเลิก ซึ่งโดยปกติจะเกิดจากปัญหาการเกิดขึ้นพร้อมกัน เช่น ความล้มเหลวในการตรวจสอบตัวลำดับหรือล้มเลิกธุรกรรม |
429 | มีคำขอมากเกินไป | ทรัพยากรบางส่วนหมดไป อาจมีโควต้าต่อผู้ใช้หรือพื้นที่เก็บข้อมูลทั้งระบบไฟล์เต็มแล้ว |
499 | คำขอ "ไคลเอ็นต์ปิดแล้ว" | โดยปกติผู้โทรจะยกเลิกการดำเนินการ |
500 | เซิร์ฟเวอร์เกิดข้อผิดพลาดภายใน | ข้อผิดพลาดภายใน ซึ่งหมายความว่าค่าตัวแปรบางรายการที่คาดไว้จากระบบเบื้องหลังเกิดขัดข้อง รหัสข้อผิดพลาดนี้สงวนไว้สำหรับข้อผิดพลาดที่ร้ายแรง |
501 | ไม่ได้ใช้ | การดำเนินการยังใช้ไม่ได้หรือไม่รองรับ/เปิดใช้ในบริการนี้ |
503 | ไม่สามารถให้บริการได้ | ไม่พร้อมให้บริการนี้ในขณะนี้ เหตุการณ์นี้น่าจะเป็นเงื่อนไขชั่วคราว ซึ่งแก้ไขได้ด้วยการลองอีกครั้งโดยใช้ Backoff |
504 | เกตเวย์หมดเวลา | กําหนดเวลาหมดอายุก่อนที่การดําเนินการจะเสร็จสิ้น สำหรับการดำเนินการที่เปลี่ยนสถานะของระบบ ระบบอาจแสดงผลข้อผิดพลาดนี้แม้ว่าการดำเนินการจะเสร็จสมบูรณ์แล้วก็ตาม เช่น การตอบกลับที่สำเร็จจากเซิร์ฟเวอร์อาจล่าช้านานพอที่กำหนดเวลาจะหมดอายุ |
บางครั้งอาจมีรหัสข้อผิดพลาดหลายรายการ บริการควรแสดงรหัสข้อผิดพลาดที่เจาะจงที่สุดที่เกี่ยวข้อง