รหัสสถานะ HTTP

              
              # รหัสสถานะ HTTP

เอกสารนี้กำหนดมาตรฐานรหัสการตอบกลับ HTTP ของ MTPush REST API

API การส่งข้อความเวอร์ชันใหม่ MTPush v4 สอดคล้องกับมาตรฐานนี้

### การกำหนดรหัสสถานะ

| **รหัส** | คำอธิบาย | คำอธิบายเพิ่มเติม |
| --- | --- | --- |
| 200 | OK | สำเร็จ! |
| 400 | คำขอผิดพลาด | คำขอไม่ถูกต้อง คำอธิบายที่เกี่ยวข้องจะระบุสาเหตุ |
| 401 | ไม่ได้รับการยืนยัน | ไม่มีข้อมูลยืนยันหรือการยืนยันล้มเหลว |
| 403 | ปฏิเสธ | คำขอได้รับการเข้าใจแต่ไม่ได้รับการยอมรับ คำอธิบายที่เกี่ยวข้องจะระบุสาเหตุ |
| 404 | ไม่พบ | ทรัพยากรไม่มีอยู่ ผู้ใช้ที่ร้องขอไม่มีอยู่ หรือรูปแบบคำขอไม่รองรับ |
| 405 | วิธีการขอไม่เหมาะสม | อินเทอร์เฟซไม่รองรับวิธีการขอนี้ |
| 410 | ถูกยกเลิก | ทรัพยากรที่ร้องขอถูกยกเลิก กรุณาอ้างอิงประกาศที่เกี่ยวข้อง |
| 429 | คำขอมากเกินไป | คำขอเกินขีดจำกัดความถี่ คำอธิบายที่เกี่ยวข้องจะระบุสาเหตุเฉพาะ |
| 500 | ข้อผิดพลาดภายในเซิร์ฟเวอร์ | เกิดข้อผิดพลาดภายในเซิร์ฟเวอร์ กรุณาติดต่อเราเพื่อแก้ไขปัญหาโดยเร็วที่สุด |
| 502 | พร็อกซีไม่ถูกต้อง | เซิร์ฟเวอร์บริการถูกยกเลิกหรือกำลังอัปเกรด กรุณาลองใหม่ในภายหลัง |
| 503 | ความล้มเหลวของบริการชั่วคราว | เซิร์ฟเวอร์ไม่สามารถตอบสนองคำขอได้ กรุณาลองใหม่ในภายหลัง |
| 504 | พร็อกซีหมดเวลา | เซิร์ฟเวอร์กำลังทำงานแต่ไม่สามารถตอบสนองคำขอได้ กรุณาลองใหม่ในภายหลัง |

### มาตรฐานที่ต้องปฏิบัติตาม

- 200 ต้องถูกต้อง ห้ามใช้รหัส 200 สำหรับข้อยกเว้นทั้งหมด
- สำหรับข้อผิดพลาดทางตรรกะธุรกิจ ให้ใช้รหัสข้อผิดพลาดพิเศษ 4xx หากเป็นไปได้ มิฉะนั้นให้ใช้ 400
- ข้อผิดพลาดภายในเซิร์ฟเวอร์ หากไม่มีรหัสข้อผิดพลาดพิเศษ ให้ใช้ 500
- เมื่อเกิดข้อยกเว้นทางธุรกิจ ให้ใช้รูปแบบ JSON ในการกำหนดข้อมูลข้อผิดพลาด