Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Reverted from v. 3

...

To retrieve professions, consumers are required to send an HTTP GET POST request to the /api/ipn/professions endpoint. This endpoint requires the security token, obtained during the Authentication process on the API, as an integral component of the JSON payload within the body of the request.

Action name

get professions

HTTP path

/api/ipn/professions

HTTP method

GETPOST

Attributes of the HTTP request

HTTP Request Header

Authorization

token

string

required

A security token provided from Authentication endpoint.

Required to provide as a Bearer Token (in format: “Bearer {{token}}“).

Attributes of the HTTP response

...

This section shows examples of different HTTP requests and responses associated with the endpoint /api/ipn/professions.

HTTP Request

Code Block
languagejson
# HTTP GETPOST
# https://ipn.dev.thinksurance.de/api/ipn/professions
# # HTTP headers
'Content-Type': 'application/json'
# 'Accept': 'application/json'
# 'Authorization': 'Bearer <some{
  "token": "some long string value>'
# value"
}

Successful HTTP Response

json
Code Block
language
# HTTP 200 status code
# 'Content-Type': 'application/json'
[
  {
    "id": 1,
    "name": "Profession1"
  },
  {
    "id": 2,
    "name": "Profession2"
  }
]

Failed HTTP Response

json
Code Block
language
# HTTP 200 status code
# 'Content-Type': 'application/json'
{
  "error": "API User is not existing or deactivated."
}