Baca setiap halaman, hormati had kadar dan pulihkan dengan selamat daripada ralat.
Had kadar
Had boleh dikonfigurasikan. GET /v1/operations/capabilities melaporkan requestsPerMinute dan authenticationRequestsPerMinutePerIp. Selepas 429, hormati Cuba Semula-Selepas dan tunggu lebih lama jika pendikit berterusan. Bacaan kelompok menerima sehingga 100 ID; titik akhir individu mungkin mempunyai had halaman atau muatan yang lebih kecil. (Retry-After)
Baca setiap muka surat
Gunakan peraturan penerusan untuk titik akhir yang anda panggil, dengan mengekalkan penapis yang sama. Senarai boleh berubah semasa anda membacanya; gunakan snapshot apabila anda memerlukan salinan yang konsisten.
Penomboran Halaman Teruskan dengan Henti apabila Kursor Hantar next sebagai after. seterusnya ialah null. Diimbangi dengan nextOffset Hantar nextOffset sebagai offset. nextOffset ialah null. Diimbangi dengan hasMore Tingkatkan imbang dengan bilangan item yang dikembalikan. hasMore adalah palsu. Perisian Hantarkan nilai next berangka sebagai after; mulakan semula jika updatedAtUtc berubah. seterusnya ialah null. Suapan peristiwa Hantar next sebagai after. hasMore adalah palsu. Kendalikan ralat
Baca kod ralat serta status HTTP. Jika respons tersebut merangkumi requestId, sebutkannya semasa menghubungi sokongan.
Status HTTP Apa yang perlu dilakukan 400 Betulkan permintaan. 401 Semak kelayakan atau dapatkan token akses baharu. 403 Semak skop, kebenaran dan sama ada akses diaktifkan. 404 Sumber mungkin hilang atau di luar skop anda. 409 Baca kod ralat dan keadaan semasa sebelum membuat keputusan. 410 Kursi snapshot atau peristiwa telah tamat tempoh. Mulakan garis dasar baharu. Jika masa penulisan tamat
Tamat masa atau 503 tidak membuktikan tindakan tersebut gagal. Untuk penulisan yang mengembalikan resit operasi, cari GET /v1/operations/by-key?idempotencyKey={key} sebelum mencuba semula. Untuk penciptaan penyelenggaraan, gunakan semula Idempotency-Key dan badan asal.