Shopify App

Определение службы доставки

Список всех возможных служб доставки, к которым подходит формат заданного трек-номера. При определении службы доставки с Вашего лимита посылок по тарифу будет списана 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 Исчерпан лимит добавления посылок по тарифу за расчетный период