Перейти к основному содержимому

Трансляция пуш-сообщений

Попробуйте в Swagger

Трансляция пуш-сообщений (broadcast)

Массовая отправка пуш-сообщений.

Формат запроса

POST https://pub.multipushed.ru/v2/broadcast-publish

Тело запроса

{
"ttl": <time_to_live>,
"groupId": <group_id>,
"payload": "My push",
"geoLocationInfo": {
"region": "Moscow"
},
"cascadeToSms": true,
"sms": {
"body": null
},
"apns": {
"alert": {
"title": null,
"subtitle": null,
"body": null,
"launch-image": null,
"title-loc-key": null,
"title-loc-args": null,
"subtitle-loc-key": null,
"subtitle-loc-args": null,
"loc-key": null,
"loc-args": null
},
"badge": null,
"sound": {
"critical": null,
"name": null,
"volume": null
},
"thread-id": null,
"category": null,
"content-available": 1,
"mutable-available": null,
"target-content-id": null,
"interruption-level": null,
"relevance-score": null,
"filter-criteria": null,
"stale-date": null,
"timestamp": null,
"event": null,
"dismissal-date": null,
"attributes-type": null
}
}

Параметры тела запроса

ttlВремя жизни сообщения в секундах (По умолчанию 24 часа)Необязательное поле
payloadТело сообщения (До клиента будет доставлено в том виде, в котором передано)Обязательное поле
cascadeToSmsВключение каскада на СМС, по умолчанию trueНеобязательное поле
sms.bodyНастройка тела сообщения, используемого при отправке SMS, если не задано, будет использован Payload пушаНеобязательное поле
groupIdИдентификатор группы (Если поле не задано, то отправка будет производиться по всем устройствам приложения)Необязательное поле
geoLocationInfoРегион, для которого будет совершена отправка. Должен соответствовать ISO 3166 или ISO 3166 для российских регионов. (для отправки необходимо использовать Subdivision name (en))Необязательное поле
apnsНастройки для отправки через APNsНеобязательное поле

Пример запроса

curl -v -X POST https://pub.multipushed.ru/v2/broadcast-publish
-H 'Content-Type: application/json'
-H 'Authorization: Bearer <accessToken>'
-d '{"payload": "My payload", "cascadeToSms": true, "sms": {"body": "Sms payload"}}'

Пример ответа

{
"success": true/false,
"errCode": int/null,
"message": string/null,
"model": string/null
}
successрезультат выполнения запроса
errCodeкод ошибки, будет заполнено в случае ошибки
messageтекстовое описание ошибки, будет заполнено в случае ошибки
modelID рассылки (BroadcastTaskId)

Статус массовой отправки пуш-сообщений

Показывает какое количество пуш-сообщений из массовой отправки было доставлено\не доставлено

Формат запроса

POST https://api.pushed.ru/v2/info/broadcast-task

Тело запроса

{
"broadcastTaskId": null
}'

Параметры тела запроса

broadcastTaskIdID отправки, полученный в ответ на отправку через broadcastОбязательное поле

Пример запроса

curl -v -X POST https://api.pushed.ru/v2/info/broadcast-task \
-H 'Content-Type: application/json'
-H 'Authorization: Bearer <accessToken>'
-d '{"broadcastTaskId": <Ваш ID>}'

Пример ответа

{
"model": "6810c0813a1eecf20db08cae",
"success": true,
"message": null,
"errCode": null
}