Имя сервиса.
Список сервисов через запятую.
Произвольное название семейства клиентов.
Может содержать буквы, цифры, символы "-" и "_".
Строковый идентификатор экземпляра клиента (чтобы различать, например, две вкладки в браузере), может содержать буквы, цифры, "-", "_".
Список идентификаторов пользователей в формате [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 для обратного вызова.
Короткий заголовок уведомления - "что произошло". Полезен для статистики.
Время в секундах, в течение которого уведомление актуально.
необязательный
session подписки, для которой предназначено сообщение - см.
фильтрация подписок.
необязательный
Подписка Web Push в формате JSON, которую выдает push manager в браузере.
Время жизни подписки в часах.
необязательный параметр
Тело уведомления - JSON объект или произвольный текст.
При отправке на мобильные устройства преобразуется по определённым
правилам.
Массив идентификаторов экспериментов в формате [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
Статус | Сообщение | Описание |
200 | OK | Запрос выполнен успешно. |
400 | BadRequest или описание ошибки | Ошибка в запросе. |
401 | Unauthorized | Некорректный или устаревший токен. |
405 | MethodNotAllowed | Некорректный метод HTTP запроса. |
429 | TooManyRequests | Клиент шлет слишком много запросов. |
500 | InternalServerError | Внутренняя ошибка или рестарт сервера. |
Получить уведомления из истории за время отсутствия. Передайте в любом порядке список комбинаций
usertopic:service:position:count, разделенных запятыми. Здесь position - номер последнего
полученного уведомления, count - максимальное количество уведомлений,
которое вы хотите принять (не более 100).
необязательный
Идентификатор подписки.