Mipaka na hitilafu

Soma kila ukurasa, heshimu mipaka ya kiwango na upone salama kutokana na hitilafu.

1. Mipaka ya kiwango

   Mipaka inaweza kusanidiwa. GET /v1/operations/capabilities inaripoti requestsPerMinute na authenticationRequestsPerMinutePerIp. Baada ya 429, heshimu Jaribu-Baada ya Upya na usubiri kwa muda mrefu zaidi ikiwa kukandamiza kutaendelea. Kundi linasoma kukubali hadi vitambulisho 100; sehemu za mwisho za mtu binafsi zinaweza kuwa na mipaka midogo ya ukurasa au mzigo. (Retry-After)

2. Soma kila ukurasa

   Tumia sheria ya mwendelezo kwa sehemu ya mwisho uliyoita, ukiweka vichujio sawa. Orodha zinaweza kubadilika unapozisoma; tumia picha za haraka unapohitaji nakala thabiti.

   Upaji wa Ukurasa	Endelea na	Simamisha wakati
   Kishale	Pitisha next kama after.	inayofuata ni null.
   Imezimwa na nextOffset	Pitisha nextOffset kama offset.	nextOffset ni null.
   Imebadilishwa na hasMore	Ongeza upunguzaji kwa idadi ya vipengee vilivyorejeshwa.	hasMore si kweli.
   Programu	Fanya thamani ya nambari ya next kama after; anza upya ikiwa updatedAtUtc itabadilika.	inayofuata ni null.
   Mlisho wa matukio	Pitisha next kama after.	hasMore si kweli.

3. Shughulikia hitilafu

   Soma msimbo wa hitilafu pamoja na hali ya HTTP. Ikiwa jibu linajumuisha requestId, nukuu unapowasiliana na usaidizi.

   Hali ya HTTP	Cha kufanya
   400	Rekebisha ombi.
   401	Angalia vitambulisho au pata tokeni mpya ya ufikiaji.
   403	Angalia upeo, ruhusa na kama ufikiaji umewezeshwa.
   404	Huenda rasilimali hiyo ikakosekana au nje ya wigo wako.
   409	Soma msimbo wa hitilafu na hali ya sasa kabla ya kuamua.
   410	Picha au kielekezi cha tukio kimeisha muda. Anza msingi mpya.

4. Ikiwa muda wa kuandika umeisha

   Muda wa kuisha au 503 hauthibitishi kuwa kitendo kimeshindwa. Kwa maandishi kwamba risiti za operesheni ya kurudisha, angalia GET /v1/operations/by-key?idempotencyKey={key} kabla ya kujaribu tena. Kwa uundaji wa matengenezo, tumia tena Idempotency-Key na mwili wa asili.