Список сервисов с тегами (пример: mail:tag1+tag2*tag3,disk:tag1+tag2). Дополнительно см. фильтрация уведомлений.
Имя сервиса с тегами (пример: mail:tag1+tag2*tag3). Дополнительно см. фильтрация уведомлений.
Имя сервиса.
Список сервисов через запятую.
Произвольное название семейства клиентов.
Может содержать буквы, цифры, символы "-" и "_".
Строковый идентификатор экземпляра клиента (чтобы различать, например, две вкладки в браузере), может содержать буквы, цифры, "-", "_".
Список идентификаторов пользователей в формате [a-zA-Z0-9][a-zA-Z0-9@.-]*. Разделитель - запятая.
Идентификатор пользователя в формате [a-zA-Z0-9][a-zA-Z0-9@.-]*.
Идентификатор пользователя в формате [a-zA-Z0-9][a-zA-Z0-9:@.-]*. Обязательный параметр. Хранится вместе с подпиской и поможет нам удалить подписку после разлогина пользователя (если user - это паспортный uid).
Идентификатор пользователя в формате [a-zA-Z0-9][a-zA-Z0-9:@.-]*. Обязательный параметр. Используется при авторизации паспортной кукой и поможет нам удалить подписку после разлогина пользователя (если user - это паспортный uid).
Название топика в формате [a-zA-Z0-9][a-zA-Z0-9@.-]*.
UTS секретного ключа из ответа метода /v2/secret_sign.
при авторизации паспортной кукой не нужен
Секретный ключ из ответа метода /v2/secret_sign.
при авторизации паспортной кукой не нужен
UTS секретного ключа из ответа метода /v2/secret_sign.
при авторизации паспортной кукой не нужен
Секретный ключ из ответа метода /v2/secret_sign.
при авторизации паспортной кукой не нужен
Приложение с признаком is_yandex можно авторизовать OAuth-токеном с помощью стандартного заголовка Authorization: OAuth token. Скоупы не проверяются.
Мобильная платформа. Именуется по названиям пуш сервисов. Допустимые значения: apns, fcm, hms, mpns, wns.
Уникальный идентификатор инсталляции приложения. Может содержать буквы, цифры, символы "-" и "_".
Уникальный идентификатор мобильного устройства (например, device ID мобильной метрики).
необязательный параметр
Имя приложения, отображаемое в разделе Сервисы.
В зависимости от платформы передайте device token (apns), registration id (fcm) или channel URI (mpns, wns).
Правила фильтрации. Позволяют получать не все уведомления - см. фильтрация уведомлений.
необязательный параметр
Произвольная информация.
необязательный параметр
HTTP URL для обратного вызова.
Короткий заголовок уведомления - "что произошло". Полезен для статистики.
Время в секундах, в течение которого уведомление актуально.
необязательный
id подписки, для которой предназначено сообщение - см. фильтрация подписок.
необязательный
session подписки, для которой предназначено сообщение - см. фильтрация подписок.
необязательный
uuid подписки, для которой предназначено сообщение - см. фильтрация подписок.
необязательный
Подписка Web Push в формате JSON, которую выдает push manager в браузере.
Время жизни подписки в часах.
необязательный параметр
Тело уведомления - JSON объект или произвольный текст. При отправке на мобильные устройства преобразуется по определённым правилам.
Правила переупаковки данных из payload, см. переупаковка уведомлений.
необязательный
Теги для простой фильтрации уведомлений, см. фильтрация уведомлений.
необязательный
Ключи, которые можно использовать в сложных фильтрах подписки, см. фильтрация уведомлений.
необязательный
Массив идентификаторов экспериментов в формате [a-zA-Z0-9]+-[0-9]+.
необязательный
Условия отправки в подписку, см. фильтрация подписок.
необязательный
Условия отправки в подписку, см. фильтрация подписок. Поддерживаются platform и transport.
необязательный
Массив получателей.
X-Ya-Service-Ticket: publisher service-тикет
X-Ya-Service-Ticket: subscriber service-тикет
X-Ya-Service-Ticket: publisher или subscriber service-тикет
Authorization: OAuth token
СтатусСообщениеОписание
200OKЗапрос выполнен успешно.
400BadRequest или описание ошибкиОшибка в запросе.
401UnauthorizedНекорректный или устаревший токен.
405MethodNotAllowedНекорректный метод HTTP запроса.
429TooManyRequestsКлиент шлет слишком много запросов.
500InternalServerErrorВнутренняя ошибка или рестарт сервера.
Получить уведомления из истории за время отсутствия. Передайте в любом порядке список комбинаций usertopic:service:position:count, разделенных запятыми. Здесь position - номер последнего полученного уведомления, count - максимальное количество уведомлений, которое вы хотите принять (не более 100).
необязательный
Идентификатор подписки.