Регистрация событий
Существует две схемы регистрации событий доставки и открытия push сообщения в Altcraft MP:
- Напрямую от приложения.
- Через промежуточный сервис.
Регистрация событий напрямую от приложения
По умолчанию при отправке 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
Параметры запроса
Параметр | Тип | Пример | Обязательный | Описание |
---|---|---|---|---|
token | string | "abcdefghijklmnqrstuvwxyz" | Да | API токен |
events | int | 1 - доставлен 2 - открыт 3 - доставлен и открыт | Да | События |
uid | string | "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"
}
Возвращаемые параметры
Параметр | Тип | Описание |
---|---|---|
error | int | Код ошибки |
error_text | string | Текст ошибки |