Skip to main content

Authenticate

You need client credentials from the Backoffice to authenticate with the REST API. In this page you request an access token and use it to make your first API call.

Prerequisites​

  • A Propeller REST API credentials (client_id and client_secret) (from your account manager, see Environments and Access)

Step 1: Request an access token​

curl -X POST https://api.helice.cloud/oauth2/token \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "client_id=your_client_id&client_secret=your_client_secret&grant_type=client_credentials"

Replace your_client_id and your_client_secret with the credentials from your Backoffice.

Expected response:

{
  "access_token": "eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwic2NvcGUiOiJwcm9maWxlIiwiaWF0IjoxNzE2MjM5MDIyLCJleHAiOjE3MTYyNDA4MjJ9.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c",
  "expires_in": 1800,
  "token_type": "Bearer",
  "scope": "profile"
}

The token is valid for 30 minutes.

Step 2: Make an authenticated request​

Use the token to fetch products from the REST API:

curl -X GET https://api.helice.cloud/v2/products \
  -H "Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwic2NvcGUiOiJwcm9maWxlIiwiaWF0IjoxNzE2MjM5MDIyLCJleHAiOjE3MTYyNDA4MjJ9.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c" \
  -H "Content-Type: application/json"

Expected response:

{
  "data": [
    {
      "id": 1024,
      "sku": "VALVE-DN50-PN16",
      "name": "Ball Valve DN50 PN16"
    },
    {
      "id": 1025,
      "sku": "FLANGE-DN50-PN16",
      "name": "Weld Neck Flange DN50 PN16"
    }
  ],
  "total": 2847
}

If you see product data, authentication is working. You are ready to start building your integration.

Next steps​