Page History
| Navitabs | ||||||
|---|---|---|---|---|---|---|
| ||||||
| Table of Contents |
|---|
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 - Rolleinformation" er målrettet udviklere og arkitekter hos leverandører, som ønsker at anvende funktionaliteten udstillet af servicen "Rolleinformation" i stamdataservicen
Rolleinformation
Stamdataservicen udstiller en REST-service der kan anvendes til at hente de nationale roller (externalName) der er tilknyttet et SSN.
...
| Code Block | ||||||
|---|---|---|---|---|---|---|
| ||||||
openapi: 3.0.0
info:
title: Rolle Information REST Service
description: Intern NSP service, der kan anvendes til at slå informationer om roller op.
version: "1.0.0"
servers:
- url: '%endpoint%'
paths:
/stamdata-rolleinformation/roller/{ssn}:
get:
summary: Hent gyldige nationale roller for et SSN.
description: >
Returnerer en liste af nationale roller, der er gyldige dags dato (ValidFrom <= NOW()
AND (ValidTo > NOW() OR ValidTo IS NULL)) for det angivne SSN.
Findes der ingen gyldige roller returneres 404 med en tom JSON body.
parameters:
- in: path
name: ssn
schema:
type: string
maxLength: 64
required: true
description: Subject Serial Number (SSN)
example: "CVR:25450442-RID:22019616"
responses:
200:
description: OK - en eller flere gyldige roller fundet.
content:
application/json:
schema:
$ref: '#/components/schemas/roller'
400:
description: Ugyldig forespørgsel (fx tomt SSN eller SSN der overstiger 64 tegn).
404:
description: Der findes ingen gyldige roller for det angivne SSN.
500:
description: Intern serverfejl.
components:
schemas:
roller:
type: array
items:
$ref: '#/components/schemas/rolle'
rolle:
type: object
required:
- externalName
properties:
externalName:
type: string
description: Det eksterne navn for rollen som registreret i nationalRoles. |
Endpoints
Servicen kan tilgås på nedenstående endpoint, hvor stamdatahost skal tilrettes til den aktuelle host.
| Endpoint | Url |
|---|---|
| Hent roller for et SSN | http://stamdatahost/stamdata-rolleinformation/roller/{ssn} |
Eksempler
Eksempel 1: Hent roller for et SSN med en gyldig rolle
I dette eksempel kaldes servicen med et SSN fra et POCES-certifikat. Se i øvrigt API-specifikationen længere oppe.
...
| Code Block | ||
|---|---|---|
| ||
[
{ "externalName": "nspPlejeAssR3" }
]
|
Eksempel 2: Hent roller for et SSN med flere gyldige roller
I dette eksempel slås der op på et SSN med tre gyldige roller. Servicen returnerer dem alle
...
| Code Block | ||
|---|---|---|
| ||
[
{ "externalName": "nspPlejeAssR3" },
{ "externalName": "nspSundAssistR1" },
{ "externalName": "nspSundAssistR2" }
]
|
Eksempel 3: SSN uden gyldige roller
Hvis SSN'et ikke findes i nationalRoles, eller alle rækker har ValidFrom/ValidTo uden for nuværende tidspunkt, svares der med HTTP statuskode 404 og en tom JSON-body.
...
HTTP statuskode 404.
| Code Block | ||
|---|---|---|
| ||
[] |
Eksempel 4: Ugyldig forespørgsel
Tomt SSN eller SSN længere end 64 tegn afvises med HTTP statuskode 400 og en plain-text fejlbesked.
...