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

Существует две схемы регистрации событий доставки и открытия 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

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

Параметр	Тип	Пример	Обязательный	Описание
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	Текст ошибки