Storefront API · Доставка

Пошук відділень і поштоматів

GEThttps://{store}/api/v1/shipping/delivery-points

Відділення чи поштомати перевізника в місті — за номером або вулицею.

Токен кошика з POST /carts: X-Cart-Token: {token}.

Параметри запиту

carrierstringобов'язковий

Код перевізника.

city_refstringобов'язковий

ref міста з пошуку міст.

typestringобов'язковий

Сервіс: branch або parcel_locker.

branchparcel_locker

qstring

Номер або частина адреси.

limitinteger

Від 1 до 40. За замовчуванням 30.

Відповіді

200Знайдені відділення.

{
    "data": [
        {
            "ref": "1ec09d88-e1c2-11e3-8c4a-0050568002cf",
            "name": "Відділення №12",
            "number": "12",
            "type": "branch",
            "city_ref": "8d5a980d-391c-11dd-90d9-001a92567626",
            "address": "вул. Князів Острозьких, 32/2",
            "postcode": "01010"
        }
    ]
}

401Немає X-Cart-Token, токен прострочений або кошик уже оформлено.

{
    "message": "A valid X-Cart-Token header is required.",
    "errors": {
        "cart_token": [
            "Кошик не знайдено, строк доступу минув або його вже оформлено."
        ]
    }
}

429Забагато запитів (створення кошика 20/хв з IP, запити кошика 120/хв, оформлення 10/хв).

{
    "message": "Too Many Attempts."
}

{ "data": [ { "ref": "1ec09d88-e1c2-11e3-8c4a-0050568002cf", "name": "Відділення №12", "number": "12", "type": "branch", "city_ref": "8d5a980d-391c-11dd-90d9-001a92567626", "address": "вул. Князів Острозьких, 32/2", "postcode": "01010" } ] }