PD Документация ← На главную

Начало работы

PushData — облачный сервис уведомлений: push (iOS, Android, браузер), e-mail, SMS, Telegram, MAX и in-app-сообщения через один API и одну панель. Устанавливать ничего не нужно — серверы и данные находятся в России (152-ФЗ).

Адреса

ЧтоАдрес
Панельhttps://app.pushdata.ru
REST APIhttps://api.pushdata.ru/api/v1
GraphQLhttps://api.pushdata.ru/api/graphql

Быстрый старт

1. Войдите в панель

Откройте app.pushdata.ru и войдите по коду, который придёт на e-mail, либо через VK ID или Яндекс ID. При первом входе создаётся аккаунт и организация на тарифе Free — 1 приложение, 1 000 устройств и 5 000 отправок в месяц. Коллег приглашайте в разделе Команда.

2. Создайте приложение

В разделе Приложения создайте приложение. У каждого приложения свои ключи:

  • секретный pd_… — для вашего бэкенда (REST и GraphQL), показывается один раз при создании;
  • публичный pk_… — для SDK в мобильном приложении и браузере.

3. Настройте доставку

  • Push — в Приложение → Push-провайдеры загрузите ключ APNs (.p8), JSON сервисного аккаунта FCM и сгенерируйте ключи VAPID для браузеров.
  • Остальные каналы — в Приложение → Каналы добавьте SMTP или Resend, SMS.ru или SMSC, Telegram-бота, MAX-бота или In-App и нажмите «Проверить связь».

4. Подключите SDK

Мобильный или веб-SDK регистрирует устройство по публичному ключу и передаёт отметки о доставке и открытии. Пошаговая настройка каждой платформы — в разделе SDK и примеры.

5. Отправьте первое уведомление

Из панели — Отправить уведомление, или из кода:

bash
curl -X POST https://api.pushdata.ru/api/v1/notifications \
  -H "Authorization: ApiKey pd_ВАШ_СЕКРЕТНЫЙ_КЛЮЧ" \
  -H "Content-Type: application/json" \
  -d '{"title":"Привет","body":"Первое уведомление из PushData","target":{"all":true}}'

Так уходит push. E-mail, SMS, MAX и in-app — тот же вызов с channel_type ("channel_type":"email", адресаты — контакты: target.user_ids или all), Telegram — в чат канала; подробно — Уведомления. Статус доставки виден в Приложение → Уведомления: что провайдер принял, что отклонил и почему.

6. Дальше

  • Контакты — идентичность пользователей (externalId, e-mail, телефон), настройки по категориям и каналам.
  • Шаблоны — тема и текст с переменными {{ name }}, общие для каналов.
  • Сценарии — триггер из вашего бэкенда → задержка → фильтр → отправка, без деплоя.
  • Вебхуки — события доставки на ваш сервер с HMAC-подписью.

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

Секретный ключ приложения передаётся в заголовке Authorization: ApiKey pd_…. Подробности, области действия ключей и подпись идентичности — на странице Аутентификация.