Определение службы доставки
Список всех возможных служб доставки, к которым подходит формат заданного трек-номера. При определении службы доставки с Вашего лимита посылок по тарифу будет списана 1/5 часть посылки. Например, при добавлении 5 посылок с автоматическим определением службы доставки, Ваш лимит посылок по тарифу уменьшится на 6 посылок: 5 добавленных посылок + 1 посылка за 5 автоматических определений службы доставки.
Запрос:
GET /couriers/detect?trackNumber={trackNumber}
Обязательные GET-параметры запроса:
Параметр | Тип | Описание |
---|---|---|
trackNumber | String | трек-номер посылки |
Пример успешного ответа
В ответе будет возвращен массив объектов Courier
{
"code": 200,
"payload": [
{
"id": 1,
"name": "USPS",
"logo": "https://pkge.net/uploads/couriers/small/usps@2x.png",
"extra_fields": [],
"extra_fields_tip": null,
"website_link": "https://www.usps.com",
"slug": "usps"
},
{
"id": 7,
"name": "China Post",
"logo": "https://pkge.net/uploads/couriers/small/china-post@2x.png",
"extra_fields": [],
"extra_fields_tip": null,
"website_link": "http://english.chinapost.com.cn/",
"slug": "china-post"
},
//.....
]
}
Коды ошибочных ответов
Сопровождаются http-кодом состояния 400. Возможные значения:
Код | Описание |
---|---|
900 | Неверный формат трек-номера |
904 | Не удалось автоматически определить службу доставки для переданного трек-номера |
905 | Исчерпан лимит добавления посылок по тарифу за расчетный период |