Iyaka da kurakurai

Karanta kowane shafi, girmama iyakokin farashi kuma murmurewa lafiya daga kurakurai.

1. Iyaka farashin

   Ana iya daidaita iyakoki. GET /v1/operations/capabilities yana ba da rahoton requestsPerMinute da authenticationRequestsPerMinutePerIp. Bayan 429, girmama Sake Gwadawa kuma jira na dogon lokaci idan throttling ya ci gaba. Karatun rukuni yana karɓar har zuwa ID 100; maki na ƙarshe na iya samun ƙananan iyaka na shafi ko nauyin biya. (Retry-After)

2. Karanta kowane shafi

   Yi amfani da ƙa'idar ci gaba don ƙarshen da kuka kira, kuna ajiye matattara iri ɗaya. Jerin abubuwa na iya canzawa yayin da kuke karanta su; yi amfani da hotuna lokacin da kuke buƙatar kwafin da ya dace.

   Shafin Yanar Gizo	Ci gaba da	Tsaya lokacin da
   Mai auna siginar	Tsaya next azaman after.	na gaba shine null.
   An ​​kashe tare da nextOffset	Tsaya nextOffset azaman offset.	nextOffset shine null.
   An ​​gyara kuskuren da hasMore	An ​​ƙara rage darajar da adadin abubuwan da aka dawo dasu.	hasMore ƙarya ne.
   Software	An ​​cire ƙimar next mai lamba kamar after; sake farawa idan updatedAtUtc ya canza.	na gaba shine null.
   Ciyarwar taron	Tsaya next azaman after.	hasMore ƙarya ne.

3. An ​​gyara kurakurai

   Karanta lambar kuskuren da kuma matsayin HTTP. Idan amsar ta ƙunshi requestId, a faɗi lokacin da kake tuntuɓar tallafi.

   Matsayin HTTP	Abin da za a yi
   400	Gyara buƙatar.
   401	Duba takardun shaidarka ko sami sabuwar alamar shiga.
   403	Duba iyakan wurin, izini da ko an kunna damar shiga.
   404	Alamar na iya ɓacewa ko kuma ta fita daga ikonka.
   409	Karanta lambar kuskuren da yanayin yanzu kafin yanke shawara.
   410	Hotunan hoto ko maɓallan taron sun ƙare. Fara sabon tushe.

4. Idan lokacin rubutu ya ƙare

   Lokaci ko 503 ba ya tabbatar da cewa aikin ya gaza. Don rubutawa cewa rasitin aikin dawowa, duba GET /v1/operations/by-key?idempotencyKey={key} kafin sake gwadawa. Don ƙirƙirar gyara, sake amfani da ainihin Idempotency-Key da jiki.