POST /nextПолучить карточки
EVIR для разработчиков
Подключите EVIR к своему боту
За минуту проверьте ключ HTTP-запросом ping, затем вызовите next из готового Python- или Node.js-примера.
- HTTPS JSON API
- Один EVIR API key
- Подписанные webhooks
Три точки входа
Быстрый старт API
Готовые HTTP-примеры: POST /ping → POST /next → Telegram → действия по флагам ответа. Это пути API, а не команды Telegram.
НачатьAPI
Получение assignments, подтверждение отправки и обработка повторов.
Открыть APIWebhooks
События результатов, отписок, подпись запроса и безопасный bootstrap.
Открыть webhooksОсновные правила интеграции
Храните ключ только на сервере
Не вставляйте EVIR API key, токен Telegram или webhook secret в frontend и публичные ссылки.
Подтверждайте только факт
Вызывайте HTTP endpoint served только при requiresServedAck: true и после успешного ответа Telegram. При ошибке отправки не подтверждайте доставку.
Повторяйте безопасно
Повторяйте запрос для того же recipient и delivery. Не пересылайте карточку заново, если результат Telegram неизвестен.
Проверяйте подпись webhook
Сверяйте timestamp, digest и raw body до обработки события.
Что остаётся приватным
EVIR API key
Создаётся в карточке бота → «Подключение», показывается один раз и хранится только в секретах сервера.
Telegram token
Нужен EVIR только при добавлении бота и не попадает в документацию.
Webhook secret
Создаётся для конкретного endpoint и никогда не добавляется в общую документацию.
EVIR заберёт существующий Telegram webhook?
В режиме API — нет. В managed-режиме EVIR сначала читает текущее состояние и не перезаписывает чужой webhook без явного безопасного перехода.
Можно ли открыть документацию без Telegram?
Да. Все страницы документации доступны в обычном браузере без входа.
Что нужно для запросов API?
Только EVIR API key из раздела «Подключение». Передавайте его как Bearer-ключ с backend вашего бота.
Следующий шаг