API Authentication

HTTP Basic Authentication

All requests sent to Connec!™ API use HTTP basic authentication. A set of API keys will be issued when your application is registered on Maestrano.
These credentials differ between the Staging and Production environments but are the same for all the requests sent to the API.

username: <your API key>
password: <your API token>

If you are using one of the Maestrano SDKs, this will automatically be handled for you.

Access to customer data

Access to customer data via the Connec!™ API is granted once the user adds your application to their dashboard. A group_id is then linked to their account and is given to you during the Single Sign On process. This group_id has to be stored against the user record so you can start sharing data with Connec!™ for this user account.

If the user deletes the application from their Maestrano dashboard, the access to their data is revoked. It may be re-enabled if the user adds your application again on their dashboard and trigger the SSO process. In that case, the group_id would be different and would have to be updated against the user record in your system.