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

Документация API

REST API для уведомлений через Telegram и Max. Подписчики, OTP, рассылки, формы, helpdesk.

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

Все запросы к API требуют Bearer-токен в заголовке Authorization.

Base URL: https://api.zapnoty.com
Content-Type: application/json для всех POST/PUT/PATCH запросов

Формат заголовка:

Authorization: Bearer zn_aBcDeFgHiJkLmNoPqRsTuVwXyZ123456

API-ключ имеет формат zn_ + 32 символа. Ключи создаются в дашборде проекта. Боевые ключи zn_live_ дают полный доступ — их может быть несколько (до 10 на проект), каждый создаётся и отзывается по отдельности. Тестовый ключ zn_test_ — только чтение (GET) и runtime-операции в sandbox (отправка, OTP, broadcast, simulate-event), изменять настройки проекта он не может (вернёт 403, см. раздел «Тестирование»). Виртуальные ключи zn_virt_ — ограниченные ключи для делегирования.

Временные ключи: при создании боевого ключа можно задать срок действия — быстрые пресеты (1 час, 3 часа, 12 часов, 24 часа, 2 дня, 3 дня) или произвольная дата. По наступлении даты ключ перестаёт аутентифицировать автоматически (401), без ручного отзыва. Удобно для CI, подрядчиков и разовых интеграций. Отзыв любого ключа действует немедленно и не затрагивает остальные ключи проекта.

Не передавайте ключ в URL или query-параметрах. Используйте только заголовок Authorization.

Связанные разделы

Быстрый старт
Первое сообщение за 2 минуты: получение ключа, deep link для подписки, отправка через curl.
POST /v1/send — отправка
Отправка персональных уведомлений: текст, HTML/Markdown, медиа, кнопки, шаблоны.
OTP — коды подтверждения
Генерация и проверка 6-значных кодов. Отдельный flow для пользователей без подписки.