Gå til indhold
ShopentlyLearn

Forespørgselsgrænser

Sæt integrationsarbejde i kø, og tilpas det til butikkens håndhævede grænser.

Forespørgselsgrænser

Engine ≥ 4.143.0. Hvert tokensvar indeholder data.rate_limits fra butikkens politik ved udstedelsen. Alle nøgler deler disse budgetter; en ny token nulstiller dem ikke. En abonnementsændring kan gælde, før tokenen udløber.

read_per_minute
Læseanmodninger pr. minut.
write_per_minute
Skriveanmodninger pr. minut; værdien giver ikke skriverettigheder.
auth_per_minute
Tokenanmodninger pr. minut, inklusive mislykkede godkendelsesforsøg.

Fordel anmodninger jævnt; ved en positiv læsegrænse skal der gå mindst 60 / read_per_minute sekunder mellem læsninger. Grænsen garanterer ikke så mange samtidige anmodninger. Andre integrationer deler den: håndtér 429 og Retry-After.

Nul betyder utilgængelig, ikke ubegrænset.

Grænser pr. minut

Grænser pr. minut
Tilgængelig fraLæsning · GET
BASIC60
STANDARD120
PROFESSIONAL300
ADVANCED900
Skrivning
10
Godkendelse
10

Alle nøgler til samme butik deler disse grænser.

Anmodning

  • Læse- og skrivetrafik er underlagt butikkens aktuelle API-politik.
  • Nøgler giver ikke hver især ubegrænset kapacitet.
  • Begræns samtidige forespørgsler, brug cache til referencedata, hvor det er relevant, og undgå gentagen hentning af uændrede detaljer.

429 · Retry-After

  • Når API'et returnerer 429 med rate_limit.exceeded, skal du vente mindst det antal sekunder, som Retry-After angiver, og tilføje en tilfældig ventetid før næste forsøg.
  • 429 · capacity.queue_full — Den korte API-kø er fuld; anmodningen er ikke begyndt at blive udført. 429 · capacity.wait_timeout — Ventetiden i API-køen er udløbet; anmodningen er ikke begyndt at blive udført. Vent mindst Retry-After sekunder, og tilføj tilfældig ventetid. Bevar oprindelig nøgle og indhold ved genforsøg på en skriveoperation.
  • Brug den dokumenterede fejlkode og header frem for at gætte på et fast interval.