Authentication

To access the Bühler Maintenance API, authenticate each request with an access token.

Include the access token in the Authorization header with the Bearer prefix.

Example of a cURL request to the Maintenance API with a Bearer Authorization header:

curl -X GET https://api.buhlergroup.com/maintenance/v1/plants/{plantId}/jobs-done -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

This results in the following HTTP 1.1 request:

GET /maintenance/v1/plants/{plantId}/jobs-done HTTP/1.1
Host: api.buhlergroup.com
Authorization: Bearer YOUR_ACCESS_TOKEN

Client Credentials Grant Flow

Use the OAuth 2.0 Client Credentials Grant Flow to get an access token.

sequenceDiagram
    participant Developer
    participant Support as Bühler Support
    participant Client as Client Application
    participant Identity as Bühler Identity
    participant MaintenanceAPI as Bühler Maintenance API

    Developer ->> Support: Request a technical user
    Support ->> Developer: Provide client ID and client secret

    Developer ->> Client: Add client ID, client secret, and scope

    loop Multiple API Requests
        opt Access token is missing or expired
            Client ->> Identity: Send token request with client ID, client secret, and scope
            Identity ->> Client: Return access token
        end

        Client ->> MaintenanceAPI: Send API request with access token in Authorization header
        MaintenanceAPI ->> Client: Return API response
    end

Identity Details

Parameter	Value
Tenant ID	1514cefd-4c36-4b91-88eb-628d7866a5d8
Scope	api://bdac9bc3-a144-47ee-b0d6-beebaa84de68/.default
Token endpoint	https://identity.buhlergroup.com/1514cefd-4c36-4b91-88eb-628d7866a5d8/oauth2/v2.0/token

{"environments":[],"pdf-download":true}