Transmit integrator.io API tokens

Bearer Tokens

Every Integrator account is provisioned with one API token. API clients should transmit this token using the Authorization request header field and the Bearer authentication scheme.

Sample HTTP Request:

GET /v1/tokenInfo HTTP/1.1
Host: api.integrator.io
Authorization: Bearer my_api_token

Sample Response:

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
{
  "_userId": "5e03061cda20740022300f09",
  "scope":"*"
}

One-time tokens

Integrator.io also passes one-time tokens to backend components implementing hooks, wrappers, installer, uninstaller, or settings interfaces. Integrator.io passes these tokens in the options argument of each function, and they can be used to call back into integrator.io. One-time tokens automatically expire after use (via a return statement, or after a 15 minute timeout). For integration apps managed by a partner, passed tokens are only granted access to invoke resources belonging to the integration app itself (determined via the _connectorId property). For hooks and wrappers that do not belong to an integration app, one-time tokens can only invoke exports and imports already defined in the Celigo account.