Authorization
Base URL
The base URL depends on the region where your system is hosted. When you request API Access, our team will share a Postman Collection with the Base URL applicable for your system, which will be one of the below:
America: https://api.caagcrm.com/api/
America 3: https://api-america-3.caagcrm.com/api-america-3/
America West: https://api-america-west.caagcrm.com/api-america-west/
America Miami: https://api-america-miami.caagcrm.com/api-america-miami/
Europe: https://api-europe.caagcrm.com/api-europe/
Asia: https://api-asia.caagcrm.com/api-asia/
Authorization
To ensure secure communication between your application and our API, you must include an authorization token in the header of each API request. The token allows our system to verify the identity of the requestor and grant access to the requested resources.
To get the authorization token you will need the following tokens:
- Tenant Token: It's the token that identifies your company in the system. Can be found in Settings > Integrations > Api Token.
- User Token: It's the token that identifies the user with the API. It can be generated in Settings > Users by opening the user's details (clicking on the full name) and selecting 'Generate new token'.
To authenticate with the API you have to generate and send in the header of the request an Authentication Token. To generate the authentication token you have to encode in base 64 the Tenant Token and User Token as it follows:
generated_token = tenant_token:user_token
Authorization = Basic generated_token
You can encode it in base 64 on this website https://www.base64encode.org/
After getting your authentication token, include it in your request headers:
Authorization: Basic {AUTHENTICATION_TOKEN}
- Authorization: The key used to specify the authentication method.
- Basic: The type of token being used. In this case, "Basic" indicates that the token is a bearer token.
- {AUTHENTICATION_TOKEN}: Replace this placeholder with your actual authentication token, which you can generate or receive from our support team upon requesting API Access.
Example Request
curl -X GET "https://api-america-3.caagcrm.com/api/car-rental/reservations/{reservation_id}" \
-H "Authorization: Basic YOUR_ACTUAL_TOKEN"