## 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](https://www.bulkgate.com/no/dokumentasjon/api-administrasjon/api-grenser/) — den styrer tempoet i
kallene dine, ikke volumet du sender.

> [!IMPORTANT]
> 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](docs:api-request-limits/request-limit-card_en)

## 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](docs:api-request-limits/request-limit-settings_en)

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.

> [!TIP]
> 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.