Siirry pääsisältöön
GetQR API on beetavaiheessa, ja se on käytettävissä valituissa työtiloissa. Yksityiskohdat voivat muuttua ennen yleistä julkaisua.
GetQR API rajoittaa, kuinka monta pyyntöä kukin API-avain voi lähettää, jotta yksi integraatio ei voi hidastaa APIa kaikilta muilta.

Rajat

Raja lasketaan liukuvassa yhden minuutin aikaikkunassa, ja se koskee kaikkia päätepisteitä yhteensä. Tilatarkistus ei tarvitse avainta eikä kuluta rajaa.

Rajoitusotsakkeet

Vastauksissa pyyntöihin, joissa on kelvollinen API-avain, on nämä otsakkeet, myös virhevastauksissa:

Kun raja ylittyy

Kun raja ylittyy, API vastaa 429 koodilla rate_limit_exceeded ja samoilla otsakkeilla:
Odota nollautumishetkeen ennen kuin lähetät lisää pyyntöjä. Lisää satunnaista viivettä, jotta useat työprosessit eivät yritä uudelleen samalla hetkellä, ja kasvata viivettä eksponentiaalisesti 5xx-virheissä:
Yritä POST /api/v1/qrs -pyyntöä uudelleen vain Idempotency-Key-otsakkeen kanssa. Silloin uusi yritys ei koskaan luo toista QR-koodia. Katso Idempotenssi.

Pysy rajan alla

  • Seuraa otsaketta X-RateLimit-Remaining ja hidasta tahtia ennen kuin se saavuttaa nollan.
  • Käytä QR-koodien joukkoluontia yhden QR-koodikohtaisen pyynnön sijaan.
  • Hae enintään 100 tulosta sivua kohti parametrilla pageSize=100. Katso Sivutus.
  • Tallenna QR-kuvat välimuistiin: lataukset palauttavat ETag-otsakkeen, joten voit lähettää If-None-Match-otsakkeen ja saada vastauksen 304 Not Modified, kun mikään ei ole muuttunut.

Mitä seuraavaksi

Virheet

QR-koodit