Post2Go для бизнеса

Подключите наше отслеживание посылок к своему сайту: увеличьте лояльность пользователей, уменьшите количество возвратов и улучшите информированность о прохождении посылок.

Подробнее Тарифы Оставить заявку

Вебхуки

Сервис Post2Go предоставляет возможность уведомления клиентов об изменении состояния отправлений с помощью веб-хуков.

Web-hook URL

Перед началом использования веб-хуков, необходимо создать приложение в личном кабинете и указать для него url, по которому будут доставляться веб-хуки.

Принцип работы

В момент обновления состояния трекинг-номер, веб-хук попадает в очередь. С момента попадания веб-хука в очередь, сервис Post2Go пытается осуществить его доставку до тех пор, пока веб-хук не будет принят со стороны клиента.

Время ожидания веб-хука перед отправкой растет по экспаненте с каждой неудачной попыткой.

В качестве положительного ответа, означающего что веб-хук был принят, ожидается HTTP-код 200. Во всех остальных случаях веб-хук считается отклоненным и остается в очереди на отправку.

Метод отправки веб-хука: POST

Тело запроса веб-хука

Тело веб-хука содержит json объект состоящий из следующего набор полей:

  • tracking_number - отслеживаемый трекинг-номер;
  • courier_slug - уникальный идентификатор службы доставки, которая отправила посылку;
  • checkpoints - массив новых контрольных-точек. Контрольные точки, отправленные в предыдущих запросах, повторно не отправляются;

Объект контрольной-точки:

  • checkpoint_time - время прохождения посылки через контрольную точку;
  • status - статус посылки;
  • location - описание места положения контрольной точки;
  • zip_code - почтовый индекс места положения контрольной точки;
  • country_code - код страны места положения контрольной точки;
  • courier_slug - уникальный код службы осуществлявшей доставку на момент пребывания посылки в контрольной точке;
  • message - сообщение, описывающее статус посылки;
{
    "tracking_number": "RA539750882RU",
    "courier_slug": "russian-post",
    "checkpoints": [
        {
            "checkpoint_time": "2013-11-16 13:13:00", 
            "status": "import", 
            "location": "Москва PCI-1", 
            "zip_code": "104001", 
            "country_code": "RUS", 
            "courier_slug": "russian-post", 
            "message": "Импорт"
        }
    ]
}