Formål

Nærværende dokument indgår i den samlede dokumentationspakke for stamdataregistret på NSP. Dokumentationspakken giver tilsammen det fulde overblik over dokumentationen.

"Guide til anvendere - Autorisationinformation" er målrettet udviklere og arkitekter hos leverandører, som ønsker at anvende funktionaliteten udstillet af servicen "Autorisationinformation" i stamdataservicen.

Autorisationinformation

Stamdataservicen udstiller en REST-service der kan anvendes til at hente autorisationer (aut_id, edu_id) for et givent CPR-nummer fra tabellen autreg.

Servicen udstiller følgende snitflade:

Bemærk: Denne service kan kun anvendes internt på NSP. Derfor har servicen heller ikke nogen sikkerhedsprotokol.

Herunder gengives den aktuelle snitflade som den ser ud. Den mest aktuelle specifikation kan findes i sourcekoden (som pt. hostes her https://git.nspop.dk/projects/COM/repos/stamdatamodul/browse).

openapi: 3.0.0
info:
  title: Autorisation Information REST Service
  description: Intern NSP service, der kan anvendes til at slå informationer om autorisationer op.
  version: "1.0.0"

servers:
  - url: '%endpoint%'

paths:
  /2026/06/16/autorisation/{cpr}:
    get:
      tags:
        - autorisation
      operationId: getAutorisationer
      summary: Hent autorisationer for et CPR-nummer.
      description: >
        Returnerer en liste af autorisationer (aut_id, edu_id) for det angivne CPR-nummer.
        Findes der ingen autorisationer returneres 404 med en tom JSON body.
      parameters:
        - in: path
          name: cpr
          schema:
            type: string
            pattern: '^[0-3]\d[0-1]\d{3}-?\d{4}$'
          required: true
          description: CPR-nummer på formen DDMMYY-XXXX eller DDMMYYXXXX (bindestreg er valgfri).
      responses:
        200:
          description: OK - en eller flere autorisationer fundet.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/autorisationer'
        400:
          description: Ugyldig forespørgsel (fx ugyldigt CPR-format).
        404:
          description: Der findes ingen autorisationer for det angivne CPR-nummer.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/autorisationer'
        500:
          description: Intern serverfejl.

components:
  schemas:
    autorisationer:
      type: array
      items:
        $ref: '#/components/schemas/autorisation'

    autorisation:
      type: object
      required:
        - aut_id
        - edu_id
      properties:
        aut_id:
          type: string
          description: Autorisations-ID som registreret i autreg.
          maxLength: 5
          example: "108NX"
        edu_id:
          type: string
          description: Uddannelses-ID som registreret i autreg.
          maxLength: 4
          example: "7170"

Endpoints

Servicen kan tilgås på nedenstående endpoint, hvor stamdatahost skal tilrettes til den aktuelle host.

EndpointUrl
Hent autorisationer for et CPR-nummerhttp://stamdatahost/stamdata-autorisationinformation/2026/06/16/autorisation/{cpr}}

Eksempler

Eksempel 1: Hent autorisation for et CPR-nummer med én autorisation

I dette eksempel kaldes servicen med et CPR-nummer der har én autorisation registreret i autreg.

Request

curl --location 'http://stamdatahost/stamdata-autorisationinformation/2026/06/16/autorisation/1010903333'

Response

Der svares med HTTP statuskode 200 og følgende JSON.

[
  { "aut_id": "108NX", "edu_id": "7170" }
]

Eksempel 2: Hent autorisationer for et CPR-nummer med flere autorisationer

Et CPR-nummer kan have flere autorisationer (fx forskellige uddannelser). Servicen returnerer dem alle.

Request

curl --location 'http://stamdatahost/stamdata-autorisationinformation/2026/06/16/autorisation/1111901117'

Response

Der svares med HTTP statuskode 200 og følgende JSON.

[
  { "aut_id": "FNX07", "edu_id": "7170" },
  { "aut_id": "AB123", "edu_id": "1234" },
  { "aut_id": "CD456", "edu_id": "5678" }
]

Eksempel 3: Hent autorisation med bindestreg i CPR-nummere

CPR-nummeret accepteres også på den klassiske form med bindestreg. Bindestregen strippes inden DB-opslaget.

Request

curl --location 'http://stamdatahost/stamdata-autorisationinformation/2026/06/16/autorisation/101090-3333'

Response

HTTP statuskode 200 — samme svar som Eksempel 1.

[
  { "aut_id": "108NX", "edu_id": "7170" }
]

Eksempel 4: Ugyldig forespørgsel

Tomt CPR eller CPR der ikke matcher det forventede format afvises med HTTP statuskode 400 og en plain-text fejlbesked.

Request

curl --location 'http://stamdatahost/stamdata-autorisationinformation/2026/06/16/autorisation/9999999999'

Response

HTTP statuskode 404.

Ugyldigt CPR-nummer: skal være 10 cifre, evt. med bindestreg.