Authentication

What does the Authentication Endpoint do?

Once you have API credentials, the Authentication endpoint allows you to generate your own bearer token. The resulting token can be used as an api_key value on the documentation site.

Using the Data Information Endpoint

Include an Authorization header using Basic Auth for the username and password provided. 

Authentication Endpoint Documentation

POST: /api/v1/get-token

Response Class (Status 200)

Model Schema

{ 
  "access_token": "string", 
  "token_type": "string", 
  "expires_in": 0 
} 

Response Messages

HTTP Status CodeReason
401expected response when requesting an access token with an invalid Authorization header

Example Requests and Responses

Example Request

http://hoopla-api.hoopladigital.com/api/v1/get-token

curl -X POST --header 'Content-Type: application/json' --header 'Accept: application/json' --header 'Authorization: e42fe129-cdd9-4e6a-a33b-91f56ab6d8c5' --header 'ws-api: 2.1' 'http://hoopla-api.hoopladigital.com/api/v1/get-token'

Example Response

{ 
    "access_token": "faecd8f9-e4ea-4b77-a691-dddc124f458a", 
    "token_type": "bearer", 
    "expires_in": 770072 
} 


← Return home