Rajoitukset ja virheet

Lue jokainen sivu, noudata nopeusrajoituksia ja palauta virheet turvallisesti.

1. Nopeusrajoitukset

   Rajoitukset ovat konfiguroitavissa. GET /v1/operations/capabilities raportoi requestsPerMinute:n ja authenticationRequestsPerMinutePerIp:n. 429-virheen jälkeen noudata uudelleenyritystä ja odota kauemmin, jos rajoitus jatkuu. Eräluennot hyväksyvät jopa 100 tunnusta; yksittäisillä päätepisteillä voi olla pienempiä sivu- tai hyötykuormarajoituksia. (Retry-After)

2. Lue jokainen sivu

   Käytä kutsumallesi päätepisteelle samaa jatkuvuussääntöä ja säilytä samat suodattimet. Listat voivat muuttua niitä luettaessa; käytä tilannevedoksia, kun tarvitset yhtenäisen kopion.

   Sivutus	Jatka:	Pysäytä, kun:
   Kohdistin	Ohita next:n arvona after.	Seuraavaksi tulee null.
   Siirry nextOffset:n arvona	Ohita nextOffset:n arvona offset.	nextOffset on null.
   Offset hasMore:n kanssa	Lisää offsetia palautettujen kohteiden lukumäärällä.	hasMore on epätosi.
   Ohjelmisto	Välitä numeerinen next-arvo muodossa after; käynnistä uudelleen, jos updatedAtUtc muuttuu.	Seuraavaksi tulee null.
   Tapahtumasyöte	Ohita next:n arvona after.	hasMore on epätosi.

3. Virheiden käsittely

   Lue virhekoodi sekä HTTP-tila. Jos vastaus sisältää requestId:n, mainitse se ottaessasi yhteyttä tukeen.

   HTTP-tila	Toimenpiteet
   400	Korjaa pyyntö.
   401	Tarkista tunnistetiedot tai hanki uusi käyttöoikeustunnus.
   403	Tarkista laajuus, käyttöoikeudet ja onko käyttöoikeus käytössä.
   404	Resurssi saattaa puuttua tai olla käyttöalueesi ulkopuolella.
   409	Lue virhekoodi ja nykyinen tila ennen päätöksentekoa.
   410	Pikavedos tai tapahtumakursori vanheni. Aloita uusi perusviiva.

4. Jos kirjoitus aikakatkaistaan

   Aikakatkaisu tai 503 ei todista toiminnon epäonnistumista. Jos kirjoituksessa on kuitteja, jotka palauttavat toimintokuittauksia, etsi GET /v1/operations/by-key?idempotencyKey={key} ennen uudelleenyritystä. Ylläpidon luonnissa käytä alkuperäistä Idempotency-Key-tiedostoa ja sen runkoa uudelleen.