Integration

WARNING

This documentation is in Beta. For the current API refer to API (deprecated)

To get access as a Beta-user request it via this form: Beta-user program.

The API is available at: https://api02.reimo-shops.de/api/

The Swagger documentation for the API can be found here: https://api02.reimo-shops.de/api/swagger-ui/index.html

To Authenticate with the API you either need credentials to receive a short term token (usable for 4h) or a long term token associated with your user.

Short term token

To receive a short term token call the Integration endpoint: https://api02.reimo-shops.de/api/integration/token

curl --location 'https://api02.reimo-shops.de/api/integration/token' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--header 'Accept: application/vnd.reimo.api+json;version=v1' \
--data-urlencode 'password=<string>' \
--data-urlencode 'username=<string>'

You will receive a JWT in the response

{
  "token": "YOUR_JWT",
  "user": "YOUR_USERNAME",
  "role": "...",
  "audiences": [
    "/api/*"
  ],
  "expiration": "2025-05-23T17:48:03.637+00:00"
}

INFO

Once you have requested a token you can use it up until the expiration time

Use this token for subsequent requests

curl -X 'GET' \
  'https://api02.reimo-shops.de/api/../..' \
  -H 'accept: application/vnd.reimo.api+json;version=v1' \
  -H 'Authorization: Bearer YOUR_JWT'

Long term token

The option to use a long term token for application integration is currently only possible upon request.