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 - Sikredeinformation” er målrettet udviklere og arkitekter hos leverandører, som ønsker at anvende funktionaliteten udstillet af servicen "Sikredeinformation" i stamdataservicen.

Sikredeinformation

Stamdataservicen udstiller en REST service der, i sin nuværende form, kan anvendes til

  1. at hente det ydernummer der er tilknyttet en sikredes nuværende læge ("Egen Læge"-relation).

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 ved servicens oprettelse. Den mest aktuelle specifikation kan findes i sourcekoden (som pt. hostes her sikredeinformation.yaml).

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

servers:
  - url: '%endpoint%'

paths:
  /stamdata-sikredeinformation/2025/07/17/sikrede/{cpr}/egenLaegeYdernummer:
    get:
      summary: Henter ydernummer for en Sikredes valgte læge.
      description: Returnerer ydernummeret for valgt læge af Sikrede givet et CPR nummer. Hvis læge ikke er valgt returneres 'null'. Hvis CPR ikke findes returneres 404.
      parameters:
        - in: path
          name: cpr
          schema:
            type: string
          required: true
          description: Sikredes CPR nummer.
      responses:
        200:
          description: Ok
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ydernummer'
        404:
          description: Det givne CPR nummer findes ikke.

components:
  responses:
    '400':
      description: "Bad Request."
    '404':
      description: "Resource findes ikke."
  schemas:
    sikrede:
      type: object
      required:
        - cpr
      properties:
        cpr:
          $ref: '#/components/schemas/cpr'
        ydernummer:
          $ref: '#/components/schemas/ydernummer'
    cpr:
      type: object
      required:
        - cpr
      properties:
        cpr:
          type: string
          description: Sikredes personnummer
          pattern: '^\d{10}$'  # CPR er præcis 10 cifre.
          example: "0101011234"
    ydernummer:
      type: object
      properties:
        ydernummer:
          type: string
          description: Ydernummer; sikredes valg af læge
          pattern: '^\d{6}$'  # Ydernummer er præcis 6 cifre.
          example: "010101"

Endpoints

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

  1. http://stamdatahost/stamdata-sikredeinformation/2025/07/17/sikrede/{cpr}/egenLaegeYdernummer

Bemærk, at der pt. kun findes én version af servicen, som er version "2025/07/17". Fremtidige versioner vil ligeledes angives med en dato. 

Eksempler

Eksempel 1.1: Find ydernummer for sikredes egen læge - Sikrede med relation til læge

Request

Request i form af et curl-udtryk.

curl --include http://localhost:8089/stamdata-sikredeinformation/2025/07/17/sikrede/1111770240/egenLaegeYdernummer

Response

Svaret af HTTP kald, som indeholder status, headers og JSON. 

HTTP/1.1 200 OK
Connection: keep-alive
X-Powered-By: Undertow/1
Server: WildFly/8
Transfer-Encoding: chunked
Content-Type: application/json
Date: EEE, dd MMMM yyyy HH:mm:ss GMT

{"ydernummer":"447799"}

Eksempel 1.2: Find ydernummer for sikredes egen læge - Sikrede uden relation til læge

Request

Request i form af et curl-udtryk.

curl --include http://localhost:8089/stamdata-sikredeinformation/2025/07/17/sikrede/1711780434/egenLaegeYdernummer

Response

Svaret af HTTP kald, som indeholder status, headers og JSON. 

HTTP/1.1 200 OK
Connection: keep-alive
X-Powered-By: Undertow/1
Server: WildFly/8
Transfer-Encoding: chunked
Content-Type: application/json
Date: EEE, dd MMMM yyyy HH:mm:ss GMT

{"ydernummer":null}

Eksempel 1.3: Find ydernummer for sikredes egen læge - Sikrede findes ikke

Request

Request i form af et curl-udtryk.

curl --include http://localhost:8089/stamdata-sikredeinformation/2025/07/17/sikrede/9999999999/egenLaegeYdernummer

Response

Svaret af HTTP kald, som indeholder status og headers. 

HTTP/1.1 404 Not Found
Connection: keep-alive
X-Powered-By: Undertow/1
Server: WildFly/8
Content-Length: 0
Date: EEE, dd MMMM yyyy HH:mm:ss GMT


Eksempel 1.4: Find ydernummer for sikredes egen læge - Servicen fejler

Request

Request i form af et curl-udtryk.

curl --include http://localhost:8089/stamdata-sikredeinformation/2025/07/17/sikrede/1111770240/egenLaegeYdernummer

Response

Svaret af HTTP kald, som indeholder status og headers. 

HTTP/1.1 500 Internal Server Error
Connection: keep-alive
X-Powered-By: Undertow/1
Server: WildFly/8
Content-Length: 0
Date: EEE, dd MMMM yyyy HH:mm:ss GMT