Storefront API · Доставка

Пошук міст

GEThttps://{store}/api/v1/shipping/cities

Населені пункти з довідника перевізника за початком назви. До 30.

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

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

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

Код перевізника з методу «Перевізники».

qstring

Початок назви міста.

Відповіді

200Знайдені міста.

{
    "data": [
        {
            "ref": "8d5a980d-391c-11dd-90d9-001a92567626",
            "name": "Київ",
            "label": "Київ, Київська обл."
        }
    ]
}

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."
}