Grenser for kall og bruk

Kall per minutt

Hver nøkkel kan gjøre 600 kall i minuttet. Det samme gjelder en person som er logget inn i dashbordet. Over grensen svarer API-et 429 med koden rate_limited og headeren Retry-After, som sier hvor mange sekunder du skal vente. Svaret har også RateLimit-headere som viser hvor mye som er igjen.

En nøkkel kan ha 5 åpne hendelsesstrømmer samtidig. Den neste får 429 med koden event_streams_per_key_reached.

Bedriftens daglige grenser

Bedriften har grenser for hvor mange SMS-er og samtaleminutter den kan bruke per dag, og hvor mange utgående samtaler som kan pågå samtidig. Grensene beskytter deg mot en feil i koden som sender tusenvis av meldinger. Les grensene og dagens bruk:

curl "https://api.telkit.no/v1/limits" \  -H "Authorization: Bearer $TELKIT_API_KEY"

const response = await fetch("https://api.telkit.no/v1/limits", {  headers: {    Authorization: `Bearer ${process.env.TELKIT_API_KEY}`,  },});const answer = await response.json();

• Når en grense er nådd, blir neste kall avvist med limit_reached (403). refused.meta sier hvilken grense og hvor høy den er.
• Det kallet som når grensen, gir hendelsen limit.reached, én gang per dag og grense.
• Har telkit stoppet utgående sending for bedriften, blir kall avvist med outbound_paused.
• Trenger dere høyere grenser, kontakt oss.

Profilens månedsgrense

En profil kan ha en grense for hvor mye den kan bruke i måneden, i øre. Over grensen blir kall avvist med profile_limit_reached (402). Grensen settes i dashbordet eller med PUT /v1/profiles/:slug/limit.

Saldoen

telkit er forhåndsbetalt. Et kall som koster penger, reserverer beløpet på saldoen før noe blir sendt, og trekker det endelige beløpet når resultatet er klart. Dekker ikke saldoen kallet, blir det avvist med insufficient_credits (402).