Authentication

1. Obtain your credentials from the Storable API Integration team.
2. Once you have your credentials, use them to call the token endpoint to Get an Access Token
3. Use the access token along with your API Key to Authenticate REST API calls in the header.

Generate an access token with a POST request to the Storable token endpoint. This endpoint is protected using Basic Authentication where the username is the Client Id and the password is the Client Secret. The response will contain the access token which can be used to access the protected APIs. The following parameters are required in the token request:

The token endpoint is https://api.storable.io/auth/token

Request example:

curl --location --request POST 'https://api.storable.io/auth/token' \
  -H 'Authorization: Basic bXktY2xpZW50LWlkOm15LWNsaWVudC1zZWNyZXQ=' \
  -H 'x-api-key: 5XOZWgBi472xX72v6inMA6zX8xRxjbH47sqZK0eI'

Response example:

{
  "access_token": "eyJhbGciOiJSUzI1NiIsImtpZCI6Imp3ay.long-token.here",
  "token_type": "bearer"
}

To optimize performance and reduce unnecessary load on the token endpoint, tokens should be cached and reused until expiration. The token endpoint is subject to rate limiting, so frequent or redundant requests for new tokens may be throttled.

The token response includes two custom HTTP headers to support Access Token caching and lifecycle management:

Authenticate REST API calls by including the Access Token and your API Key in the request headers. The following parameters are required in the request:

Request example:

curl --location 'https://api.storable.io/sample-api/v1/info' \
-H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsImtpZCI6Imp3ay.long-token.here' \
-H 'x-api-key: 5XOZWgBi472xX72v6inMA6zX8xRxjbH47sqZK0eI'