Baca setiap halaman, patuhi batasan laju, dan pulihkan dengan aman dari kesalahan.
Batasan laju
Batasan dapat dikonfigurasi. GET /v1/operations/capabilities melaporkan requestsPerMinute dan authenticationRequestsPerMinutePerIp. Setelah kode kesalahan 429, patuhi Retry-After dan tunggu lebih lama jika pembatasan terus berlanjut. Pembacaan batch menerima hingga 100 ID; titik akhir individual mungkin memiliki batasan halaman atau muatan yang lebih kecil.
Baca setiap halaman
Gunakan aturan kelanjutan untuk titik akhir yang Anda panggil, dengan tetap menggunakan filter yang sama. Daftar dapat berubah saat Anda membacanya; gunakan snapshot saat Anda membutuhkan salinan yang konsisten.
Penomoran halaman Lanjutkan dengan Berhenti saat Kursor Lewatkan next sebagai after. Berikutnya adalah null. Offset dengan nextOffset Lewatkan nextOffset sebagai offset. nextOffset adalah null. Offset dengan hasMore Tingkatkan offset sebanyak jumlah item yang dikembalikan. hasMore bernilai false. Perangkat Lunak Teruskan nilai numerik next sebagai after; mulai ulang jika updatedAtUtc berubah. Berikutnya adalah null. Umpan Peristiwa Lewatkan next sebagai after. hasMore bernilai false. Tangani kesalahan
Baca kode kesalahan serta status HTTP. Jika respons menyertakan requestId, sebutkan saat menghubungi dukungan.
Status HTTP Apa yang harus dilakukan 400 Perbaiki permintaan. 401 Periksa kredensial atau dapatkan token akses baru. 403 Periksa cakupan, izin, dan apakah akses diaktifkan. 404 Sumber daya mungkin hilang atau di luar cakupan Anda. 409 Baca kode kesalahan dan status saat ini sebelum mengambil keputusan. 410 Snapshot atau kursor peristiwa telah kedaluwarsa. Mulai baseline baru. Jika penulisan mengalami timeout
Timeout atau 503 tidak membuktikan tindakan gagal. Untuk penulisan yang mengembalikan tanda terima operasi, cari GET /v1/operations/by-key?idempotencyKey={key} sebelum mencoba lagi. Untuk pembuatan pemeliharaan, gunakan kembali Idempotency-Key dan isi asli.