API-grenser

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.

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.

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.

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:

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.

Trinn 3 — Handlinger over grense

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

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.

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:

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

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.