Amazi API
Обзор
Подключите свой сервер или автоматизацию к Amazi через API v1.
Базовый адрес
Базовый адрес Amazi API — https://dev-api.amazi.pro/v1. Используйте HTTPS. В справочниках приведены полные пути, например /v1/plans; добавляйте их к https://dev-api.amazi.pro без префикса /api и повторного /v1.
Интерактивный справочник
Откройте справочник API v1, чтобы посмотреть эндпоинты, параметры и схемы ответов, или скачайте OpenAPI JSON. Оба адреса доступны без входа и содержат только внешний API /v1.
Для проверки запросов к чатам проектов выберите Authorize → userApiTokenBearer и введите персональный API-токен. Для чтения публичных данных токен не нужен. Try it out отправляет настоящие запросы: создание чатов и отправка сообщений изменяют проект и могут расходовать кредиты. Swagger хранит токен только до перезагрузки страницы.
Выберите ресурс
| Руководство | Возможности | Аутентификация |
|---|---|---|
| Аутентификация | Создание и отзыв персональных API-токенов | Управление токенами через сессию аккаунта |
| Чаты проектов | Просмотр, создание, переименование, архивирование и восстановление чатов; чтение и отправка сообщений | Персональный API-токен |
| Публичные данные | Получение тарифов, правовых документов, баннеров и анкеты | Не требуется |
В запросах к чатам действуют текущие права аккаунта и обычные правила расхода кредитов. Отправка сообщения возвращает ответ после приёма; результат доступен в очереди и истории чата.
Первый запрос
Получите каталог тарифов без токена:
curl --fail --silent --show-error https://dev-api.amazi.pro/v1/plans -H 'Accept-Language: ru'
Чтобы отправить сообщение, сначала создайте токен, затем используйте пример для чатов проектов. Управление токенами использует /auth/api-tokens на домене API, вне /v1.
Доступность и повторные запросы
Во время обновления API Amazi запросы могут возвращать HTTP 503 с кодом SYSTEM_MAINTENANCE и заголовком Retry-After в секундах. Дождитесь повторной попытки; при повторной отправке сообщения сохраняйте прежний ключ повтора. Адреса опубликованных проектов остаются доступны, но функции проектов, обращающиеся к API Amazi, тоже могут потребовать ожидания.
Прежние URL каталогов /public/... перенесены на /v1/... и возвращают HTTP 404. Используйте пути из раздела Публичные данные.
О сервисах, подключённых внутри проекта, читайте в руководствах Интеграции и окружение, Синхронизация GitHub и Amazi AI Gateway.