Δημιουργία κατηγορίας

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: el' \ -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' => 'el', '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": "el", "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": "el", "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`