Система обновлений в режиме реального времени

API сервиса «Моя посылка» поддерживает функцию webhook, которая позволяет сторонним приложениям подписаться на уведомления об изменении определенных данных и получать их в режиме реального времени.

На данный момент функция webhook оповещает о следующих событиях:

  • наступление новых статусов при отслеживании трек-номера;
  • добавление трек-номера на отслеживание;
  • удаление трек-номера с отслеживания;
  • пометка о доставке трек-номера;
  • снятие пометки о доставке трек-номера.

В каждом из представленных событий сервис «Моя посылка» формирует специальный объект данных в формате json и отправляет методом POST в теле запроса на заранее сохраненный URL-адрес обратного вызова вашего приложения.

Структура объектов данных

В случае изменения определенных данных сервис «Моя посылка» формирует json структуру по каждому типу события следующего вида:

Новые статусы отслеживаемого трек-номера
{
  "newEvents": [Tracker]
}
Добавление трек-номера на отслеживание
{
  "addTracker": [Tracker]
}
Удаление трек-номера с отслеживания
{
  "deleteTracker": {
    "barcode": "...",
    "carrier": "..."
  }
}
Пометка о доставке трек-номера
{
  "trackerDelivered": {
    "barcode": "...",
    "carrier": "..."
  }
}
Снятие пометки о доставке трек-номера
{
  "trackerUndelivered": {
    "barcode": "...",
    "carrier": "..."
  }
}

где:

  • [Tracker] - структура объекта используемой приложением версии API;
  • barcode - трек-номер отслеживания;
  • carrier - код почтовой службы;