Naar de inhoud gaan

Maximumtarieven

Hoeveel verzoeken elke API-toets kan maken en hoe om te gaan met 429 antwoorden.

Openbare API-status

De v1 API maakt gebruik van company-scoped toonder keys en vereist een actieve planning periode. Ontwerp en betaling rapportage eindpunten niet verzenden klantenberichten. Voorbeelden gebruiken plaatshouders .Plakken nooit een echte sleutel in gedeelde code.

Grenswaarden

Elke API-sleutel kan 60 verzoeken per minuut maken. De limiet wordt geteld per sleutel, zodat aparte sleutels aparte budgetten hebben.

De actieve proefperiode, Basic of Pro periode heeft ook een totale API aanvraag vergoeding. Verzoeken die verbruiken worden geteld per bedrijf en periode. Zonder een actieve periode, beschermde gegevens verzoeken retourneren 403 forbidden; na zijn De vergoeding is uitgeput, ze retourneren 429 rate_limited. GET /v1/usage meldt de huidige vergoeding zonder het te verbruiken. De limiet per sleutel 60/minuut is nog steeds van toepassing.

Wanneer u de limiet bereikt

De API reageert met 429 Too Many Requests, de standaard foutlichaam en een Retry-After header met het aantal seconden om te wachten.

JSON
{
    "error": {
        "code": "rate_limited",
        "message": "Too many requests."
    },
    "request_id": "0c998db5-ab69-49f5-8058-227973e19dbc"
}

Binnen de limiet blijven

  • Wacht op Retry-After alvorens opnieuw te proberen, en voeg jitter toe als meerdere werknemers een sleutel delen.
  • Gebruik per_page tot 100 om meer items per aanvraag te lezen.
  • Geef afzonderlijke systemen aparte sleutels zodat de ene drukke integratie niet vertraagt.