7.3.2. UIN Management

Download the OpenAPI file for this interface uin.yaml.

7.3.2.1. Services

POST /v1/uin

Request the generation of a new UIN.

The request body should contain a list of attributes and their value, formatted as a json dictionary.

Status Codes:

• 200 OK – UIN is generated
• 401 Unauthorized – Client must be authenticated
• 403 Forbidden – Service forbidden
• 500 Internal Server Error – Unexpected error (See Error)

Example request:

POST http://server.com/v1/uin HTTP/1.1
Host: server.com
Content-Type: application/json

{
      "firstName": "John",
      "lastName": "Doo",
      "dateOfBirth": "1984-11-19"
}

Example response:

HTTP/1.1 200 OK
Content-Type: application/json

1235567890

Example response:

HTTP/1.1 500 Internal Server Error
Content-Type: application/json

{
      "code": 1,
      "message": "string"
}