Introduktion

STS-UUID2CPR-PROXY er en støtte-service på NSP, der tillader opslag i Digitaliseringsstyrelsens Uuid2Cpr-service. Servicen udstiller et simpelt REST-interface, og kræver ikke sikkerhedsbillet.

Snitfladebeskrivelse

Generelt

Servicen udstiller en enkelt operation via GET. Operationen er beskrevet i en OpenAPI-specifikation, som kan hentes på stien /uuid2cpr-proxy-api/openapi. I version 1.0.0 af servicen ser specifikationen ud som nedenfor.

openapi: 3.0.0
info:
  title: Uuid2Cpr Proxy service
  description: Intern NSP service der kan anvendes til at kalde NemLogin Uuid2cpr-servicen.
  version: "1.0.0"

servers:
  - url: 'http://localhost:8080/uuid2cpr-proxy-api'

paths:
  /service/lookup/{uuid}:
    get:
      summary: Hent cpr-nummer ud fra uuid.
      description: Hent cpr-nummer ud fra uuid.
      parameters:
        - in: path
          name: uuid
          schema:
            type: string
          required: true
          description: Uuid
      responses:
        200:
          description: Ok
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/cpr'
        404:
          description: Det givne uuid har intet cpr-nummer tilknyttet.

components:
  responses:
    '404':
      description: "Resource findes ikke."
  schemas:
    cpr:
      type: object
      required:
        - value
      properties:
        value:
          type: string

Eksempler

Herunder illustreres et par eksempel-requests og de tilhørende responses.

Cpr-nummer findes

Dette eksempel viser tilfældet hvor uuid'et har et matchende cpr-nummer.

Request:

curl -i localhost:8080/uuid2cpr-proxy-api/service/lookup/UI:DK-E:G:2634ccc3-225a-44ee-94bc-565904f46ead

Response:

HTTP/1.1 200 OK
Connection: keep-alive
Content-Type: application/json
Content-Length: 22
Date: Wed, 09 Mar 2022 15:28:08 GMT

{"value":"2501879875"}

Cpr-nummer findes ikke

Dette eksempel viser tilfældet hvor uuid'et ikke har et matchende cpr-nummer.

Request:

curl -i localhost:8080/uuid2cpr-proxy-api/service/lookup/UI:DK-E:G:00000000-0000-0000-0000-000000000000

Response:

HTTP/1.1 404 Not Found
Connection: keep-alive
Content-Type: application/json
Content-Length: 89
Date: Wed, 09 Mar 2022 15:31:36 GMT

Uuid UI:DK-E:G:00000000-0000-0000-0000-000000000000 har ikke noget cpr-nummer tilknyttet.