API для интернет-магазинов

Единый защищенный JSON API для выгрузки каталога дверей, актуальных цен и данных конструктора (панели, короб, фурнитура) для партнерских интернет-магазинов.

1) Базовая информация

• Endpoint: GET https://sigma-doors.ru/api/export/v1/json
• Формат: application/json
• Каталог: единый (global), без разделения по городам
• Доступ: только по токену

2) Авторизация

• Рекомендуется: Authorization: Bearer <TOKEN>
• Альтернатива: X-Export-Key: <TOKEN>

Пример запроса (Bearer)

curl -X GET "https://sigma-doors.ru/api/export/v1/json" \
  -H "Authorization: Bearer <TOKEN>"

Пример запроса (X-Export-Key)

curl -X GET "https://sigma-doors.ru/api/export/v1/json" \
  -H "X-Export-Key: <TOKEN>"

Пример запроса (JavaScript)

const res = await fetch("https://sigma-doors.ru/api/export/v1/json", {
  headers: {
    Authorization: "Bearer <TOKEN>"
  }
});

if (!res.ok) {
  throw new Error(`HTTP ${res.status}`);
}

const data = await res.json();
console.log(data.total_products);

3) Коды ответов

4) Пример ответа JSON

{
  "version": "1.4",
  "catalog_scope": "global",
  "source": "wordpress",
  "generated_at": "2026-04-09T14:27:42.378Z",
  "total_products": 61,
  "interior_finish_groups": [
    {
      "name": "Гладкие",
      "slug": "gladkie",
      "panels": [
        {
          "id": 501,
          "title": "Ral 9003",
          "slug": "ral-9003",
          "group_name": "Гладкие",
          "image": "https://sigma-doors.ru/wp-content/uploads/2026/01/panel-interior.jpg",
          "interior_image": "",
          "eye_position": "center",
          "color": "",
          "thickness": "16 мм",
          "cover": "Пленка ПВХ",
          "price_base": 0,
          "price_discount": null,
          "price_effective": 0,
          "discount_percent": 0
        }
      ]
    }
  ],
  "panel_catalog": [
    {
      "id": 301,
      "slug": "panel-line-white",
      "title": "Панель Line White",
      "acf": { "color": "Белый", "thickness": "16 мм" },
      "featured_images": { "full": "https://sigma-doors.ru/wp-content/uploads/2026/01/panel-line-white.jpg" }
    }
  ],
  "hardware_catalog": [
    {
      "id": 695,
      "slug": "prestige-hrom-kruglaya",
      "title": "Prestige хром круглая",
      "acf": { "price": 1500 },
      "featured_images": { "full": "https://sigma-doors.ru/wp-content/uploads/2026/01/hardware-preview.jpg" }
    }
  ],
  "meta": {
    "constructor_notes": [
      "У каждого товара есть полный acf (санитизированный), content_html и seo.",
      "В корне — interior_finish_groups, panel_catalog, hardware_catalog.",
      "Короб двери обычно фиксированный для модели; фурнитура — отдельный слой."
    ],
    "export_sanitizer": "Ключи вроде password/token/api_key вырезаются рекурсивно из acf и справочников."
  },
  "products": [
    {
      "id": 1234,
      "title": "Входная дверь Sigma Urban Grey",
      "slug": "vhodnaya-dver-sigma-urban-grey",
      "url": "https://sigma-doors.ru/product/vhodnaya-dver-sigma-urban-grey/",
      "price_base": 58900,
      "price_discount": 54900,
      "price_effective": 54900,
      "discount_percent": 7,
      "categories": ["vhodnye-dveri", "kvartirnye"],
      "series": ["sigma-prestige"],
      "features": ["shumoizolyaciya", "termo-razryv"],
      "images": {
        "medium": "https://sigma-doors.ru/wp-content/uploads/2026/01/door-medium.jpg",
        "full": "https://sigma-doors.ru/wp-content/uploads/2026/01/door-full.jpg",
        "all": [
          "https://sigma-doors.ru/wp-content/uploads/2026/01/door-full.jpg",
          "https://sigma-doors.ru/wp-content/uploads/2026/01/door-medium.jpg"
        ]
      },
      "gallery_links": [
        "https://sigma-doors.ru/wp-content/uploads/2026/01/door-gallery-1.jpg"
      ],
      "acf": {
        "is_visible": true,
        "series": [{ "slug": "sigma-prestige", "name": "Sigma Prestige" }]
      },
      "content_html": "<p>Описание модели…</p>",
      "seo": {
        "title": "…",
        "description": "…",
        "og_title": "",
        "og_description": "",
        "og_image": ""
      },
      "constructor": {
        "door_base_image": "https://sigma-doors.ru/wp-content/uploads/2026/01/door-full.jpg",
        "interior_image": "https://sigma-doors.ru/wp-content/uploads/2026/01/door-interior.jpg",
        "box_image": "https://sigma-doors.ru/wp-content/uploads/2026/01/box-black.png",
        "panel_mode": "custom",
        "default_panel_image": "https://sigma-doors.ru/wp-content/uploads/2026/01/door-full.jpg",
        "panel_options": [
          {
            "id": 301,
            "title": "Панель Line White",
            "slug": "panel-line-white",
            "image": "https://sigma-doors.ru/wp-content/uploads/2026/01/panel-line-white.jpg",
            "eye_position": "center",
            "price_base": 3500,
            "price_discount": null,
            "price_effective": 3500,
            "discount_percent": 0
          }
        ],
        "hardware_options": [
          {
            "id": 695,
            "title": "Prestige хром круглая",
            "slug": "prestige-hrom-kruglaya",
            "image_preview": "https://sigma-doors.ru/wp-content/uploads/2026/01/hardware-preview.jpg",
            "image_overlay": "https://sigma-doors.ru/wp-content/uploads/2026/01/hardware-overlay.png",
            "price": 1500
          }
        ]
      },
      "updated_at": "2026-04-09T13:41:12"
    }
  ]
}

5) Ключевые правила контракта

• constructor.interior_image — URL кадра «изнутри» (пустая строка, если в ACF не задано); партнёрский превью использует его в приоритете над панелями
• interior_finish_groups — общий каталог внутренних панелей по acf.panel_view (как на карточке товара на sigma-doors.ru)
• panel_catalog и hardware_catalog — полные справочники по id/slug с acf (после санитизации чувствительных ключей)
• у каждого товара: acf (полный ACF как в WP REST, санитизированный), content_html (рендер контента), seo из Yoast (yoast_head_json)
• если у двери нет custom_panels и нет своих interior_panels/interior_image, в constructor.interior_panel_options подставляется плоский список из каталога; тогда constructor.interior_panels_from_catalog: true
• constructor.panel_options[].eye_position всегда строка: center или side
• price_discount равен null, если фактической скидки нет
• общие примечания вынесены в meta.constructor_notes (не дублируются в каждом товаре)

6) Быстрый чек-лист подключения

• Токен получен у администратора
• Запрос с токеном возвращает 200
• В ответе присутствует products[]
• Цены берутся из price_effective
• Ошибки 401/403/429 обработаны в интеграции
• Настроено периодическое обновление каталога