URI | Method | Description |
---|---|---|
POST /trackings/post | POST | Создать элемент отслеживания |
GET /trackings/{carrier_code}/{tracking_number} | GET | Получить результаты отслеживания для конкретного отправления |
PUT /trackings/{carrier_code}/{tracking_number} | PUT | Обновить отслеживание |
DELETE /trackings/{carrier_code}/{tracking_number} | DELETE | Удалить отслеживание |
POST /trackings/batch | POST | Создать мульти-отслеживание |
GET /trackings/get | GET | Список всех отслеживаний |
POST /trackings/realtime | POST | Получить результаты отслеживания на настоящий момент для единичного отслеживания |
Пример
http://api.trackru.ru/v1/trackings/get?page=1&limit=25&created_at_min=1441314361&created_at_max=1446949161&lang=en
Content-Type: application/json
Api-Key: YOUR_API_KEY
Параметр | Описание | Значение по умолчанию |
---|---|---|
page (optional) | Страница отображения | 1 |
limit (optional)
|
Значений на странице (максимум 2000) | 100 |
status (optional) | Изменение статуса. Вы можете изменять значение статуса на 4, 7 или 8. 4 означает "Доставлено", 7 - "Исключение", 8 - возврат к оригинальному статусу посылки. this status | null |
created_at_min (optional) | Дата начала созданного отслеживания (формат: unix timestamp, например:1076599161) | null |
created_at_max (optional) | Дата окончания созданного отслеживания (формат: unix timestamp, например:1076570361) | now |
update_time_min (optional) | Дата начала обновленного отслеживания (формат: unix timestamp, например:1076599161) | null |
update_time_max (optional) | Дата окончания обновленного отслеживания (формат: unix timestamp, например:1076570361) | now |
order_created_time_min (optional) | Дата начала созданного заказа (формат: unix timestamp, например:1076599161) | null |
order_created_time_max (optional) | Дата окончания созданного отслеживания (формат: unix timestamp, например:1076570361) | now |
lang (optional)
|
Выбор языка (только в том случае, если официальный сайт службы доставки поддерживает данную функцию).. | null |
numbers (optional) | Трек-номер (max 40), номера должны быть разделены между собой ",".(Например: numbers=LX123445678CN,LX456789123CN) .(Example:numbers=LX123445678CN,LX456789123CN) | null |
orders (optional) | Номер заказа (max 40), номера заказа должны быть разделены между собой ",".(Например: orders=1234456,456789) .(Example:orders=1234456,456789) | null |
archived (optional) | Значение "true" указывает на учтенные номера, значение "false" - для не учтенных номеров, другие значения или обозначение "null" содержат смешанные номера. | null |
200
{
"meta": {
"code": 200,
"type": "Success",
"message": "Success"
},
"data": {
"page": 1,
"limit": 25,
"total": "56",
"items": [
{
"id": "009e9a8a6450cb5ce4b53ac75674fe78",
"tracking_number": "RR050349575PH",
"carrier_code": "phlpost",
"status": "delivered",
"created_at": "2015-10-30T11:35:16+08:00",
"updated_at": "2015-11-03T13:47:20+08:00",
"order_create_time": "2017-08-26 16:48",
"title": null,
"order_id": null,
"customer_name": null,
"customer_email": null,
"archived": false,
"original_country": "Philippines",
"destination_country": "United States",
"itemTimeLength": 12,
"service_code": null,
"origin_info": {
"weblink": "http:\/\/www.phlpost.gov.ph\/",
"phone": "+ (63) 854-9825",
"carrier_code": "phlpost",
"trackinfo": [{
"Date": "2015-10-25 15:01",
"StatusDescription": "Receive at country of destination",
"Details": "United States of America (the)"
}, {
"Date": "2015-10-22 16:35",
"StatusDescription": "Prepare dispatch to destination country",
"Details": "PHILIPPINES"
},
...
},
"destination_info": {
"weblink": "http:\/\/www.usps.com\/",
"phone": "1-800-275-8777",
"carrier_code": "usps",
"trackinfo": [{
"Date": "2015-11-02 17:11",
"StatusDescription": "Delivered",
"Details": "RENTON, WA 98056"
}, {
"Date": "2015-11-02 08:07",
"StatusDescription": "Arrived at Unit",
"Details": "RENTON, WA 98059"
}]
}
"lastEvent": "Delivered,RENTON, WA 98056,2015-11-02 17:11",
"lastUpdateTime": "2015-11-02 17:11"
},
{
"id": "e1e4baddad2b782d3aa3f6c75277ea22",
"tracking_number": "RN210552627LT",
"carrier_code": "lietuvos-pastas",
"status": "transit",
"created_at": "2015-10-30T10:52:41+08:00",
"updated_at": "2015-11-03T13:47:23+08:00",
"order_create_time": "2017-08-26 16:48",
"title": null,
"order_id": null,
"customer_name": null,
"customer_email": null,
"original_country": "Lithuania",
"destination_country": "Korea, South",
"itemTimeLength": null,
"origin_info": {
"weblink": "http:\/\/www.post.lt\/",
"phone": "(370) 8 700 55400",
"carrier_code": "lietuvos-pastas",
"trackinfo": [{
"Date": "2015-10-29 17:26",
"StatusDescription": "Departure from outward office of exchange",
"Details": "HK AMC"
}]
},
"destination_info": {
"weblink": "http:\/\/www.epost.go.kr\/",
"phone": "82-2-2108-9895",
"carrier_code": "korea-post",
"trackinfo": [{
"Date": "2015-10-29 17:26",
"StatusDescription": "Departure from outward office of exchange",
"Details": "HKHKGA,Dispatch number : KRSELB"
}]
}
"lastEvent": "Departure from outward office of exchange,HKHKGA,Dispatch number : KRSELB,2015-10-29 17:26",
"lastUpdateTime": "2015-10-29 17:26"
},
...
]
}
}