Authentication

How do I get an API token

For information on getting a token for this API go to the applications section on your agency portal.

Making authenticated request

To make calls to the API, send the API token in the Authorization HTTP header using the Bearer authentication scheme.

Example

curl --header "Authorization: Bearer {token}" https://api.basset.ws/{path}

Error response

401 - Unauthorized

{
  "message": "Unauthorized"
}

401 - Token Expired

{
  "message": "Token expired"
}

401 - Access Denied

{
  "message": "Invalid scope"
}

Refresh authentication token

GET https://api.basset.ws/clients/applications/:application_id/token?refresh_token=:refresh_token

Method used to refresh an authentication bearer token

Path Parameters

Name	Type	Description
application_id	string	Oauth app ID

Query Parameters

Name	Type	Description
refresh_token	string	Refresh token created on agency portal

200

{
    "access_token": "ayJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsImtpZCI6Ik1UQkdRalUwTkRkRk1FTTFNMFZHTmpKRk9VUXpRVVpHTWtSRE9UbEVSREE0TmpFNFFUQkRRUSJ9.eyJpc3MiOiJodHRwczovL2Jhc3NldC5hdXRoMC5jb20vIiwic3ViIjoiYXV0aDB8NWIzMjQ5Yjk3ODcxZDUwZGUwNDZiOTIxIiwiYXVkIjoiYXBpLmJhc3NldC53cyIsImlhdCI6MTU0MDkwNzI4OCwiZXhwIjoxNTQwOTkzNjg4LCJhenAiOiJVb0NBaWZpeFk0V2gwWGJMWlF3dmtpOGtMbHpSeXE2TiIsInNjb3BlIjoicmVhZDpyZXNlcnZhdGlvbnMgcmVhZDp0b2tlbiBvZmZsaW5lX2FjY2VzcyJ9.ZgUAKTlUhVEJDOoMPBJ-lGYGzz2TCBRHWL3GnJT733DTQwZNi_4xSCnea-o3KwnKa_Nc7Px4he1zXGPM2U3sP4lPd3cL1N5z6ce2IPKnE1KYfTDmpW5u1AI3l6FcTjIRZqJ8vWD_Ex_KdCzK-Ce7QMdKlunWedL43WhdfClqqA4DQlvdYEuI2SDuJkFU2QEaRn3pSFTIonW9m9kXta0Ly_e6fr1-wXkOApvtH-9wPBbfTDA7eSOZunoOiGLIdXlqFOp4kou2CSo6gAAh5w1SYYTENTD4AaLfpCIiwVPOh130IeeuZrJ-Le01y1xewbal50CgMvp6xQbWZpm-sMOAeA",
    "expires_in": 86000,
    "scopes": [
        "read:reservations"
    ],
    "token_type": "Bearer"
}