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.1",
  "catalog_scope": "global",
  "source": "wordpress",
  "generated_at": "2026-04-09T14:27:42.378Z",
  "total_products": 61,
  "meta": {
    "constructor_notes": [
      "Панель может меняться (если для модели включены кастомные панели).",
      "Короб двери обычно фиксированный для модели.",
      "Фурнитура накладывается отдельным слоем изображения."
    ]
  },
  "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"
      ],
      "constructor": {
        "door_base_image": "https://sigma-doors.ru/wp-content/uploads/2026/01/door-full.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.panel_options[].eye_position всегда строка: center или side
• price_discount равен null, если фактической скидки нет
• общие примечания вынесены в meta.constructor_notes (не дублируются в каждом товаре)

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

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