Hastighetsgrenser

Hastighetsgrenser beskytter plattformen mot at én kunde påvirker andre. De er satt romslig for normal bruk, og de kan heves.

Grensene

Grensene gjelder per konto, ikke per nøkkel. Noen endepunkter har egne grenser i tillegg:

• Adresse-autofullfør: 4× plangrensen, fordi hvert tastetrykk er et kall.
• Dokumentnedlasting (/dokument): 10 per sekund uansett plan.
• POST /v1/meldinger/batch: 1 per sekund; batchen i seg selv kan ha 10 000 mottakere.

Grensen bruker en token-bøtte med kapasitet lik ti sekunders trafikk. Du kan sende 500 kall på ett sekund på Vekst, så lenge du ikke gjør det hvert sekund.

Hodene

Alle svar har tre hoder:

RateLimit-Limit: 50
RateLimit-Remaining: 37
RateLimit-Reset: 1

RateLimit-Reset er sekunder til bøtta er full igjen. Når du treffer grensen:

HTTP/2 429 Too Many Requests
Retry-After: 1
RateLimit-Remaining: 0

{ "feil": { "kode": "for_mange_kall", "melding": "Du har nådd 50 kall per sekund. Vent 1 sekund." } }

Kall som avvises med 429 teller ikke mot månedskvoten.

Slik unngår du 429

Bruk gjenforsøk med ventetid. SDK-ene gjør det. Uten SDK: vent Retry-After sekunder pluss litt tilfeldig jitter, og prøv igjen opptil fem ganger.

Bruk masseendepunkter. 500 organisasjonsnumre i ett kall til /v1/virksomheter/masse er bedre enn 500 kall, for både deg og oss.

Begrens samtidighet. En jobb som starter 1 000 goroutines samtidig treffer grensen uansett. Bruk en kø med fast antall arbeidere.

Cache det som ikke endrer seg. Virksomhetsdata endres sjelden. Cache svaret i noen timer, og abonner på virksomhet.endret for å invalidere.

Les RateLimit-Remaining. Klienter som leser hodet kan senke tempoet før de treffer grensen, i stedet for etter.

Kvote per måned

Hastighetsgrensen handler om kall per sekund. Kvoten handler om kall per måned, og er det som bestemmer prisen. På Start avvises kall med 429 kvote_brukt når kvoten er brukt opp. På de andre planene fortsetter kallene, og du betaler per kall over inkludert. Du får e-post ved 80 og 100 prosent av inkludert volum, og du kan sette et tak i dashbordet som stopper alle kall over et beløp.

Trenger du mer?

Grensene kan heves på Skala og Enterprise. Kontakt oss med forventet trafikkmønster (topp, snitt, døgnvariasjon), så finner vi en grense som passer. Varslede trafikktopper, som en kampanje eller en migrering, kan få midlertidig forhøyet grense uten kostnad.