Hoppa till innehållet
ShopentlyLearn

Anropsgränser

Lägg integrationsarbetet i kö och följ de gränser som gäller för butiken.

Anropsgränser

Engine ≥ 4.143.0. Varje tokensvar innehåller data.rate_limits från butikens policy vid utfärdandet. Alla nycklar delar dessa budgetar; en ny token återställer dem inte. En planändring kan gälla innan token löper ut.

read_per_minute
Läsanrop per minut.
write_per_minute
Skrivanrop per minut; värdet ger inte skrivbehörighet.
auth_per_minute
Tokenanrop per minut, inklusive misslyckade autentiseringsförsök.

Fördela anrop jämnt över tiden; vid en positiv läsgräns, vänta minst 60 / read_per_minute sekunder mellan läsanrop. Gränsen garanterar inte så många samtidiga anrop. Andra integrationer delar den: hantera 429 och Retry-After.

Noll betyder otillgängligt, inte obegränsat.

Gränser per minut

Gränser per minut
Tillgänglig frånLäsning · GET
BASIC60
STANDARD120
PROFESSIONAL300
ADVANCED900
Skrivning
10
Autentisering
10

Alla nycklar för samma butik delar på dessa gränser.

Begäran

  • Läsningar och skrivningar omfattas av butikens aktuella API-policy.
  • Flera nycklar ger inte var sin obegränsad kapacitet.
  • Begränsa samtidigheten, cachelagra referensdata när det passar och undvik att hämta oförändrade detaljposter upprepade gånger.

429 · Retry-After

  • När API:et returnerar 429 med rate_limit.exceeded ska du vänta minst det antal sekunder som Retry-After anger och lägga till en slumpmässig fördröjning innan nästa försök.
  • 429 · capacity.queue_full — API:ets korta kö är full; begäran har inte börjat köras. 429 · capacity.wait_timeout — Väntetiden i API-kön har gått ut; begäran har inte börjat köras. Vänta minst Retry-After sekunder och lägg till slumpmässig fördröjning. Behåll ursprunglig nyckel och oförändrat innehåll vid nya skrivförsök.
  • Följ den dokumenterade felkoden och HTTP-huvudet i stället för att gissa ett fast intervall.