ParcelTrack API

Отслеживание 

Менеджер ваших отслеживаний

URI Метод Описание
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 Получить результаты отслеживания на настоящий момент для единичного отслеживания

Список всех отслеживаний

https://api.parceltrack.ru/v1/trackings/get

Пример запроса

например

http://api.parceltrack.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
  • Tips

    GET /trackings/get API поддерживает один запрос за секунду.

Параметры

ParamDescriptionЗначение по умолчанию
page (optional)Страница отображения1
limit (optional)Значений на странице (максимум 2000)100
status (optional)Предметы в этот статус 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)End date and time of trackings updated.(format:The unix timestamp example: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)Номер дорожки (макс. 40), несколько номеров должны быть разделены знаком ','. (Пример: numbers = LX123445678CN, LX456789123CN) .(Example:numbers=LX123445678CN,LX456789123CN)null
orders (optional)Номер заказа (не более 40), несколько заказов должны быть разделены знаком ',' (пример: orders = 1234456,456789) .(Example:orders=1234456,456789)null
archived (optional)Строка true Получить номер архива, строка false Получить недокументированный номер, другое строковое значение или ноль Получить смешанный номер.null
  • Response Body 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"
            },
            ...
            ]
        }
    }