Authorization
All global platform API require an authorization token to work. The authorization token, once obtained, contains all of the information required for subsequent calls to be completed.
The <SERVICE ENDPOINT> value mentioned in all API calls refers to the route assigned to your bot. Make sure to retrieve the correct route of your bot that you can find under the Settings > Developers section of your bot details.
If you are generating an authorization token for a channel service (e.g. Custom Channel), the token must be requested from the service endpoint and not from the general API route one.
Account wide Token Request
Using your account API Key, that can be found under your Profile section in your account details, you can require an Authorization token using the following request:
An authorization token grants access to all of the API methods for about 60 minutes. When the authorization token expires, a new authorization token must be requested by repeating the very same request.
Bot Level Token Request
Some API endpoints, such as Connect Database API Interface will require a token related to a very specific chatbot. To create such token the authorization request must contain the bot API Token and Secret like in the example below:
You can find both bot API Key and bot API Secrets under the Developers section of the settings top menu of your bot details.
Response
If the request is successful, Connect will reply with an authorization token that may look like this:
The expire information indicates for how many minutes the token is valid.
Response Codes
This endpoint will reply with the following standard HTTP codes.
Last updated