Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

To retrieve professions, consumers are required to send an HTTP 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

POST

Attributes of the HTTP request

HTTP Request Header

token

Authorization

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
# HTTP POST
# https://ipn.dev.thinksurance.de/api/ipn/professions
#
# HTTP headers
# 'Content-Type': 'application/json'
# 'Accept': 'application/json'
{# 'Authorization':  "token": "some 'Bearer <some long string value"
}value>'
# 

Successful HTTP Response

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

Failed HTTP Response

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