Introduktion

STS-UUID2CPR-PROXY er en støtte-service på NSP, der tillader opslag i Digitaliseringsstyrelsens NemLog-in opslagstjenester. Servicen udstiller et simpelt REST-interface, og kræver ikke sikkerhedsbillet. Servicen består af følgende oprationer

  • /service/lookup/{uuid}
  • /service/lookup-pid-cpr/{pid}

  • /service/lookup-uuid-rid/{uuid}

Snitfladebeskrivelse

Generelt

Servicen udstiller 3 operationer via GET. Operationerne er beskrevet i en OpenAPI-specifikation, som kan hentes på stien /uuid2cpr-proxy-api/openapi. For nuværende version 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 opslags services.
  version: "1.0.0"

servers:
  - url: '%endpoint%'

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.
        500:
          description: Der opstod en fejl under opslag af cpr-nummer.

  /service/lookup-pid-cpr/{pid}:
    get:
      summary: Hent cpr-nummer ud fra pid.
      description: Hent cpr-nummer ud fra pid.
      parameters:
        - in: path
          name: pid
          schema:
            type: string
          required: true
          description: Pid
      responses:
        200:
          description: Ok
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/cpr'
        404:
          description: Det givne pid har intet cpr-nummer tilknyttet.
        500:
          description: Der opstod en fejl under opslag af cpr-nummer.

  /service/lookup-uuid-rid/{uuid}:
    get:
      summary: Hent rid ud fra uuid.
      description: Hent rid 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/rid'
        404:
          description: Det givne uuid har intet rid tilknyttet.
        500:
          description: Der opstod en fejl under opslag af rid.

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

Eksempler

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

Service lookup

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:2634ccc3-225a-44ee-94bc-000000000000

Response:

HTTP/1.1 404 Not Found
Connection: keep-alive
Content-Type: application/json
Content-Length: 74
Date: Wed, 08 Mar 2023 09:40:41 GMT

Uuid UI:DK-E:G:2634ccc3-225a-44ee-94bc-000000000000 has no associated cpr.

Service lookup-pid-cpr

Cpr-nummer findes

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

Request:

curl -i localhost:8080/uuid2cpr-proxy-api/service/lookup-pid-cpr/9208-2002-2-199567135534

Response:

HTTP/1.1 200 OK
Connection: keep-alive
Content-Type: application/json
Content-Length: 22
Date: Fri, 24 Feb 2023 12:26:53 GMT

{"value":"2501879875"}

Cpr-nummer findes ikke

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

Request:

curl -i localhost:8080/uuid2cpr-proxy-api/service/lookup-pid-cpr/9208-2002-2-000000000000

Response:

HTTP/1.1 404 Not Found
Connection: keep-alive
Content-Type: application/json
Content-Length: 51
Date: Wed, 01 Mar 2023 05:43:12 GMT

Pid 9208-2002-2-000000000000 has no associated cpr.

Service lookup-uuid-rid

Rid findes

Dette eksempel viser tilfældet hvor uuid har et matchende rid.

Request:

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

Response:

HTTP/1.1 200 OK
Connection: keep-alive
Content-Type: application/json
Content-Length: 20
Date: Fri, 24 Feb 2023 12:44:22 GMT

{"value":"72976780"}


Rid findes ikke

Dette eksempel viser tilfældet hvor uuid ikke har et matchende rid.

Request:

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

Response:

HTTP/1.1 404 Not Found
Connection: keep-alive
Content-Type: application/json
Content-Length: 74
Date: Wed, 01 Mar 2023 05:45:00 GMT

Uuid UI:DK-E:G:2634ccc3-225a-44ee-94bc-000000000000 has no associated rid.




  • No labels