Створити категорію

POST/api/crm/v2/categories.addv2

operationId: categories.add

Створює категорію. SEO-адреса генерується автоматично та перевіряється на унікальність. Прапорці публікації, знижок, мінімальної суми та безкоштовної доставки за замовчуванням увімкнені.

Авторизація

api-token + language + role

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

branch_idintegerобов’язковий

Приклад: 1

Тіло запиту `application/json`

object

nameobject (TranslationField) обов’язковий

Поле каталогу для перекладу; має однакову структуру у відповіді та запиті. Під час створення кожна мова мережі, якої немає в translations, залишається порожньою та ставиться в чергу на AI-переклад. Під час зміни зберігаються лише мови з translations: мова, якої немає в об'єкті, зберігає попереднє значення, якщо оригінал не змінено; порожнє значення очищає переклад і ставить його в чергу на AI-переклад. Зміна оригіналу очищає переклади, що надійшли без змін, — вони більше йому не відповідають; переклад, переданий з іншим значенням, зберігається як ручне редагування. Таке очищення відбувається лише поки в мережі увімкнено автоматичний переклад. Значення на неопублікованій мові відхиляється; значення на мові поза набором мов мережі ігнорується.

defaultstring

Код исходного языка сети; в запросе должен совпадать с настройкой сети

Приклад: ru

translationsobjectобов’язковий

Значення за кодом мови; немає перекладу — немає ключа

Значення словника

string

date_availablestring (DataTimeFormat)

Приклад: 17:45 06/05/2024

date_expirationstring (DataTimeFormat)

Приклад: 17:45 06/05/2024

days_of_weekarray of integerобов’язковий

time_periodsarray of string

hide_for_districts_idsarray of integer

hide_for_pickups_idsarray of integer

parent_idinteger

Приклад: 1

Відповіді

object

statusstringобов’язковий

Значення:successerror

Приклад: success

dataobject

curl -X POST 'https://foodsoul.ru/api/crm/v2/categories.add?branch_id=1' \ -H 'Authorization: Bearer fs_api_YOUR_TOKEN' \ -H 'language: uk' \ -H 'role: partner' \ -H 'Content-Type: application/json' \ -d '{"name":{"default":"ru","translations":{"ru":"Пицца","en":"Pizza"}},"date_available":"17:45 06/05/2024","date_expiration":"17:45 06/05/2024","days_of_week":[1],"time_periods":["11:24 - 12:34"],"hide_for_districts_ids":[1],"hide_for_pickups_ids":[1],"parent_id":1}'

<?php $client = new \GuzzleHttp\Client(); $response = $client->request('POST', 'https://foodsoul.ru/api/crm/v2/categories.add?branch_id=1', [ 'headers' => [ 'Authorization' => 'Bearer fs_api_YOUR_TOKEN', 'language' => 'uk', 'role' => 'partner', ], 'json' => [ 'name' => [ 'default' => 'ru', 'translations' => [ 'ru' => 'Пицца', 'en' => 'Pizza', ], ], 'date_available' => '17:45 06/05/2024', 'date_expiration' => '17:45 06/05/2024', 'days_of_week' => [ 1, ], 'time_periods' => [ '11:24 - 12:34', ], 'hide_for_districts_ids' => [ 1, ], 'hide_for_pickups_ids' => [ 1, ], 'parent_id' => 1, ], ]); $data = json_decode((string) $response->getBody(), true);

const response = await fetch("https://foodsoul.ru/api/crm/v2/categories.add?branch_id=1", { method: "POST", headers: { "Authorization": "Bearer fs_api_YOUR_TOKEN", "language": "uk", "role": "partner", "Content-Type": "application/json" }, body: JSON.stringify({ "name": { "default": "ru", "translations": { "ru": "Пицца", "en": "Pizza" } }, "date_available": "17:45 06/05/2024", "date_expiration": "17:45 06/05/2024", "days_of_week": [ 1 ], "time_periods": [ "11:24 - 12:34" ], "hide_for_districts_ids": [ 1 ], "hide_for_pickups_ids": [ 1 ], "parent_id": 1 }), }) const data = await response.json()

import requests response = requests.request( "POST", "https://foodsoul.ru/api/crm/v2/categories.add?branch_id=1", headers={ "Authorization": "Bearer fs_api_YOUR_TOKEN", "language": "uk", "role": "partner", }, json={ "name": { "default": "ru", "translations": { "ru": "Пицца", "en": "Pizza", }, }, "date_available": "17:45 06/05/2024", "date_expiration": "17:45 06/05/2024", "days_of_week": [ 1, ], "time_periods": [ "11:24 - 12:34", ], "hide_for_districts_ids": [ 1, ], "hide_for_pickups_ids": [ 1, ], "parent_id": 1, }, ) data = response.json()

Створити категорію

Авторизація

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

Тіло запиту application/json

Відповіді

Тіло запиту `application/json`