Імпорт категорій

Цей ендпоінт дозволяє створювати нові категорії або оновлювати існуючі у вашому каталозі. Категорії ідентифікуються за унікальним source_category_id, який ви надаєте.

Ендпоінт

POST https://smartsearch.spefix.com/api/v2/content/category/bulk/

Аутентифікація

Всі запити повинні містити заголовок X-Secret-Token. Деталі — в розділі Огляд API імпорту.

Формат запиту

Надішліть у тілі запиту масив об’єктів категорій у форматі JSON:

[
  {
    "source_category_id": 123,
    "translations": [
      {
        "language": "uk",
        "name": "Електроніка",
        "url": "https://example.com/uk/electronics",
        "synonyms": ["Техніка", "Гаджети"],
        "keywords": ["телефон", "ноутбук", "планшет"]
      },
      {
        "language": "en",
        "name": "Electronics",
        "url": "https://example.com/electronics",
        "synonyms": ["Tech", "Gadgets"],
        "keywords": ["phone", "laptop"]
      }
    ]
  }
]

Опис полів

Поле	Тип	Обов'язкове	Опис
source_category_id	integer	Так	Унікальний ідентифікатор категорії у вашій системі
translations	array	Так	Масив перекладів; мінімум один елемент
translations[].language	string	Так	Код мови (наприклад, "uk", "en")
translations[].name	string	Так	Назва категорії вказаною мовою
translations[].url	string	Ні	Абсолютний URL (починається з http:// або https://)
translations[].synonyms	array	Ні	Альтернативні назви категорії
translations[].keywords	array	Ні	Список ключових слів для пошуку

Правила аалідації

• source_category_id повинен бути позитивним цілим числом
• Потрібен принаймні один переклад (translations) для кожної категорії.
• Не дозволяються дублікати кодів мов (language) в масиві translations для однієї категорії.
• Поле url (якщо вказано) повинно починатися з http:// або https://.
• synonyms і keywords — це масиви строк.

---

Відповідь

Успіх (200 OK):

{
  "successful": [
    {
      "index": 0,
      "status": 201,
      "data": {
        "source_category_id": 123,
        "translations": [...]
      }
    }
  ]
}

Частковий успіх (400 Bad Request):

При частковому успіху відповідь містить два масиви:

• successful — успішно створені/оновлені записи
• errors — деталі помилок для кожного індексу

caution

Після отримання часткового успіху виправте помилки, зазначені в полі errors, і повторіть запит.

{
  "errors": [
    {
      "index": 1,
      "errors": {
        "source_category_id": "Source category ID must be a positive integer."
      }
    }
  ],
  "successful": [...]
}

---