จัดการข้อผิดพลาดและการลองใหม่ของ API
วินิจฉัยข้อผิดพลาดการตรวจสอบสิทธิ์ ขอบเขต การเข้าถึงโมเดล และความพร้อมใช้งานของ ShareAI โดยไม่เขียนซ้ำซ้อนหรือรีเฟรชซ้ำที่ไม่ปลอดภัย.
ในหน้านี้
ตรวจสอบสถานะ HTTP เสมอก่อนอ่านการตอบกลับว่าเป็นความสำเร็จ บริการ ShareAI อาจส่งกลับซองข้อผิดพลาดที่แตกต่างกัน: การอนุมานอาจให้ error.code, OAuth ให้ error และ error_description, และเส้นทาง Console อาจส่งกลับ code, message และ data.status.
| สถานะ | ความหมายทั่วไป | การกู้คืน |
|---|---|---|
| 200 พร้อมวัตถุข้อผิดพลาด | ไม่มีความพร้อมใช้งานของอุปกรณ์ในจุดสิ้นสุดการแชทปัจจุบัน. | ตรวจสอบ error.code และอย่าแสดงผลเป็นคำตอบของผู้ช่วย. |
| 400 | คำขอไม่ถูกต้องหรือการให้สิทธิ์ OAuth. | แก้ไขเนื้อหา พารามิเตอร์ คอลแบ็ค หรือโค้ดที่หมดอายุ/ถูกใช้ไปแล้ว. |
| 401 | การยืนยันตัวตนที่หายไป หมดอายุ หรือไม่ถูกต้อง. | ตรวจสอบข้อมูลรับรอง; รีเฟรชเฉพาะ OAuth grant ที่ยังใช้งานได้. |
| 402 | เครดิตหรือยอดคงเหลือที่ไม่เพียงพอ. | ตรวจสอบยอดคงเหลือของบัญชีที่เลือกก่อนลองใหม่. |
| 403 | การปฏิเสธสิทธิ์ ขอบเขต ความเป็นเจ้าของ บทบาท หรือสถานะที่เปิดใช้งาน. | ตรวจสอบขอบเขตการอนุญาตที่มีการบันทึกไว้. |
| 404 | ทรัพยากรที่ไม่รู้จักหรือเส้นทางเกตเวย์ที่ไม่รองรับ. | ตรวจสอบโฮสต์ เส้นทาง และตัวระบุทรัพยากร. |
| 409 | ความขัดแย้งของสถานะหรือการแก้ไข. | อ่านสถานะปัจจุบันและพิจารณาการเปลี่ยนแปลงใหม่. |
| 429 | ขีดจำกัดคำขอหรือการประมวลผลพร้อมกัน. | เคารพ Retry-After และใช้การถอยกลับแบบมีขอบเขต. |
| 500 / 502 / 503 | ความล้มเหลวของเซิร์ฟเวอร์หรือการเข้าถึงต้นทาง. | จำกัดการลองใหม่; รักษาตัวระบุการวินิจฉัย. |
อ่านซ้ำพร้อมขีดจำกัด#
สำหรับความล้มเหลวชั่วคราวในการอ่าน ให้รอด้วยการเพิ่มความล่าช้าและการสุ่ม เคารพ Retry-After เมื่อมี และหยุดหลังจากความพยายามหรือเวลาที่กำหนด แสดงข้อมูลให้ผู้ใช้ทราบเมื่อข้อมูลไม่พร้อมใช้งานแทนการวนซ้ำโดยไม่มีการแจ้งเตือน.
เขียนอย่างระมัดระวัง#
อย่าทำการอัปเดตราคา สร้างโมเดล หรือคำสั่งการแชร์ซ้ำโดยอัตโนมัติเมื่อผลลัพธ์ไม่แน่นอน อ่านสถานะทรัพยากรหรือคำสั่งก่อน ใช้ Idempotency-Key เฉพาะในจุดเชื่อมต่อที่มีการบันทึกการรองรับ เช่น การเปลี่ยนแปลงข้อตกลง.
โทเค็นรีเฟรชใช้ได้ครั้งเดียว#
การรีเฟรชแบบหมุนต้องการการล็อกต่อการอนุญาตในระบบหลังบ้านของคุณ การลองรีเฟรชโทเค็นที่ถูกใช้ไปแล้วโดยไม่ตรวจสอบอาจทำให้ grant ถูกเพิกถอน ดู การรีเฟรชโทเค็นอย่างปลอดภัย.
สิ่งที่ควรรวมในคำขอสนับสนุน#
รวมจุดเชื่อมต่อ สถานะ HTTP รหัสข้อผิดพลาด เวลา และตัวระบุการตอบกลับ/งานเมื่อมี ลบส่วนหัว Authorization คุกกี้ ข้อมูลลับของไคลเอนต์ โทเค็นการเข้าถึง โทเค็นการรีเฟรช และเนื้อหาคำสั่งส่วนตัว.
อัปเดตล่าสุด กันยายน 15, 2026