Korlátok és hibák

Olvasson el minden oldalt, tartsa be a sebességkorlátokat, és biztonságosan álljon helyre a hibákból.

1. Sebességkorlátok

   A korlátok konfigurálhatók. A GET A /v1/operations/capabilities a requestsPerMinute és a authenticationRequestsPerMinutePerIp jelentését jelenti. 429 után a Retry-After értéket betartja, és hosszabb várakozást vár, ha a szabályozás folytatódik. A kötegelt olvasások akár 100 azonosítót is elfogadnak; az egyes végpontok kisebb oldal- vagy hasznos adatkorlátokkal rendelkezhetnek.

2. Olvass el minden oldalt

   Használja a meghívott végpont folytatási szabályát, megtartva ugyanazokat a szűrőket. A listák olvasás közben változhatnak; használjon pillanatképeket, ha konzisztens másolatra van szüksége.

   Oldalszámozás	Folytatás ezzel:	Leállítás, amikor:
   Kurzor	Adja át a next-t after-ként.	A következő a null.
   Eltolás nextOffset-vel	Adja át a nextOffset-t offset-ként.	A nextOffset értéke null.
   Eltolás hasMore-vel	Növelje az eltolást a visszaküldött elemek számával.	A hasMore értéke hamis.
   Szoftver	Adja át a numerikus next értéket after-ként; indítsa újra, ha a updatedAtUtc megváltozik.	A következő a null.
   Eseményhírcsatorna	Adja át a next-t after-ként.	A hasMore értéke hamis.

3. Hibák kezelése

   Olvassa el a hibakódot és a HTTP állapotot. Ha a válasz tartalmazza a requestId-t, idézze azt, amikor kapcsolatba lép az ügyfélszolgálattal.

   HTTP állapot	Teendők
   400	Javítsa ki a kérést.
   401	Ellenőrizze a hitelesítő adatokat, vagy szerezzen be új hozzáférési tokent.
   403	Ellenőrizze a hatókört, az engedélyeket és azt, hogy a hozzáférés engedélyezve van-e.
   404	Lehet, hogy az erőforrás hiányzik, vagy kívül esik a hatókörén.
   409	Olvassa el a hibakódot és az aktuális állapotot, mielőtt döntene.
   410	A pillanatkép vagy az eseménykurzor lejárt. Kezdjen új alapvonalat.

4. Ha egy írás időtúllépést okoz

   Az időtúllépés vagy az 503-as hiba nem bizonyítja, hogy a művelet sikertelen volt. Az olyan írások esetében, amelyek műveleti bizonylatokat adnak vissza, keresse meg a GET /v1/operations/by-key?idempotencyKey={key} fájlt, mielőtt újra próbálkozna. Karbantartás létrehozásához használja fel újra az eredeti Idempotency-Key fájlt és a törzset.