Utviklere

Rategrenser

Hvor mange forespørsler et medlem kan sende, headerne som teller dem, og hva du gjør ved grensen.

Oversikt

Hvert medlem av et arbeidsområde kan sende 2 500 forespørsler i timen, talt på tvers av alle nøklene til medlemmet, og ikke flere enn 10 i ett sekund.

Rategrense-headere

Et 200-svar har tre headere, og det har også et 403-svar med ip-not-allowed. Ingen andre feil har dem.

HeaderBetydning
X-RateLimit-Requests-LimitTillatte forespørsler per time
X-RateLimit-Requests-RemainingForespørsler som er igjen i inneværende time
X-RateLimit-Requests-ResetNår timen er over, i UTC-epoke-millisekunder
curl -s -o /dev/null -D - https://attia.app/api/v1/jobs \  -H "Authorization: Bearer $ATTIA_API_KEY" | grep -i x-ratelimit
x-ratelimit-requests-limit: 2500x-ratelimit-requests-remaining: 2487x-ratelimit-requests-reset: 1791637200000

Over grensen

Over grensen svarer API-et 429 med koden rate-limited og en Retry-After-header i sekunder. Vent så lenge før neste forespørsel.

HTTP/2 429content-type: application/problem+jsonretry-after: 37

Hold deg under grensen

Bla med så stor limit som du kan bruke, opptil 100, og hent endringer med updated_since i stedet for å lese alle elementene på nytt. Paginering viser begge deler.