Gå til innhold
ShopentlyLearn

Forespørselsgrenser

Sett integrasjonsarbeid i kø, og tilpass det til grensene som håndheves for butikken.

Forespørselsgrenser

Engine ≥ 4.143.0. Hvert tokensvar inneholder data.rate_limits fra butikkens gjeldende policy ved utstedelsen. Alle nøkler deler disse budsjettene; et nytt token nullstiller dem ikke. En abonnementsendring kan gjelde før tokenet utløper.

read_per_minute
Leseforespørsler per minutt.
write_per_minute
Skriveforespørsler per minutt; verdien gir ikke skrivetilgang.
auth_per_minute
Tokenforespørsler per minutt, inkludert mislykkede autentiseringsforsøk.

Fordel forespørsler jevnt; ved en positiv lesegrense, vent minst 60 / read_per_minute sekunder mellom lesinger. Grensen garanterer ikke så mange samtidige forespørsler. Andre integrasjoner deler den: håndter 429 og Retry-After.

Null betyr utilgjengelig, ikke ubegrenset.

Grenser per minutt

Grenser per minutt
Tilgjengelig fraLesing · GET
BASIC60
STANDARD120
PROFESSIONAL300
ADVANCED900
Skriving
10
Autentisering
10

Alle nøkler til samme butikk deler disse grensene.

Forespørsel

  • Lese- og skrivetrafikk er underlagt butikkens gjeldende API-policy.
  • Nøkler gir ikke hver for seg ubegrenset kapasitet.
  • Begrens samtidige forespørsler, mellomlagre referansedata der det er hensiktsmessig, og unngå gjentatt henting av uendrede detaljoppføringer.

429 · Retry-After

  • Når API-et returnerer 429 med rate_limit.exceeded, må du vente minst antallet sekunder oppgitt i Retry-After og legge til tilfeldig ventetid før neste forsøk.
  • 429 · capacity.queue_full — Den korte API-køen er full; forespørselen har ikke begynt å kjøre. 429 · capacity.wait_timeout — Ventetiden i API-køen er utløpt; forespørselen har ikke begynt å kjøre. Vent minst Retry-After sekunder, og legg til tilfeldig ventetid. Behold opprinnelig nøkkel og innhold når du prøver en skriveoperasjon på nytt.
  • Bruk dokumentert feilkode og header i stedet for å gjette et fast intervall.