Подключите наше отслеживание посылок к своему сайту: увеличьте лояльность пользователей, уменьшите количество возвратов и улучшите информированность о прохождении посылок.
Возвращает результаты отслеживания указанного трекинг-номера и службы доставки.
tracking_number
- трекинг-номер;courier_slug
- уникальный идентификатор службы доставки.{
"jsonrpc": "2.0",
"method": "getTrackingInfo",
"params": {
"tracking_number": "1234567890",
"courier_slug": "russian-post"
},
"id": 1
}
Объект result
содержит следующий набор полей:
tracking_number
- отслеживаемый трекинг-номер;courier_slug
- уникальный идентификатор службы доставки, которая отправила посылку;is_active
- флаг указывающий отслеживается ли трекинг-номер в данный момент или процесс отслеживания остановлен;is_delivered
- флаг, указывающий была ли посылка доставлена или все еще находится в пути;last_check
- дата последний проверки трекинг-номера сервисом Post2Go;checkpoints
- массив объектов контрольных точек, в которых находилась посылка на протяжении всего пути;title
- название посылки (может быть присвоение при добавлении и изменении трека).Объект контрольной точки:
time
- время прохождения посылки через контрольную точку;location
- оригинальное местоположение;location_ru
- перевод местоположения;zip_code
- почтовый индекс места положения контрольной точки;country_code
- код страны места положения контрольной точки;courier_slug
- уникальный код службы осуществлявшей доставку на момент пребывания посылки в контрольной точке;message
- сообщение, описывающее статус посылки;status
- статус посылки (Описание статусов). Возможные состояния: expired
, failed-attempt
, info-received
, in-transit
, out-for-delivery
, pending
, accepted
, delivered
, exception
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"tracking_number": "1234567890",
"courier_slug": "usps",
"is_active": false,
"is_delivered": true,
"last_check": "2014-07-06T10:38:46.000Z",
"title": "Посылочка",
"checkpoints": [
{
"time": "2014-03-17T20:00:00.000Z",
"location": null,
"location_ru": null,
"zip_code": null,
"country_code": "USA",
"courier_slug": "usps",
"message": "Electronic Shipping Info Received",
"status": "accepted"
},
{
"time": "2014-03-18T12:07:00.000Z",
"location": "PHILADELPHIA, PA 19176",
"location_ru": "Филадельфия, 19176",
"zip_code": null,
"country_code": "USA",
"courier_slug": "usps",
"message": "В пути",
"status": "in-transit"
},
{...},
{...},
{...},
{
"time": "2014-03-25T11:24:00.000Z",
"location": "CANADA",
"location_ru": "Канада",
"zip_code": null,
"country_code": "USA",
"courier_slug": "usps",
"message": "Посылка доставлена",
"status": "delivered"
}
]
}
}
Информация по указанному трекинг-номеру не найдена
{
"jsonrpc": "2.0",
"error":{
"code": 404,
"message": "Tracking not found"
},
"id": null
}
Попытка получить информацию о треке до постановки на отслеживание:
{
"jsonrpc": "2.0",
"error":{
"code": 403,
"message": "Access denied. You should addTracking to access this operation."
},
"id": null
}