Ugrás a fő tartalomhoz
A GetQR API béta állapotban van, és csak kiválasztott munkaterületek számára érhető el. A részletek az általános kiadásig változhatnak.
A GetQR API korlátozza, hány kérést küldhet egy-egy API-kulcs, hogy egyetlen integráció se lassítsa le az API-t mindenki más számára.

Korlátok

A korlát egy csúszó, egyperces időablakra vonatkozik, és az összes végpontra együttesen érvényes. Az állapotellenőrzéshez nem kell kulcs, és nem számít bele a korlátba.

Kéréskorlát-fejlécek

Az érvényes API-kulccsal küldött kérésekre adott válaszok – a hibaválaszokat is beleértve – ezeket a fejléceket tartalmazzák:

Ha túllépi a korlátot

A korlát túllépésekor az API 429 kóddal, rate_limit_exceeded hibakóddal és ugyanezekkel a fejlécekkel válaszol:
További kérések előtt várja meg az újraindulás időpontját. Adjon hozzá véletlenszerű késleltetést (jitter), hogy több feldolgozó ne egyszerre próbálkozzon újra, és 5xx hibáknál alkalmazzon exponenciális visszalépést:
A POST /api/v1/qrs kérést csak Idempotency-Key fejléccel ismételje meg. Így egy újrapróbálkozás soha nem hoz létre második QR-kódot. Lásd: Idempotencia.

Maradjon a korláton belül

  • Figyelje az X-RateLimit-Remaining értékét, és lassítson, mielőtt eléri a 0-t.
  • QR-kódonkénti külön kérések helyett használja a tömeges QR-létrehozást.
  • Oldalanként legfeljebb 100 találatot kérjen le a pageSize=100 paraméterrel. Lásd: Lapozás.
  • Gyorsítótárazza a QR-képeket: a letöltések ETag értéket adnak vissza, így If-None-Match fejlécet küldhet, és 304 Not Modified választ kap, ha semmi sem változott.

Következő lépések

Hibák

QR-kódok