API-токены

Управление сервисными API-токенами — bearer-токенами для server-to-server интеграций (тот же способ авторизации, что и у примеров в этом справочнике). Создание токена заводит скрытый сервисный аккаунт с ролью admin в текущей компании; значение токена показывается только один раз, в ответе на создание. Удаление токена удаляет и сам сервисный аккаунт.

Эндпоинты

Метод	Путь	Описание
GET	`/v1/api-tokens` Список API-токенов	Список API-токенов
POST	`/v1/api-tokens` Создание API-токена	Создание API-токена
GET	`/v1/api-tokens/{id}` Получение API-токена	Получение API-токена
PUT	`/v1/api-tokens/{id}` Обновление названия/описания токена	Обновление названия/описания токена
DELETE	`/v1/api-tokens/{id}` Удаление API-токена (и сервисного аккаунта)	Удаление API-токена (и сервисного аккаунта)

Примеры

Создание API-токена

Запрос

bash

curl -X POST https://api.aisar.app/v1/api-tokens \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "n8n Integration",
    "description": "Server-to-server token for the n8n automation"
  }'

Ответ

json

{
  "data": {
    "id": 42,
    "name": "n8n Integration",
    "description": "Server-to-server token for the n8n automation",
    "created_at": "2026-03-15T10:00:00.000000Z",
    "token": "42|aBcDeFgHiJkLmNoPqRsTuVwXyZ0123456789abcdefg"
  }
}

Список токенов

Запрос

bash

curl https://api.aisar.app/v1/api-tokens \
  -H "Authorization: Bearer YOUR_API_TOKEN"

Ответ

json

{
  "data": [
    {
      "id": 42,
      "name": "n8n Integration",
      "description": "Server-to-server token for the n8n automation",
      "created_at": "2026-03-15T10:00:00.000000Z",
      "last_used_at": "2026-03-16T08:12:44.000000Z"
    }
  ]
}