Call the REST API

Every endpoint is a POST with a JSON body. An absent body counts as {}; a field the endpoint does not know is refused.

Base address

https://api.manitu.de/v1

Authentication

Send exactly one - two credentials in one request are refused, never resolved:

X-API-KeyAn API key from the customer panel.

AuthorizationBearer <token> - an OAuth token or an API key.

Answers

Success and failure each have one frame. The endpoint's own answer is in data. Branch on the error's code - never on its message, which may be reworded or translated.

Success

{
  "status": {
    "type": "success",
    "code": 200
  },
  "meta": {},
  "data": {
    "…": "…"
  }
}

Failure

{
  "status": {
    "type": "error",
    "code": 400,
    "message": "string"
  },
  "errors": [
    {
      "code": "string",
      "rule": "string",
      "pointer": "string",
      "message": "string",
      "doc": "string",
      "parameter": "string",
      "options": [
        {
          "value": "string",
          "label": "string"
        }
      ],
      "supply_in": {}
    }
  ],
  "meta": {}
}

Statuses each endpoint lists the ones it can answer

400The request does not match the declared input schema.401No credential was presented, or it was not recognised.403The credential is not permitted to use this operation.500The server failed. Nothing about the request was wrong. Whether a change took effect is not known - check before trying it again.503The channel this operation forwards through is unavailable.

OpenAPI

The full description as openapi.json (OpenAPI 3.1) - generate a client from it, or try the endpoints in the browser.