อ่านทุกหน้า เคารพข้อจำกัดอัตรา และกู้คืนจากข้อผิดพลาดอย่างปลอดภัย
ข้อจำกัดอัตรา
สามารถกำหนดค่าข้อจำกัดได้ GET /v1/operations/capabilities รายงาน requestsPerMinute และ authenticationRequestsPerMinutePerIp หลังจาก 429 ให้ปฏิบัติตาม Retry-After และรอให้นานขึ้นหากการจำกัดยังคงดำเนินต่อไป การอ่านแบบกลุ่มยอมรับได้สูงสุด 100 ID; ปลายทางแต่ละรายการอาจมีข้อจำกัดหน้าหรือเพย์โหลดที่น้อยกว่า
อ่านทุกหน้า
ใช้กฎการต่อเนื่องจากปลายทางที่คุณเรียกใช้ โดยคงตัวกรองเดิมไว้ รายการอาจเปลี่ยนแปลงได้ในขณะที่คุณอ่าน ให้ใช้สแนปช็อตเมื่อคุณต้องการสำเนาที่สอดคล้องกัน
การแบ่งหน้า ดำเนินการต่อด้วย หยุดเมื่อ เคอร์เซอร์ ส่งผ่าน next เป็น after ถัดไปคือ null ออฟเซ็ตด้วย nextOffset ส่งผ่าน nextOffset เป็น offset nextOffset คือ null ค่าชดเชยด้วย hasMore เพิ่มค่าชดเชยตามจำนวนรายการที่ส่งคืน hasMore เป็นเท็จ ซอฟต์แวร์ ส่งค่าตัวเลข next เป็น after; เริ่มใหม่หาก updatedAtUtc เปลี่ยนแปลง ถัดไปคือ null ฟีดเหตุการณ์ ส่งผ่าน next เป็น after hasMore เป็นเท็จ จัดการข้อผิดพลาด
อ่านรหัสข้อผิดพลาดและสถานะ HTTP หากการตอบกลับมี requestId ให้ระบุเมื่อติดต่อฝ่ายสนับสนุน
สถานะ HTTP สิ่งที่ต้องทำ 400 แก้ไขคำขอ 401 ตรวจสอบข้อมูลประจำตัวหรือขอโทเค็นการเข้าถึงใหม่ 403 ตรวจสอบขอบเขต สิทธิ์ และว่าการเข้าถึงเปิดใช้งานอยู่หรือไม่ 404 ทรัพยากรอาจหายไปหรืออยู่นอกขอบเขตของคุณ 409 อ่านรหัสข้อผิดพลาดและสถานะปัจจุบันก่อนตัดสินใจ 410 สแนปช็อตหรือเคอร์เซอร์เหตุการณ์หมดอายุแล้ว เริ่มเบสไลน์ใหม่ หากการเขียนหมดเวลา
การหมดเวลาหรือรหัส 503 ไม่ได้หมายความว่าการดำเนินการล้มเหลว สำหรับการเขียนที่ส่งคืนใบเสร็จรับเงิน ให้ค้นหา GET /v1/operations/by-key?idempotencyKey={key} ก่อนลองใหม่ สำหรับการสร้างเพื่อการบำรุงรักษา ให้ใช้ Idempotency-Key และเนื้อหาเดิมซ้ำ