Λήψη λίστας προϊόντων

GET/api/crm/v2/itemsv2

operationId: items.default

Εξουσιοδότηση

api-token + language + role

Παράμετροι ερωτήματος

branch_idinteger

Παράδειγμα: 1

category_idinteger

Παράδειγμα: 1

Απαντήσεις

object

statusstringυποχρεωτικό

Τιμές:successerror

Παράδειγμα: success

dataobject

filtersobject

branch_idobject (FilterSelectInteger)

valueinteger

Παράδειγμα: 8920

typestringυποχρεωτικό

Παράδειγμα: select

optionarray of object

valueintegerυποχρεωτικό

Παράδειγμα: 8920

namestringυποχρεωτικό

Παράδειγμα: Green Basket | Kaliningrad

modestring (FilterMode)

Πώς το περιβάλλον χειρίζεται το φίλτρο· το συνηθισμένο φίλτρο δεν έχει mode. Το force_shown — εμφανίζεται πάντα, δεν μπορεί να αποκρυφθεί. Το value_required — σημείο εισόδου στην ενότητα: εμφανίζεται πάντα, δεν έχει κενή τιμή (μέχρι να επιλεγεί τιμή, η λίστα είναι κενή· δεν υπάρχει επιλογή «όλα»), η γενική επαναφορά δεν το καθαρίζει.

Τιμές:force_shownvalue_required

Παράδειγμα: value_required

branch_idinteger

Παράδειγμα: 1

automation_have_importboolean

Παράδειγμα: true

sizesobject

image_mobileobject

widthinteger

Παράδειγμα: 750

heightinteger

Παράδειγμα: 300

image_desktopobject

widthinteger

Παράδειγμα: 1500

heightinteger

Παράδειγμα: 1500

listarray of object

idintegerυποχρεωτικό

Παράδειγμα: 18085142

nameobject (TranslationField) υποχρεωτικό

Μεταφραζόμενο πεδίο καταλόγου· ίδια δομή στην απόκριση και στο αίτημα.
Κατά τη δημιουργία, κάθε γλώσσα του δικτύου που δεν υπάρχει στο translations παραμένει κενή και προστίθεται στην ουρά για AI-μετάφραση.
Κατά την τροποποίηση, αποθηκεύονται μόνο οι γλώσσες από το translations: γλώσσα που δεν υπάρχει στο αντικείμενο διατηρεί την προηγούμενη τιμή, αν το πρωτότυπο δεν έχει αλλάξει· κενή τιμή διαγράφει τη μετάφραση και την προσθέτει στην ουρά για AI-μετάφραση.
Η αλλαγή του πρωτοτύπου διαγράφει μεταφράσεις που στάλθηκαν χωρίς αλλαγές — δεν αντιστοιχούν πλέον σε αυτό· μετάφραση που στάλθηκε με διαφορετική τιμή αποθηκεύεται ως χειροκίνητη διόρθωση. Αυτή η διαγραφή γίνεται μόνο όσο το αυτόματο σύστημα μετάφρασης του δικτύου είναι ενεργό.
Τιμή σε μη δημοσιευμένη γλώσσα απορρίπτεται· τιμή σε γλώσσα εκτός του συνόλου γλωσσών του δικτύου αγνοείται.

defaultstring

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

Παράδειγμα: ru

translationsobjectυποχρεωτικό

Τιμή ανά κωδικό γλώσσας· αν δεν υπάρχει μετάφραση — δεν υπάρχει κλειδί

Τιμές λεξικού

string

separate_export_enabledbooleanυποχρεωτικό

Παράδειγμα: true

publishedbooleanυποχρεωτικό

Παράδειγμα: true

discount_enabledbooleanυποχρεωτικό

Παράδειγμα: true

recommend_enabledbooleanυποχρεωτικό

Παράδειγμα: false

stock_balance_enabledbooleanυποχρεωτικό

Παράδειγμα: false

free_delivery_enabledbooleanυποχρεωτικό

Παράδειγμα: true

minimum_sum_enabledbooleanυποχρεωτικό

Παράδειγμα: true

popular_enabledbooleanυποχρεωτικό

Παράδειγμα: true

bonuses_accrual_enabledbooleanυποχρεωτικό

Παράδειγμα: true

bonuses_withdraw_enabledbooleanυποχρεωτικό

Παράδειγμα: true

image_desktopstringυποχρεωτικό

Παράδειγμα: https://cdn.foodsoul.test/zones/ru/branches/8920/images/items/medium/ec5b325fc4aa11721ecae38ae841f90b.jpg?v1745505855

image_mobilestringυποχρεωτικό

Παράδειγμα: https://cdn.foodsoul.test/zones/ru/branches/8920/images/items/mobile/e12a68ed472cefd7ba68daaf6299ec2f.jpg?v1745505855

sortintegerυποχρεωτικό

Παράδειγμα: 1

date_availablestring (DataTimeFormatSQL)

Παράδειγμα: 2024-05-02 08:31:16

date_expirationstring (DataTimeFormatSQL)

Παράδειγμα: 2024-05-02 08:31:16

days_of_weekarray of integer

time_periodsarray of string

