Taxi Supplier API

References

Providing a token

You must implement the following endpoint to enable us to retrieve an OAuth 2.0 token to access your endpoints via our webhooks.

POST /oauth/token

Request Headers

Header Value
Authorization Basic <token>
Content-Type application/x-www-form-urlencoded

URL Parameters

Parameter Type Description Required
grant_type String Indicates the grant type which will always be client_credentials Yes

Sample Request

POST /oauth/token?grant_type=client_credentials

Response Fields

Fields Type Description Required
access_token String The access token we will use to make calls to the webhook endpoints implemented by the supplier partner. JSON Web Tokens is a popular format for implementing the access token. Yes
expires_in Integer If the access token expires, the server should reply with the duration of time in seconds the access token is granted for e.g. 3600. Recommended

Sample Response Body

{
  "access_token": "example-token",
  "token_type": "Bearer",
  "expires_in": 3600
}

Responses

HTTP 200 - OK

HTTP 4xx - Client error - Error response format

HTTP 5xx - Server error - Error response format