## Hva meldingsgrenser er til for

En meldingsgrense holder øye med hvor mange meldinger én applikasjon kan sende per dag.
Portalen beskriver den som en mekanisme for å angi og overvåke meldingsgrensene for
et API, og oppgir selv grunnen: å holde API-bruken under kontroll, slik at det ikke
oppstår uønskede kostnader og ingen misbruker kanalen.

Grensen kan fordeles på land, og i tillegg bestemmer du hva som skjer med
meldinger over grensen — om de skal vente, sendes neste dag eller
forkastes.

> [!NOTE]
> Denne siden handler om `API-meldingsgrenser`, altså antall sendte meldinger. Hvor
> mange forespørsler en applikasjon kan sende til API-et, beskrives på den egne
> siden [Grenser for API-forespørsler](https://www.bulkgate.com/no/dokumentasjon/api-administrasjon/api-foresporselsgrenser/).

## Hvor du finner grensene

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-meldingsgrenser` viser gjeldende oppsett i tre rader — `Maksimalt
API-meldinger per dag`, `Landsgrense for meldinger` og `Handlinger over grense`. Så lenge
ingenting er angitt, viser det i stedet `Du har ingen innstillinger.` og knappen
`Konfigurer`.

![Kortet API-meldingsgrenser i applikasjonsdetaljene](docs:api-limits/limit-card_en)

## Slik angir du grensene

Knappen `Konfigurer` (eller `Redigere`, hvis du allerede har grenser) åpner vinduet `API-meldingsgrenser`
med tre trinn. Du går mellom dem med knappene `Neste`
og `Tilbake`; ingenting lagres før du til slutt klikker på `Lagre`.

### Trinn 1 — Maksimalt API-meldinger per dag

Skriv inn hvor mange meldinger applikasjonen kan sende i løpet av én dag. Uten et
positivt tall forblir knappen `Neste` deaktivert.

![Det første trinnet med maksimalt antall meldinger per dag](docs:api-limits/limit-step-total_en)

### Trinn 2 — Landsgrense for meldinger

Enten lar du `Ingen grense` stå, eller du velger `Angi den egendefinerte grensen for et spesifikt land`
og velger landene du vil behandle separat, i feltet `Søk etter land`.
Hvert land legges til i en liste der du gir det én av tre moduser:

| Modus | Hva den betyr |
|:--|:--|
| `API maksimum` | Landet trekker fra den felles daglige grensen og har ingen egen grense |
| `Grense` | Landet har sin egen daglige grense, som du skriver inn i feltet ved siden av |
| `Blokkere` | Ingenting sendes til dette landet |

Når listen inneholder mer enn én oppføring, vises raden `Andre land`, som
angir modus for alle de øvrige landene på én gang. Søppelbøtteikonet fjerner et
land fra listen.

![Det andre trinnet med grenser per land](docs:api-limits/limit-step-country_en)

### Trinn 3 — Handlinger over grense

Portalen spør `Hva skal jeg gjøre med meldinger som overskrider grensen?` og tilbyr
tre alternativer:

| Alternativ | Virkemåte |
|:--|:--|
| `Lagre meldinger i utboks` | Meldinger over grensen lagres i utboksen for senere behandling |
| `Send i morgen` | Meldinger over grensen sendes neste dag på klokkeslettet du angir sammen med alternativet |
| `Kast meldinger` | Meldinger over grensen forkastes |

![Det tredje trinnet med handlinger over grense](docs:api-limits/limit-step-policy_en)

> [!WARNING]
> Et blokkert land følger sin egen regel — meldinger dit forkastes uansett
> hvilken handling over grense du har valgt.

## Slik følger du med på forbruket av grensen

Over fanene `Innstillinger` og `Statistikk` finner du panelet `Dagens API-grensestatus`
med brukt prosentandel og en fremdriftslinje. Når du fordeler grensen på
land, legges det til en rad for hvert av dem; et blokkert land viser `nektet`
i stedet for linjen.

![Panelet Dagens API-grensestatus](docs:api-limits/limit-status_en)

Ved 80 % varsler portalen med `Your daily limit will soon be exceeded.`, og når
hele grensen er brukt opp, med `Du har nådd din daglige API-grense!`.

Knappen `Tilbakestill grensen` nullstiller telleren for dagens meldinger — bekreftelsesvinduet
gjør oppmerksom på at `Telleren for meldinger sendt i dag vil bli tilbakestilt til null.`
Ikonet ved siden av en landrad tilbakestiller bare det ene landet. Så lenge
applikasjonen ikke har sendt noe i dag, forblir knappen deaktivert.

## Varsler om uvanlig trafikk

I tillegg til grensene du angir selv, følger portalen også med på hvordan
trafikken fra applikasjonen din utvikler seg over tid. Den sammenligner dagens meldinger med det
applikasjonen sendte i den foregående perioden, og varsler deg når de to
skiller seg merkbart fra hverandre.

Den skiller mellom to tilfeller:

| Hva som skjer | Hvordan det vises |
|:--|:--|
| Meldinger begynner å gå til et land applikasjonen din vanligvis ikke sender til | Meldingene lagres i utboksen, og varselet kommer på e-post og SMS |
| Et land du sender til regelmessig, får merkbart flere meldinger enn vanlig | Sendingen fortsetter, og varselet kommer på e-post |

Det første tilfellet fungerer dermed også som en sikring — meldingene venter til du
godkjenner dem, uansett hvilken handling over grense du har valgt.

> [!IMPORTANT]
> Denne kontrollen kjører bare så lenge du ikke har angitt egne grenser per land i
> trinnet `Landsgrense for meldinger`. Når du håndterer landene selv, følger
> portalen innstillingene dine og overvåker ikke trender.

For at portalen ikke skal oversvømme deg, sender den bare noen få varsler om
samme fenomen og blir deretter stille. Den trenger også sendehistorikk — for en nyopprettet
applikasjon uten noe å sammenligne med vurderes ikke trender.

## Slik fjerner du grensene

Pilen ved siden av knappen `Redigere` åpner en meny med alternativet `Slett`. Bekreftelsesvinduet
`Fjern API-grenser` gjør oppmerksom på at API-et etter slettingen
ikke lenger vil begrense sendingen av meldinger etter grenser.