Λήψη λίστας προσφορών

GET/api/crm/v2/special_offers_listv2

operationId: specialOffersList.default

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

api-token + language + role

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

branch_idinteger

Το υποκατάστημα με βάση το οποίο φιλτράρεται η λίστα. Χωρίς αυτό, η απάντηση περιέχει μόνο τα φίλτρα, χωρίς τη λίστα. Για συνεργάτη με ένα μόνο υποκατάστημα, ο διακομιστής το ορίζει αυτόματα.

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

page_numberinteger

Παράδειγμα: 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

listarray of object

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

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

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

Παράδειγμα: Free delivery

date_availablestring (DataTimeFormatSQL)

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

date_expirationstring (DataTimeFormatSQL)

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

operating_modestring (TypeOperatingMode) υποχρεωτικό

Τιμές:informingpromo_codeinforming_and_promo_codeautomatic_actioninforming_and_automatic_action

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

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

Παράδειγμα: -1714739780

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

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

hide_for_districts_idsarray of integer

hide_for_pickups_idsarray of integer

descriptionstring

Παράδειγμα: informing description

imagestring

Παράδειγμα: https://cdn.foodsoul.test/zones/ru/branches/8810/images/special_offers/medium/ec17cfe9697ff2e301cba7736a5d329b.jpg?v1726243373

branch_idinteger

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

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

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

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

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

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

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

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

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

first_purchase_platformstring (Platform)

Τιμές:androidiosallmobile_appssitesocial_apps

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

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

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

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

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

delivery_methodstring (DeliveryMethodUpdate) υποχρεωτικό

Τιμές:allcourierpickup

days_of_weekarray of integer

time_periodsarray of array of string (TimePeriods)

Περίοδος χρόνου

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

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

from_sumnumber

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

to_sumnumber

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

multiple_sumnumber

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

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

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

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

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

push_titlestring

Παράδειγμα: Free delivery

push_messagestring

Παράδειγμα: Free delivery today from 18:00

platformstring (Platform) υποχρεωτικό

Τιμές:androidiosallmobile_appssitesocial_apps

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

typestring (TypeWorkOperatingMode)

Τιμές:fixed_discount_on_all_orderpercent_discount_on_all_orderfixed_discount_on_items_from_categoriespercent_discount_on_items_from_categoriesfixed_discount_on_itemspercent_discount_on_itemsfree_item_to_choose_if_buy_itemsfree_item_to_choose_if_buy_items_from_categoriesfixed_discount_on_next_itempercent_discount_on_next_itemfixed_discount_on_next_item_from_categoriespercent_discount_on_next_item_from_categoriesfree_item_to_choosepercent_discount_on_item_with_minimum_cost_in_cartfixed_discount_on_item_with_minimum_cost_in_cartpercent_discount_on_item_with_minimum_cost_from_itemsfixed_discount_on_item_with_minimum_cost_from_itemspercent_discount_on_item_with_minimum_cost_from_categoriesfixed_discount_on_item_with_minimum_cost_from_categoriesbonusesfree_delivery

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

count_items_for_conditioninteger

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

count_items_for_actioninteger

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

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

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

actions_itemsarray of integer

conditions_itemsarray of integer

actions_categoriesarray of integer

conditions_categoriesarray of integer

discountnumber

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

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

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

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

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

birthday_validity_beforeinteger

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

birthday_validity_afterinteger

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

bonuses_sumnumber

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

bonuses_validitynumber

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

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

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

paginationobject (Pagination)

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

Αριθμός στοιχείων ανά σελίδα

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

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

Αριθμός τρέχουσας σελίδας· περιορίζεται ώστε η μετατόπιση να μην υπερβαίνει το 1000

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

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

Υπάρχει επόμενη σελίδα

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

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

Υπάρχει προηγούμενη σελίδα

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

timezonestring

Παράδειγμα: Europe/Kaliningrad

<?php $client = new \GuzzleHttp\Client(); $response = $client->request('GET', 'https://foodsoul.ru/api/crm/v2/special_offers_list', [ '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/special_offers_list", { 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/special_offers_list", 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" } }, "list": [ { "id": 1, "name": "Free delivery", "date_available": "2024-05-02 08:31:16", "date_expiration": "2024-05-02 08:31:16", "operating_mode": "informing", "sort": -1714739780, "published": true, "hide_for_districts_ids": [ 1 ], "hide_for_pickups_ids": [ 1 ], "description": "informing description", "image": "https://cdn.foodsoul.test/zones/ru/branches/8810/images/special_offers/medium/ec17cfe9697ff2e301cba7736a5d329b.jpg?v1726243373", "branch_id": 1, "authorized_users_enabled": true, "work_with_pay_bonuses_enabled": true, "accrual_bonuses_enabled": true, "first_purchase_enabled": true, "first_purchase_platform": "all", "subcategories_include_in_categories_enabled": true, "reuse_enabled": true, "delivery_method": "all", "days_of_week": [ 6, 7 ], "time_periods": [ [ "13:12 - 13:15" ] ], "ignore_in_minimum_sum_enabled": true, "from_sum": 100, "to_sum": 1000, "multiple_sum": 100, "from_to_sums_for_items_from_conditions_enabled": true, "automatic_old_cost_for_items_enabled": true, "push_title": "Free delivery", "push_message": "Free delivery today from 18:00", "platform": "all", "type": "free_delivery", "count_items_for_condition": 10, "count_items_for_action": 10, "one_item_from_conditions_enabled": true, "actions_items": [ 94061047 ], "conditions_items": [ 94061047 ], "actions_categories": [ 3387030 ], "conditions_categories": [ 3387030 ], "discount": 10, "use_only_one_time_in_cart_enabled": true, "use_only_in_birthday_enabled": true, "birthday_validity_before": 10, "birthday_validity_after": 10, "bonuses_sum": 100, "bonuses_validity": 100, "count_activate_offer": 0 } ], "pagination": { "max_count": 30, "page_number": 1, "has_next": true, "has_previous": false }, "timezone": "Europe/Kaliningrad" } }