Authentication

Renew your authentication token with the API

This method is used to issue a new API authorization token without having to specify a username and password. It will return a new API token that can be used for subsequent requests.

POST

/renew

curl --request POST \
  --url https://api.catch-e.com/renew \
  --header 'Authorization: <api-key>'

{
  "access_token": "aaaaaa/bbbbbb.ccccccc.dddddd",
  "expires_in": 3600,
  "token_type": "bearer"
}

Authorizations

Authorizationstringheaderrequired

For accessing the API a valid token must be passed in all the queries in the 'Authorization' header.

A valid token is generated by the API and returned by the /authenticate method by supplying a valid username and password.

The following syntax must be used in the 'Authorization' header :

Bearer aaaaaa/bbbbbb.ccccccc.dddddd

Response

Success

access_tokenstring

Example: aaaaaa/bbbbbb.ccccccc.dddddd

expires_ininteger

Token expiry time in seconds

Required range: 0 <= x <= 999999

Example: 3600

token_typeenum<string>

Available options: bearer

Still need help? Ask the team