Справочники витрины

Параметры запроса

• limit (integer, опционально) — ограничение числа элементов, от 1;
• parent_id (integer, опционально) — получить дочерние категории указанного узла.

Без parent_id backend возвращает корневые категории текущего Application.

Ответ

{
    "categories": [
        {
            "id": 12,
            "name": "Аксессуары",
            "photo": "https://api.gigma.ru/storage/uploads/category.jpg",
            "parent": null
        }
    ],
    "categoriesCount": 1
}

Параметры запроса

• limit (integer, опционально) — ограничение числа элементов, от 1.

Бренды текущего Application возвращаются по убыванию приоритета.

Ответ

{
    "brands": [
        {
            "id": 99,
            "name": "Бренд",
            "photo": null,
            "created_at": "2026-08-15T10:00:00+00:00"
        }
    ],
    "brandsCount": 1
}

Ответ

{
    "countries": [
        {
            "id": 1,
            "name": "Россия",
            "photo": null,
            "created_at": "2026-08-15T10:00:00+00:00"
        }
    ],
    "countriesCount": 1
}

Страны — системный справочник. Наличие страны в ответе не означает, что в текущей витрине есть товары с таким значением.

Ответ

{
    "deliveryTypes": [
        {
            "id": 1,
            "name": "Самовывоз",
            "price": "0.00",
            "is_active": 1
        },
        {
            "id": 2,
            "name": "Доставка",
            "price": "300.00",
            "is_active": 1
        }
    ],
    "deliveryTypesCount": 2
}

Показывайте клиенту только элементы с активным состоянием. Точный ID самовывоза или доставки получайте из ответа и конфигурации проекта, а не определяйте по названию примера.

Ответ

{
    "deliveryType": {
        "id": 2,
        "name": "Доставка",
        "price": "300.00",
        "is_active": 1
    }
}

Ответ

{
    "deliverySubtypes": [
        {
            "id": 2,
            "name": "Курьер",
            "price": "1000.00",
            "is_active": 1
        }
    ],
    "deliverySubtypesCount": 1
}

Ответ

{
    "deliverySubtype": {
        "id": 2,
        "name": "Курьер",
        "price": "1000.00",
        "is_active": 1
    }
}

Текущее ограничение runtime: controller не проверяет, что subtype_id действительно относится к type_id из path. Используйте ID только из списка подтипов выбранного способа доставки.

Параметры представляют дополнительные варианты подтипа, например конкретные пункты выдачи.

Ответ

{
    "deliverySubtypeParams": [
        {
            "id": 7,
            "name": "г Москва, ул Деловая, д 20"
        }
    ],
    "deliverySubtypeParamsCount": 1
}

Текущее ограничение runtime: type_id не сверяется с родителем subtype_id. Получайте подтип через предыдущий endpoint и не подставляйте несвязанные ID.

Ответ

{
    "paymentTypes": [
        {
            "id": 2,
            "photo": null,
            "name": "Онлайн",
            "description": "Оплата через платёжный сервис"
        }
    ],
    "paymentTypesCount": 1
}

Этот справочник выбирает тип оплаты обычного заказа. Сохранённые карты подписки получайте через GET /api/counterparty/payment-methods.

Ответ

{
    "shops": [
        {
            "id": 4,
            "photo": null,
            "name": "Центральный",
            "address": "г Москва, ул Деловая, д 20",
            "phone": "+79991234567",
            "schedule": "Пн–Пт, 10:00–18:00"
        }
    ],
    "shopsCount": 1
}

Список ограничен проектом, но не отдельным Application. Показывайте только магазины, которые бизнес разрешил для данного продукта.

Этот route не является карточкой магазина. Route model binding проверяет существование переданного shop ID, но controller игнорирует выбранный объект и возвращает первую глобальную страницу со slug shops-info.

Ответ

{
    "page": {
        "id": 103,
        "slug": "shops-info",
        "title": "Информация о магазинах",
        "content": "<p>Справочная информация</p>"
    }
}

Не используйте endpoint для получения адреса или проверки принадлежности магазина проекту. До исправления backend берите карточки только из GET /api/counterparty/shops.

Параметры запроса

• query (string, обязательно) — поисковая строка от 3 до 1024 символов.

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

{
    "query": "Деловая 20, Москва"
}

Ответ

{
    "addresses": [
        {
            "name": "г Москва, ул Деловая, д 20",
            "value": "115477, г Москва, ул Деловая, д 20"
        }
    ],
    "addressesCount": 1
}

Сохраняйте в заказе выбранное полное значение value, а name используйте как краткую подпись.

Слайды ограничены текущим Application.

Ответ

{
    "slides": [
        {
            "id": 1,
            "photo": "https://api.gigma.ru/storage/uploads/slide.jpg",
            "name": "Новая коллекция",
            "description": "Скидка на выбранные товары",
            "link": "/catalog"
        }
    ],
    "slidesCount": 1
}

Проверяйте link по allowlist маршрутов frontend перед переходом.

Параметры запроса

• include (string, опционально) — список через запятую: categories, brands, countries, tags, popular_requests.

Без include backend возвращает все пять наборов. Неизвестные значения игнорируются.

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

GET /api/counterparty/dictionaries?include=categories,brands,countries HTTP/1.1
Host: api.gigma.ru
Token: <application_token>
Accept: application/json

Ответ

{
    "dictionaries": {
        "categories": [],
        "brands": [],
        "countries": []
    }
}

• categories и brands ограничены текущим Application;
• countries — системный справочник;
• tags сейчас не ограничены приложением;
• popular_requests агрегируются без фильтра по проекту или приложению и не должны использоваться в tenant-facing интерфейсе до исправления backend.

Запрашивайте только нужные наборы: endpoint не кэширует область данных за вас.