Citiți fiecare pagină, respectați limitele de rată și recuperați în siguranță după erori.
Limite de rată
Limitele sunt configurabile. GET /v1/operations/capabilities raportează requestsPerMinute și authenticationRequestsPerMinutePerIp. După o eroare 429, respectați Retry-After și așteptați mai mult dacă limitarea continuă. Citirile în lot acceptă până la 100 de ID-uri; punctele finale individuale pot avea limite de pagină sau de sarcină utilă mai mici.
Citiți fiecare pagină
Utilizați regula de continuare pentru endpoint-ul apelat, păstrând aceleași filtre. Listele se pot schimba în timp ce le citiți; utilizați instantanee atunci când aveți nevoie de o copie consistentă.
Paginare Continuare cu Oprire când Cursor Transmiteți next ca after. următorul este null. Decalaj cu nextOffset Transmiteți nextOffset ca offset. nextOffset este null. Offset cu hasMore Crește offset-ul cu numărul de articole returnate. hasMore este fals. Software Transmite valoarea numerică next ca after; repornește dacă updatedAtUtc se modifică. următorul este null. Flux de evenimente Transmiteți next ca after. hasMore este fals. Gestionează erorile
Citește codul de eroare, precum și starea HTTP. Dacă răspunsul include requestId, citați-l atunci când contactați asistența.
Starea HTTP Ce trebuie făcut 400 Remediați solicitarea. 401 Verificați acreditările sau obțineți un nou token de acces. 403 Verificați domeniul de aplicare, permisiunile și dacă accesul este activat. 404 Resursa poate lipsi sau este în afara domeniului de aplicare. 409 Citiți codul de eroare și starea curentă înainte de a decide. 410 Instantaneul sau cursorul evenimentului a expirat. Porniți o nouă linie de bază. Dacă o scriere expiră
O expirare sau un 503 nu dovedește că acțiunea a eșuat. Pentru scrierile care returnează confirmări de operațiune, căutați GET /v1/operations/by-key?idempotencyKey={key} înainte de a reîncerca. Pentru crearea de întreținere, reutilizați Idempotency-Key și corpul original.