Всё важное из ваших систем — в одном местеПодключить команду
аэрограмРегистрация
Главная / Для разработчиков

Ваше событие.
Наш маршрут.

Для backend-сервисов используйте актуальный REST API. Для 1С и локальных систем установите Аэрограм Connector: приложение открывает только локальный API на 127.0.0.1:8788 и само устанавливает исходящее защищённое WSS-соединение. Публичный входящий порт компании не требуется.

REST API / CONNECTOR / 1С УТ11

Два пути подключения

Публичные ID копируются из раздела «Подключение SDK». Секреты не вставляйте в код и скриншоты. Перед запуском примеров задайте переменные окружения в своей системе.
HTTPS → ОБЛАКО

Backend → Аэрограм

Отправляйте события по HTTPS с отдельным ключом сервиса. SERVICE_ID и CATEGORY_ID должны принадлежать вашему рабочему пространству, а RECIPIENT_KEY — получателю с доступом к категории.

  1. Создайте сервис и категорию в кабинете.
  2. Выдайте серверу ключ сервиса и сохраните его в переменной SERVICE_API_KEY.
  3. Подставьте ID сервиса в URL, ключ категории и получателя в тело запроса.
Тестовый запрос · cURL
curl -X POST "https://api.xn--80aai1bhlc4h.xn--p1ai/v1/services/$SERVICE_ID/notifications" \
  -H "Authorization: Bearer $SERVICE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"categoryId":"CATEGORY_ID","recipient":"RECIPIENT_KEY","channel":"push","title":"Тест","body":"Проверка подключения","priority":"normal","idempotencyKey":"test-001"}'

Подставьте собственные ID и переменные окружения.

LOCAL API → WSS → ОБЛАКО

1С/локальная система → Connector

Получите пакет Connector в кабинете, раздел «Подключение SDK». Для Linux распакуйте дистрибутив и запустите deploy/install-linux.sh; в Windows разместите EXE и connector.env рядом. Отправляйте локальные запросы на том же сервере, где установлен Connector.

  1. В connector.env задайте AEROGRAM_CLOUD_URL=https://api.xn--80aai1bhlc4h.xn--p1ai, CONNECTOR_ID и CONNECTOR_SECRET из кабинета.
  2. Создайте отдельный случайный LOCAL_API_TOKEN длиной не менее 32 символов, например openssl rand -hex 32. Секрет Connector и локальный токен должны отличаться.
  3. Запустите Connector как службу, разрешите исходящий TCP 443. Проверьте GET http://127.0.0.1:8788/health: ожидается {"status":"ok"}.
  4. В настройках расширения 1С УТ11 укажите локальный Connector, токен и сервис; настройте категории событий и разрешённых получателей.
Тестовый запрос · cURL
curl -X POST http://127.0.0.1:8788/v1/notifications \
  -H "Authorization: Bearer $LOCAL_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"serviceId":"SERVICE_ID","categoryId":"CATEGORY_ID","recipient":"RECIPIENT_KEY","channel":"push","title":"Тест","body":"Проверка подключения","priority":"normal","idempotencyKey":"test-001"}'

Подставьте собственные ID и переменные окружения.

Примеры сверены с реализацией 21 октября 2026 года.

КОНТРАКТ ЗАПРОСА

Что передавать в API

serviceId

В Connector — публичный ID сервиса в JSON. Для прямого REST API — ID сервиса в URL.

categoryId

Ключ категории, доступной сервису и получателю.

recipient / groupId

Ключ получателя или ID группы. Указывайте только одно из двух полей.

channel

Для текущей доставки используйте push. Email, Telegram и MAX — в разработке.

title / body

Заголовок и текст уведомления.

priority

normal или important. Важный приоритет не обходит системный режим «Не беспокоить».

idempotencyKey

Один ключ для повторных попыток отправки одного события, новый — для нового события.

НАДЁЖНОЕ ПОДКЛЮЧЕНИЕ

Заложено в интеграцию

01 /

Токены и роли

Используйте отдельные ключи для сервисов и локальный токен Connector. Выдавайте получателям доступ к нужным категориям.

02 /

Статусы и аудит

Проверяйте доставку и прочтение в кабинете и журнале. Callback/webhook-интеграция — в разработке.

03 /

Идемпотентность

Повтор запроса с тем же ключом не создаёт новое уведомление. Успешный приём в очередь ещё не означает доставку на устройство.

НАСТРОЙКА

Всё начинается в кабинете

Подключение SDK в Аэрограм: статус Connector, Windows amd64 и публичный каталог интеграций 1С УТ11
Подключение Connector и каталог интеграций. ID подключения и IP-адрес скрыты.
НАЧНЁМ С ВАШЕГО СЦЕНАРИЯ

Важное должно
долетать.

Подключите компанию или обсудите интеграцию с командой Аэрограм.

Подключить командуЗадать вопрос
1 / 0
Загрузка…