Ingen treff

Grenser for API-forespørsler

Hva forespørselsgrensen begrenser

En forespørselsgrense styrer hvor ofte applikasjonen din kan kalle API-et — altså antall forespørsler, ikke antall sendte meldinger. Portalen gjør selv oppmerksom på dette i innstillingene:

Å angi denne grensen begrenser antallet API-forespørsler, ikke antallet meldinger som sendes. Når grensen er nådd, returnerer APIen HTTP-koden 429 Too Many Requests, og meldinger godtas ikke.

Én forespørsel kan inneholde hundrevis av meldinger, så denne grensen beskytter noe annet enn API-grenser for meldinger — den styrer tempoet i kallene dine, ikke volumet du sender.

Viktig

Når grensen er brukt opp, avviser API-et hele forespørselen. Meldingene i den lagres ikke noe sted og sendes ikke senere — i motsetning til meldingsgrensen, der meldinger over grensen håndteres av handlingen du har valgt for overskridelse.

Hvor du finner grensen

  1. Klikk på Moduler og APIer i portalmenyen
  2. Under Mine APIer og moduler klikker du på kortet for applikasjonen din
  3. Bli stående på fanen Innstillinger og bla ned til delen API-grenser

Kortet API-forespørselsgrenser viser verdiene i to rader — Maksimalt antall forespørsler per minutt og Maksimalt antall forespørsler per sekund. Så lenge ingenting er angitt, viser det Du har ingen innstillinger. og knappen Konfigurer.

Kortet API-forespørselsgrenser i detaljene for applikasjonen

Slik angir du grensen

Knappen Konfigurer (eller Redigere hvis du allerede har en grense) åpner vinduet API-forespørselsgrenser med to uavhengige alternativer:

Alternativ Hva det angir
Aktiver grense for API-forespørsel per minutt Hvor mange forespørsler applikasjonen kan sende i løpet av ett minutt
Aktiver API-forespørselsgrense per sekund Hvor mange forespørsler applikasjonen kan sende i løpet av ett sekund

Når du krysser av for et alternativ, vises feltet Skriv inn antall forespørsler. Du kan slå på det ene eller det andre, eller begge samtidig.

Vinduet med innstillingene for forespørselsgrensen

To regler gjelder for oppsettet:

  • den laveste tillatte verdien er 1 — ellers advarer portalen med Minimum value is 1
  • slår du på begge alternativene, kan grensen per sekund ikke være høyere enn grensen per minutt; ellers får du Verdien må ikke overstige forespørsler per minutt

Knappen Lagre forblir deaktivert til begge reglene er oppfylt — og også til du har endret verdiene i forhold til det som allerede er lagret.

Slik telles grensen

Telleren følger kalendersekundet og kalenderminuttet, ikke et glidende vindu. I det et nytt sekund begynner (et nytt minutt for grensen per minutt), starter telleren på null igjen.

Tips

Grensen per sekund egner seg til å jevne ut topper, grensen per minutt til det samlede tempoet. Når du angir begge, gjelder de samtidig — en forespørsel slipper gjennom bare når den holder seg innenfor begge.

Slik fjerner du grensen

Pilen ved siden av knappen Redigere åpner en meny med valget Slett. Bekreftelsesvinduet Slett grenser for API-forespørsel spør Er du sikker på at du vil slette API-forespørselsgrensene? — når du bekrefter, begrenser ikke API-et lenger tempoet i kallene dine.

Var denne siden nyttig?