Naar de inhoud

Rate limits

Elke aanroep telt mee voor een limiet, per klant over al je API-sleutels samen, per kalenderminuut. Dit zijn de limieten die nu gelden.

GET /account, GET /checkers, GET /orders, GET /orders/{id}
60 per minuut
GET /orders/{id}/results
30 per minuut
POST /uploads
10 per minuut
POST /estimates
10 per minuut
Nieuwe bestellingen met POST /orders
10 per minuut
Onvoltooide taakdelen tegelijk, vanuit de API
20 tegelijk
Verzoeken met een onjuiste API-sleutel, per IP-adres
20 per minuut

Wat een antwoord je kan vertellen

Deze kunnen ontbreken, bijvoorbeeld bij een herhaalde bestelling, dus reken er niet op.

  • RateLimit-Limit: de limiet voor dit soort aanroep.
  • RateLimit-Remaining: hoeveel er deze minuut nog over zijn.
  • RateLimit-Reset: de seconden tot de telling opnieuw begint.

Als je erboven komt

Je krijgt 429 rate_limited met Retry-After, het aantal seconden dat je moet wachten. Dit verzoek heeft niets gedaan en niets afgeschreven. Wacht zo lang en stuur het opnieuw, met dezelfde Idempotency-Key als het een bestelling is.

Nieuwe pogingen

Het herhalen van een bestelling die al is geplaatst, of van een bestelling die deze limieten is gepasseerd en haar antwoord is kwijtgeraakt, telt niet mee voor de bestellimiet, dus een veilige nieuwe poging wordt niet geweigerd omdat het een nieuwe poging is. Alle verzoeken om een bestelling te plaatsen zijn bovendien beperkt tot zes keer de bestellimiet, en tot minstens 60 per minuut.

Openstaande bestellingen

Een grote bestelling bestaat uit meerdere taakdelen, één per 1.000.000 items. Boven de limiet voor openstaande delen krijg je 429 too_many_open_orders: wacht tot er een aantal klaar is. Eén grote bestelling kan over de limiet gaan als je verder niets open hebt staan.

Meer nodig?

Neem contact met ons op en vertel wat je aan het bouwen bent.

Op deze pagina