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

Регистрация событий

Существует две схемы регистрации событий доставки и открытия push сообщения в Altcraft MP:

  1. Напрямую от приложения.
  2. Через промежуточный сервис.

Регистрация событий напрямую от приложения

По умолчанию при отправке push сообщения в полезных данных отправляется объект hub_link

{
"hub_link" : {
"ack" : "http://your.domain.com/api/v1.1/pushes/crypto_post_events?/2ab9162159..." ,
"open" : "http://your.domain.com/api/v1.1/pushes/crypto_post_events?/555fbe0b9..."
}
}

Приложение должно выполнить GET запрос по ссылкам ack и open, для регистрации доставки и открытия пуша соответственно.

Регистрация событий через промежуточный сервис

предупреждение

Этот способ требует наличия Extra UID в пользовательских данных push сообщения (настраивается по запросу)

Приложение сообщает промежуточному сервису факт события с передачей последнему Extra UID из пуша.

Шлюз должен передать через API это событие в Altcraft Platform.

URL-адрес

Метод: POST

https://example.com/api/v1.1/pushes/post_events

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

ПараметрТипПримерОбязательныйОписание
tokenstring"abcdefghijklmnqrstuvwxyz"ДаAPI токен
eventsint1 - доставлен
2 - открыт
3 - доставлен и открыт
ДаСобытия
uidstring"uid"ДаПриходит вместе с push сообщением от Altcraft в Data payload.

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

{
"token" : "abcdefghijklmnqrstuvwxyz" ,
"events" : 1,
"uid" : "e|2_4S_4HFn8RDhhmA|w4HFn8RPDFUi_2_4S_S_3___6.2NvyN8Hb67wmzJshM_6BuFTt|ios-apns"
}

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

{
"error" : 0,
"error_text" : "Successful operation"
}

Возвращаемые параметры

ПараметрТипОписание
errorintКод ошибки
error_textstringТекст ошибки