Trackru API

По любым возникшим вопросам, касающимся Апи интеграции, пишите на нашу почту: [email protected]

Trackings 

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

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

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

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

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

Пример

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
  • Примечание

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

Параметры

ПараметрОписаниеЗначение по умолчанию
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"
            },
            ...
            ]
        }
    }