hide_for_districts_idsarray of integer

hide_for_pickups_idsarray of integer

labels_idsarray of integer

template_modifiers_groups_idsarray of integer

category_idintegerυποχρεωτικό

Παράδειγμα: 3389048

compositionobject (TranslationField)

defaultstring

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

Παράδειγμα: ru

translationsobjectυποχρεωτικό

Τιμή ανά κωδικό γλώσσας· αν δεν υπάρχει μετάφραση — δεν υπάρχει κλειδί

Τιμές λεξικού

string

modifiers_multiplier_enabledbooleanυποχρεωτικό

Παράδειγμα: true

hide_cost_if_zero_enabledbooleanυποχρεωτικό

Παράδειγμα: true

only_informing_enabledbooleanυποχρεωτικό

Παράδειγμα: true

excise_enabledboolean

Παράδειγμα: true

typestring

Τιμές:bouquetproductcombodishdrinkgift

Παράδειγμα: product

parametersarray of objectυποχρεωτικό

idintegerυποχρεωτικό

Παράδειγμα: 1

descriptionstring

Παράδειγμα: tasty, with onion

measure_idinteger

Παράδειγμα: 1

measure_indexintegerυποχρεωτικό

Παράδειγμα: 1

old_costnumberυποχρεωτικό

Παράδειγμα: 100

costnumberυποχρεωτικό

Παράδειγμα: 90

bonusesnumberυποχρεωτικό

Παράδειγμα: 90

vendor_codestring

Παράδειγμα: d1763be5-76a6-4ddb-8e11-3a1f91de199c::d835bcc9-1349-4911-af1d-131fd73144e5

sortintegerυποχρεωτικό

Παράδειγμα: 1

modifiers_groups_idsarray of integer

proteinsinteger

Παράδειγμα: 10

fatsinteger

Παράδειγμα: 10

carbohydratesinteger

Παράδειγμα: 10

caloriesinteger

Παράδειγμα: 10

<?php $client = new \GuzzleHttp\Client(); $response = $client->request('GET', 'https://foodsoul.ru/api/crm/v2/items', [ 'headers' => [ 'Authorization' => 'Bearer fs_api_YOUR_TOKEN', 'language' => 'el', 'role' => 'partner', ], ]); $data = json_decode((string) $response->getBody(), true);

const response = await fetch("https://foodsoul.ru/api/crm/v2/items", { method: "GET", headers: { "Authorization": "Bearer fs_api_YOUR_TOKEN", "language": "el", "role": "partner" }, }) const data = await response.json()

import requests response = requests.request( "GET", "https://foodsoul.ru/api/crm/v2/items", headers={ "Authorization": "Bearer fs_api_YOUR_TOKEN", "language": "el", "role": "partner", }, ) data = response.json()

{ "status": "success", "data": { "filters": { "branch_id": { "value": 8920, "type": "select", "option": [ { "value": 8920, "name": "Green Basket | Kaliningrad" } ], "mode": "value_required" } }, "branch_id": 1, "automation_have_import": true, "sizes": { "image_mobile": { "width": 750, "height": 300 }, "image_desktop": { "width": 1500, "height": 1500 } }, "list": [ { "id": 18085142, "name": { "default": "ru", "translations": { "ru": "Пицца", "en": "Pizza" } }, "separate_export_enabled": true, "published": true, "discount_enabled": true, "recommend_enabled": false, "stock_balance_enabled": false, "free_delivery_enabled": true, "minimum_sum_enabled": true, "popular_enabled": true, "bonuses_accrual_enabled": true, "bonuses_withdraw_enabled": true, "image_desktop": "https://cdn.foodsoul.test/zones/ru/branches/8920/images/items/medium/ec5b325fc4aa11721ecae38ae841f90b.jpg?v1745505855", "image_mobile": "https://cdn.foodsoul.test/zones/ru/branches/8920/images/items/mobile/e12a68ed472cefd7ba68daaf6299ec2f.jpg?v1745505855", "sort": 1, "date_available": "2024-05-02 08:31:16", "date_expiration": "2024-05-02 08:31:16", "days_of_week": [ 1 ], "time_periods": [ "11:24 - 12:34" ], "hide_for_districts_ids": [ 55311 ], "hide_for_pickups_ids": [ 4926 ], "labels_ids": [ 7411 ], "template_modifiers_groups_ids": [ 17589435 ], "category_id": 3389048, "composition": { "default": "ru", "translations": { "ru": "Пицца", "en": "Pizza" } }, "modifiers_multiplier_enabled": true, "hide_cost_if_zero_enabled": true, "only_informing_enabled": true, "excise_enabled": true, "type": "product", "parameters": [ { "id": 1, "description": "tasty, with onion", "measure_id": 1, "measure_index": 1, "old_cost": 100, "cost": 90, "bonuses": 90, "vendor_code": "d1763be5-76a6-4ddb-8e11-3a1f91de199c::d835bcc9-1349-4911-af1d-131fd73144e5", "sort": 1, "modifiers_groups_ids": [], "proteins": 10, "fats": 10, "carbohydrates": 10, "calories": 10 } ] } ] } }