Local tokens of integration channels (integration_tokens)

Table of Contents

Overview
Requests
- Checking token availability
See also

Overview

Allows you to verify the availability of an authorization token by running a query under any account that has access to the given account endpoint.

Tokens are automatically created when integration channels are added.

Tokens are validated within the domain in which the current API request is authorized.

Tokens are cached on the web server with an update interval of once every 5 minutes. If there is a request for a token that is not in the caches, the result is returned - it does not exist and the refresh procedure is started, but not more often than once every 15 seconds.

Requests

HTTP verb Endpoint Description

HTTP verb	Endpoint	Description
`GET`	`/rest/v1/service/integration_tokens/<token>`	Checking token availability

GET

/rest/v1/service/integration_tokens/<token>

Checking token availability

Request

Request example

GET /rest/v1/service/integration_tokens/a55c54b59ee6c8cfab2f83e33c2474d3 HTTP/1.1

Response

Example of a successful response

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8

{
  "domain": "test.rootdomain.ru",
  "integration_point": {
    "id": "c75f0231-016b-8f20-af65-1c1b0d69174c",
    "_links": {
      "self": {
        "href": "/rest/v1/service/integration_points/c75f0231-016b-8f20-af65-1c1b0d69174c"
      }
    }
  }
}

Example of an unsuccessful response

404 Not Found
Content-Type: application/json

{
  "error_code": 1404,
  "error_message": "Token not found"
}