Аутентификация

Разрешения и доступ к проектам

Персональный API-токен принадлежит вашему аккаунту и использует ваши текущие права на проекты. Токен с chat:write может запускать те же действия агента и расход кредитов, что и ваше сообщение в Amazi, включая доступ к другим разрешённым вам проектам. Токен не ограничен одним проектом.

Создание и управление токенами

Для POST /auth/api-tokens, GET /auth/api-tokens и DELETE /auth/api-tokens/{tokenId} используйте сессию своего аккаунта. API-токены не позволяют управлять другими токенами. При входе по паролю POST /auth/token с JSON-полями email и password возвращает токен сессии; передавайте его как Authorization: Bearer для управления API-токенами. Браузерная сессия может использовать cookie с разрешённого адреса Amazi.

Передайте имя, одно или оба разрешения (chat:read, chat:write) и expiresAt в формате ISO UTC в пределах следующих 365 дней:

{"name":"My automation","scopes":["chat:read","chat:write"],"expiresAt":"2026-12-01T00:00:00.000Z"}

При выполнении запроса выберите будущую дату. Ответ HTTP 201 содержит token — секрет, который показывается один раз, — и item с ID, именем, префиксом, разрешениями и датами. Сохраните token в хранилище секретов сервера. Список возвращает items без секретов. Удаление по item.id отзывает токен и возвращает HTTP 204. Аккаунт может иметь до 20 действующих неотозванных токенов. Пока управление доступно через API, без отдельного экрана настроек.

Авторизация запросов

Передавайте Authorization: Bearer amz_api_... в запросах к чатам проектов по HTTPS. Токены сессии и cookies для этих операций с чатами не принимаются. Не размещайте API-токены в браузерном коде, URL или логах. Выход из аккаунта не отзывает персональные API-токены. Отзыв запрещает будущие запросы, но не отменяет уже принятую работу.

Лимиты и ошибки

Один токен допускает 60 запросов в минуту. HTTP 429 содержит Retry-After в секундах. HTTP 400 означает неверные данные, 401 — неверный, истёкший или отозванный токен, 403 — недостаточные разрешения, 404 — недоступный проект или чат, 409 — конфликт, например отправку в архивный чат. Причина указана в сообщении ошибки. Эти эндпоинты предназначены для серверных интеграций и не наследуют браузерную CORS-политику анонимного каталога.