API-dokumentation

Hvis I selv vil bygge en integration mod Nordbank — eller blot vil forstå, hvad Simulant Shop-modulet og Simulant Expense gør under motorhjelmen — finder I den fulde API-reference under Administration → API-dokumentation.

API-dokumentation

Hvad du ser

Siden viser den komplette OpenAPI-specifikation for Nordbank som en interaktiv reference:

Operationer grupperet pr. ressource — me, accounts, transactions, fikort, cards, upcoming, inbox, loans, simid, admin og Models.
Anmodningsformat og respons for hver endpoint, med JSON-eksempler.
Klient-eksempler klar til at kopiere — Shell (curl), Ruby, Node.js, PHP og Python.
Test Request-knap, der lader dig kalde endpointet direkte fra browseren med en gyldig API-nøgle.

Sådan kalder du et endpoint

Generér en API-nøgle under API-nøgler.
På API-dokumentationssiden indtaster du nøglen i Bearer Token-feltet.
Vælg et endpoint i venstre side, fx GET /api/v1/me.
Klik Test Request for at kalde det.
Svaret vises direkte under, med status-kode og JSON-body.

Beløb returneres altid i øre (1 kr. = 100 øre). Hver gennemført overførsel returnerer et transactionId — gentagne kald med samme transactionId afvises, så I kan trygt retry uden at lave dubletter.

Sådan henter du OpenAPI-specifikationen

Klik OpenAPI JSON → øverst på siden for at få den rå spec som JSON. Den kan I importere i Postman, Insomnia eller en kodegenerator.

Tips

Brug Test Request-fanen sammen med eleverne for at vise, hvordan en webshop "snakker" med banken — det gør abstraktionen konkret.
Når I bygger en integration, så start med GET /api/v1/me for at bekræfte at API-nøglen virker, før I forsøger noget skrivende.
Holder I et undervisningsforløb om API'er, så lad eleverne skrive deres første curl-kald mod et af accounts-endpointsne — det kobler bankens UI til datalaget på en konkret måde.

Hvad du ser

Siden viser den komplette OpenAPI-specifikation for Nordbank som en interaktiv reference:

Operationer grupperet pr. ressource — me, accounts, transactions, fikort, cards, upcoming, inbox, loans, simid, admin og Models.

Anmodningsformat og respons for hver endpoint, med JSON-eksempler.

Klient-eksempler klar til at kopiere — Shell (curl), Ruby, Node.js, PHP og Python.

Test Request-knap, der lader dig kalde endpointet direkte fra browseren med en gyldig API-nøgle.

Sådan kalder du et endpoint

Generér en API-nøgle under API-nøgler.

På API-dokumentationssiden indtaster du nøglen i Bearer Token-feltet.

Vælg et endpoint i venstre side, fx GET /api/v1/me.

Klik Test Request for at kalde det.

Svaret vises direkte under, med status-kode og JSON-body.

Tips

Brug Test Request-fanen sammen med eleverne for at vise, hvordan en webshop "snakker" med banken — det gør abstraktionen konkret.

Når I bygger en integration, så start med GET /api/v1/me for at bekræfte at API-nøglen virker, før I forsøger noget skrivende.

Holder I et undervisningsforløb om API'er, så lad eleverne skrive deres første curl-kald mod et af accounts-endpointsne — det kobler bankens UI til datalaget på en konkret måde.