API-nøgler

Hvis et eksternt system — fx en Simulant Shop-webshop, Simulant Expense eller en egen integration — skal kalde Nordbank, gør det det med en API-nøgle. Du administrerer nøglerne under Administration → API-nøgler.

Sådan opretter du en nøgle

1. Klik Generér ny nøgle på siden.
2. Udfyld:
   • Navn — fx "Simulant Shop — Hold 2A". Bruges kun til at finde nøglen igen.
   • Scopes (valgfrit) — hvilke handlinger nøglen må. Tom = alle.
   • Udløbsdato (valgfrit) — sæt en dato, hvis nøglen kun skal være gyldig i en periode.
3. Klik Generér.

Du ser nøglen én gang. Kopier den med det samme — den vises ikke igen. I tabellen ser du fremover kun et prefix (de første få tegn), så du kan identificere hvilken nøgle der er hvilken.

Hvad du ser i listen

Hver nøgle har:

• Navn — den tekst du gav den.
• Prefix — de første tegn, fulgt af ….
• Scopes — hvad nøglen må (eller "(alle)").
• Oprettet og Sidst brugt — så du kan se om en nøgle stadig er aktiv.
• Udløber — udløbsdato eller "Aldrig".
• Status — Aktiv, Tilbagetrukket eller Udløbet.

Træk en nøgle tilbage

Hvis en nøgle skal stoppe med at virke (fx fordi systemet er afkoblet eller nøglen er lækket), klikker du Træk tilbage i højre kolonne. Nøglen virker ikke længere, og status skifter til "Tilbagetrukket".

Du kan ikke aktivere en tilbagekaldt nøgle igen — generér en ny.

Tips

• Et navn pr. system, ikke pr. miljø. Hvis I har én Simulant Shop-shop pr. hold, så lav én nøgle pr. shop. Det gør tilbagekaldelse målrettet.
• Sæt udløbsdato på testkilder — så glemmer I dem ikke åbne i månedsvis.
• Kig i Sidst brugt før I rydder op. Hvis en nøgle ikke har været brugt i lang tid, er den sandsynligvis sikker at fjerne.
• For dokumentation af endepunkter, brug API-dokumentation i sidemenuen — den viser den fulde OpenAPI-specifikation.