Σχήματα δεδομένων: Προϊόντα

dataΠίνακας <ProductSummaryData > Υποχρεωτικό

Παράδειγμα απόκρισης · ApiResponse_list_ProductSummaryData__.

Παράδειγμα: [{"availability":{"available_from":null,"available_until":null,"is_available":true},"brand_id":null,"condition":"new","created_at":"2026-01-01T12:00:00Z","id":"example","name":"Example","number":"example","price":{"amount":"0.00","currency":"PLN","minor_units":2,"tax_included":true},"price_version":1,"primary_category_id":"example","primary_media_id":"example","published":false,"sku":"example","slug":"example","tax_category_id":"example","updated_at":"2026-01-01T12:00:00Z","variants_enabled":false,"version":1}]

metaContextPageMeta | ContextMeta | PageMeta | RequestMeta Υποχρεωτικό

Μεταδεδομένα απόκρισης.

Παράδειγμα: {"locale":"en","market_code":"PL","market_id":"example","pagination":{"has_more":false,"limit":20,"next_cursor":null},"request_id":"example"}

Πρόσθετα πεδία: Όχι

dataProductDetailData Υποχρεωτικό

Παράδειγμα απόκρισης · ProductDetailData.

Παράδειγμα: {"availability":{"available_from":null,"available_until":null,"is_available":true},"brand_id":null,"condition":"new","created_at":"2026-01-01T12:00:00Z","description":"example","features":[{"feature_id":"example","feature_name":"example","value":"example","value_id":"example"}],"id":"example","identifiers":{},"media":[{"alt_text":"example","id":"example","is_primary":true,"kind":"image","mime_type":"image/jpeg","position":1,"url":"https://example.invalid/product.jpg"}],"meta_description":"example","meta_keywords":["example"],"meta_title":"example","name":"Example","number":"example","price":{"amount":"0.00","currency":"PLN","minor_units":2,"tax_included":true},"price_version":1,"primary_category_id":"example","primary_media_id":"example","published":false,"sku":"example","slug":"example","tax_category_id":"example","updated_at":"2026-01-01T12:00:00Z","variants_enabled":false,"version":1}

metaContextPageMeta | ContextMeta | PageMeta | RequestMeta Υποχρεωτικό

Μεταδεδομένα απόκρισης.

Παράδειγμα: {"locale":"en","market_code":"PL","market_id":"example","request_id":"example"}

Πρόσθετα πεδία: Όχι

available_fromΣυμβολοσειρά | nullΥποχρεωτικό

Έναρξη διαθεσιμότητας.

Συμβολοσειρά:format: "date-time"

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

available_untilΣυμβολοσειρά | nullΥποχρεωτικό

Λήξη διαθεσιμότητας.

Συμβολοσειρά:format: "date-time"

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

is_availableΛογική τιμήΥποχρεωτικό

Δείχνει αν το στοιχείο είναι διαθέσιμο σε αυτό το πλαίσιο.

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

Πρόσθετα πεδία: Όχι

amountΣυμβολοσειράΥποχρεωτικό

Δεκαδικό ποσό ως συμβολοσειρά JSON· null μόνο όπου επιτρέπεται.

Παράδειγμα: "0.00"

currencyΣυμβολοσειράΥποχρεωτικό

Κωδικός νομίσματος του ποσού.

Περιορισμοί

pattern

"^[A-Z]{3}$"

Παράδειγμα: "PLN"

minor_unitsΑκέραιοςΥποχρεωτικό

Πλήθος δεκαδικών ψηφίων του νομίσματος.

minimum: 0maximum: 4

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

tax_includedΛογική τιμήΥποχρεωτικό

Δείχνει αν η υποβαλλόμενη τιμή περιλαμβάνει φόρο.

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

Πρόσθετα πεδία: Όχι

currencyΣυμβολοσειράΥποχρεωτικό

Κωδικός νομίσματος του ποσού.

idΣυμβολοσειράΥποχρεωτικό

Αναγνωριστικό πόρου· διατηρήστε το ακριβώς όπως επιστρέφεται. (PriceListData).

tax_includedΛογική τιμήΥποχρεωτικό

Δείχνει αν η υποβαλλόμενη τιμή περιλαμβάνει φόρο.

versionΑκέραιοςΥποχρεωτικό

Έκδοση πόρου για έλεγχο ταυτόχρονων εγγραφών.

Πρόσθετα πεδία: Όχι

brand_idΣυμβολοσειρά | nullΠροαιρετικό

Αναγνωριστικό μάρκας.

Συμβολοσειρά:minLength: 1maxLength: 63

conditionΣυμβολοσειράΠροαιρετικό

Κατάσταση προϊόντος.

Περιορισμοί

enum

["new", "refurbished", "used", "returned", "display", "damaged"]

Προεπιλογή: "new"

descriptionΣυμβολοσειρά | nullΠροαιρετικό

Περιγραφή στην επιλεγμένη γλώσσα.

Συμβολοσειρά:maxLength: 100000

feature_value_idsΠίνακας <Συμβολοσειρά> Προαιρετικό

Αναγνωριστικά επιλεγμένων τιμών χαρακτηριστικού.

maxItems: 1000

Πίνακας:minLength: 1maxLength: 63

identifiersProductIdentifiers | nullΠροαιρετικό

Κωδικοί αναγνώρισης προϊόντος.

market_idsΠίνακας <Συμβολοσειρά> Προαιρετικό

Αναγνωριστικά επιλεγμένων αγορών.

maxItems: 1000

Πίνακας:minLength: 1maxLength: 63

media_idsΠίνακας <Συμβολοσειρά> Προαιρετικό

Αναγνωριστικά ήδη υπαρχόντων αρχείων πολυμέσων.

maxItems: 20

Πίνακας:minLength: 1maxLength: 63

meta_descriptionΣυμβολοσειρά | nullΠροαιρετικό

Περιγραφή για μηχανές αναζήτησης στην επιλεγμένη γλώσσα.

Συμβολοσειρά:maxLength: 160

meta_keywordsΠίνακας <Συμβολοσειρά> | nullΠροαιρετικό

Λέξεις-κλειδιά για μηχανές αναζήτησης στην επιλεγμένη γλώσσα.

Πίνακας:maxItems: 20

Πίνακας / Πίνακας:maxLength: 50

meta_titleΣυμβολοσειρά | nullΠροαιρετικό

Τίτλος για μηχανές αναζήτησης στην επιλεγμένη γλώσσα.

Συμβολοσειρά:maxLength: 70

nameΣυμβολοσειράΥποχρεωτικό

Όνομα πόρου στο σχετικό πλαίσιο.

minLength: 1maxLength: 300

Παράδειγμα: "Example"

pricingProductPrice Προαιρετικό

Ρυθμίσεις τιμολόγησης και εκδόσεις ελέγχου ταυτόχρονων εγγραφών.

primary_category_idΣυμβολοσειρά | nullΠροαιρετικό

Αναγνωριστικό κύριας κατηγορίας.

Συμβολοσειρά:minLength: 1maxLength: 63

publishedΛογική τιμήΠροαιρετικό

Δείχνει αν ο πόρος έχει δημοσιευτεί.

Προεπιλογή: false

skuΣυμβολοσειράΥποχρεωτικό

Κωδικός μονάδας αποθέματος.

minLength: 1maxLength: 100

Περιορισμοί

pattern

"^\\S+$"

Παράδειγμα: "example"

slugΣυμβολοσειρά | nullΠροαιρετικό

Τμήμα διαδρομής URL στην επιλεγμένη γλώσσα.

Συμβολοσειρά:maxLength: 160

tax_category_idΣυμβολοσειρά | nullΠροαιρετικό

Αναγνωριστικό φορολογικής κατηγορίας.

Συμβολοσειρά:minLength: 1maxLength: 63

variant_value_idsΠίνακας <Συμβολοσειρά> Προαιρετικό

Αναγνωριστικά επιλεγμένων τιμών παραλλαγής.

maxItems: 250

Πίνακας:minLength: 1maxLength: 63

variants_enabledΛογική τιμήΠροαιρετικό

Δείχνει αν το προϊόν χρησιμοποιεί παραλλαγές.

Προεπιλογή: false

Πρόσθετα πεδία: Όχι

availabilityAvailabilityData Υποχρεωτικό

Πληροφορίες διαθεσιμότητας στο επιλεγμένο πλαίσιο.

Παράδειγμα: {"available_from":null,"available_until":null,"is_available":true}

brand_idΣυμβολοσειρά | nullΥποχρεωτικό

Αναγνωριστικό μάρκας.

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

conditionΣυμβολοσειράΥποχρεωτικό

Κατάσταση προϊόντος.

Περιορισμοί

enum

["new", "refurbished", "used", "returned", "display", "damaged"]

Παράδειγμα: "new"

created_atΣυμβολοσειράΥποχρεωτικό

Χρόνος δημιουργίας.

format: "date-time"

Παράδειγμα: "2026-01-01T12:00:00Z"

descriptionΣυμβολοσειρά | nullΥποχρεωτικό

Περιγραφή στην επιλεγμένη γλώσσα.

Παράδειγμα: "example"

featuresΠίνακας <FeatureSelectionData > Υποχρεωτικό

Χαρακτηριστικά προϊόντος.

Παράδειγμα: [{"feature_id":"example","feature_name":"example","value":"example","value_id":"example"}]

idΣυμβολοσειράΥποχρεωτικό

Αναγνωριστικό πόρου· διατηρήστε το ακριβώς όπως επιστρέφεται. (ProductDetailData).

Παράδειγμα: "example"

identifiersΑντικείμενοΠρόσθετα πεδία: ΣυμβολοσειράΥποχρεωτικό

Κωδικοί αναγνώρισης προϊόντος.

Παράδειγμα: {}

mediaΠίνακας <ProductMediaData > Υποχρεωτικό

Πληροφορίες συνημμένων πολυμέσων.

Παράδειγμα: [{"alt_text":"example","id":"example","is_primary":true,"kind":"image","mime_type":"image/jpeg","position":1,"url":"https://example.invalid/product.jpg"}]

meta_descriptionΣυμβολοσειρά | nullΥποχρεωτικό

Περιγραφή για μηχανές αναζήτησης στην επιλεγμένη γλώσσα.

Παράδειγμα: "example"

meta_keywordsΠίνακας <Συμβολοσειρά> | nullΥποχρεωτικό

Λέξεις-κλειδιά για μηχανές αναζήτησης στην επιλεγμένη γλώσσα.

Παράδειγμα: ["example"]

meta_titleΣυμβολοσειρά | nullΥποχρεωτικό

Τίτλος για μηχανές αναζήτησης στην επιλεγμένη γλώσσα.

Παράδειγμα: "example"

nameΣυμβολοσειρά | nullΥποχρεωτικό

Όνομα πόρου στο σχετικό πλαίσιο.

Παράδειγμα: "Example"

numberΣυμβολοσειράΥποχρεωτικό

Αριθμός παραγγελίας ή αιτήματος που εμφανίζεται στον χρήστη.

Παράδειγμα: "example"

pricePriceData | nullΥποχρεωτικό

Πληροφορίες τιμής στο επιλεγμένο πλαίσιο.

Παράδειγμα: {"amount":"0.00","currency":"PLN","minor_units":2,"tax_included":true}

price_versionΑκέραιοςΥποχρεωτικό

Τρέχουσα έκδοση τιμής για έλεγχο ταυτόχρονων εγγραφών.

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

primary_category_idΣυμβολοσειρά | nullΥποχρεωτικό

Αναγνωριστικό κύριας κατηγορίας.

Παράδειγμα: "example"

primary_media_idΣυμβολοσειρά | nullΥποχρεωτικό

Αναγνωριστικό κύριου αρχείου πολυμέσων.

Παράδειγμα: "example"

publishedΛογική τιμήΥποχρεωτικό

Δείχνει αν ο πόρος έχει δημοσιευτεί.

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

skuΣυμβολοσειράΥποχρεωτικό

Κωδικός μονάδας αποθέματος.

Παράδειγμα: "example"

slugΣυμβολοσειρά | nullΥποχρεωτικό

Τμήμα διαδρομής URL στην επιλεγμένη γλώσσα.

Παράδειγμα: "example"

tax_category_idΣυμβολοσειράΥποχρεωτικό

Αναγνωριστικό φορολογικής κατηγορίας.

Παράδειγμα: "example"

updated_atΣυμβολοσειράΥποχρεωτικό

Χρόνος τελευταίας ενημέρωσης.

format: "date-time"

Παράδειγμα: "2026-01-01T12:00:00Z"

variants_enabledΛογική τιμήΥποχρεωτικό

Δείχνει αν το προϊόν χρησιμοποιεί παραλλαγές.

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

versionΑκέραιοςΥποχρεωτικό

Έκδοση πόρου για έλεγχο ταυτόχρονων εγγραφών.

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

Πρόσθετα πεδία: Όχι

eanΣυμβολοσειρά | nullΠροαιρετικό

Αναγνωριστικό προϊόντος EAN.

Συμβολοσειρά:minLength: 1maxLength: 100

isbnΣυμβολοσειρά | nullΠροαιρετικό

Αναγνωριστικό ISBN.

Συμβολοσειρά:minLength: 1maxLength: 100

mpnΣυμβολοσειρά | nullΠροαιρετικό

Κωδικός προϊόντος κατασκευαστή.

Συμβολοσειρά:minLength: 1maxLength: 100

upcΣυμβολοσειρά | nullΠροαιρετικό

Αναγνωριστικό προϊόντος UPC.

Συμβολοσειρά:minLength: 1maxLength: 100

Πρόσθετα πεδία: Όχι

alt_textΣυμβολοσειρά | nullΥποχρεωτικό

Εναλλακτικό κείμενο εικόνας.

Παράδειγμα: "example"

idΣυμβολοσειράΥποχρεωτικό

Αναγνωριστικό πόρου· διατηρήστε το ακριβώς όπως επιστρέφεται. (ProductMediaData).

Παράδειγμα: "example"

is_primaryΛογική τιμήΥποχρεωτικό

Δείχνει αν είναι το κύριο στοιχείο.

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

kindΣυμβολοσειράΥποχρεωτικό

Μορφή της δομής δεδομένων, όπως ορίζεται από τις επιτρεπόμενες τιμές.

Περιορισμοί

enum

["image", "video", "model_3d"]

Παράδειγμα: "image"

mime_typeΣυμβολοσειράΥποχρεωτικό

Τύπος περιεχομένου πολυμέσων.

Παράδειγμα: "image/jpeg"

positionΑκέραιοςΥποχρεωτικό

Θέση στην ταξινομημένη συλλογή.

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

urlΣυμβολοσειρά | nullΥποχρεωτικό

URL πόρου.

Παράδειγμα: "https://example.invalid/product.jpg"

Πρόσθετα πεδία: Όχι

amountΣυμβολοσειρά | nullΥποχρεωτικό

Δεκαδικό ποσό ως συμβολοσειρά JSON· null μόνο όπου επιτρέπεται.

Συμβολοσειρά:maxLength: 19

Περιορισμοί · Συμβολοσειρά 1

pattern

"^(0|[1-9][0-9]{0,13})(\\.[0-9]{1,4})?$"

Παράδειγμα: "0.00"

currencyΣυμβολοσειράΥποχρεωτικό

Κωδικός νομίσματος του ποσού.

Περιορισμοί

pattern

"^[A-Z]{3}$"

Παράδειγμα: "PLN"

expected_price_list_versionΑκέραιοςΥποχρεωτικό

Έκδοση τιμοκαταλόγου που διαβάστηκε προηγουμένως και απαιτείται για την εγγραφή.

minimum: 1maximum: 9223372036854775807

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

expected_versionΑκέραιοςΥποχρεωτικό

Έκδοση που διαβάστηκε πριν από την εγγραφή· αν δεν συμφωνεί, η ενημέρωση απορρίπτεται.

minimum: 0maximum: 9223372036854775807

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

kindΣυμβολοσειράΥποχρεωτικό

Μορφή της δομής δεδομένων, όπως ορίζεται από τις επιτρεπόμενες τιμές.

Περιορισμοί

enum

["base", "market_fixed"]

Παράδειγμα: "base"

price_list_idΣυμβολοσειράΥποχρεωτικό

Αναγνωριστικό τιμοκαταλόγου.

minLength: 1maxLength: 63

Παράδειγμα: "example"

tax_includedΛογική τιμήΥποχρεωτικό

Δείχνει αν η υποβαλλόμενη τιμή περιλαμβάνει φόρο.

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

Πρόσθετα πεδία: Όχι

availabilityAvailabilityData Υποχρεωτικό

Πληροφορίες διαθεσιμότητας στο επιλεγμένο πλαίσιο.

Παράδειγμα: {"available_from":null,"available_until":null,"is_available":true}

brand_idΣυμβολοσειρά | nullΥποχρεωτικό

Αναγνωριστικό μάρκας.

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

conditionΣυμβολοσειράΥποχρεωτικό

Κατάσταση προϊόντος.

Περιορισμοί

enum

["new", "refurbished", "used", "returned", "display", "damaged"]

Παράδειγμα: "new"

created_atΣυμβολοσειράΥποχρεωτικό

Χρόνος δημιουργίας.

format: "date-time"

Παράδειγμα: "2026-01-01T12:00:00Z"

idΣυμβολοσειράΥποχρεωτικό

Αναγνωριστικό πόρου· διατηρήστε το ακριβώς όπως επιστρέφεται. (ProductSummaryData).

Παράδειγμα: "example"

nameΣυμβολοσειρά | nullΥποχρεωτικό

Όνομα πόρου στο σχετικό πλαίσιο.

Παράδειγμα: "Example"

numberΣυμβολοσειράΥποχρεωτικό

Αριθμός παραγγελίας ή αιτήματος που εμφανίζεται στον χρήστη.

Παράδειγμα: "example"

pricePriceData | nullΥποχρεωτικό

Πληροφορίες τιμής στο επιλεγμένο πλαίσιο.

Παράδειγμα: {"amount":"0.00","currency":"PLN","minor_units":2,"tax_included":true}

price_versionΑκέραιοςΥποχρεωτικό

Τρέχουσα έκδοση τιμής για έλεγχο ταυτόχρονων εγγραφών.

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

primary_category_idΣυμβολοσειρά | nullΥποχρεωτικό

Αναγνωριστικό κύριας κατηγορίας.

Παράδειγμα: "example"

primary_media_idΣυμβολοσειρά | nullΥποχρεωτικό

Αναγνωριστικό κύριου αρχείου πολυμέσων.

Παράδειγμα: "example"

publishedΛογική τιμήΥποχρεωτικό

Δείχνει αν ο πόρος έχει δημοσιευτεί.

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

skuΣυμβολοσειράΥποχρεωτικό

Κωδικός μονάδας αποθέματος.

Παράδειγμα: "example"

slugΣυμβολοσειρά | nullΥποχρεωτικό

Τμήμα διαδρομής URL στην επιλεγμένη γλώσσα.

Παράδειγμα: "example"

tax_category_idΣυμβολοσειράΥποχρεωτικό

Αναγνωριστικό φορολογικής κατηγορίας.

Παράδειγμα: "example"

updated_atΣυμβολοσειράΥποχρεωτικό

Χρόνος τελευταίας ενημέρωσης.

format: "date-time"

Παράδειγμα: "2026-01-01T12:00:00Z"

variants_enabledΛογική τιμήΥποχρεωτικό

Δείχνει αν το προϊόν χρησιμοποιεί παραλλαγές.

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

versionΑκέραιοςΥποχρεωτικό

Έκδοση πόρου για έλεγχο ταυτόχρονων εγγραφών.

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

Πρόσθετα πεδία: Όχι

brand_idΣυμβολοσειρά | nullΠροαιρετικό

Αναγνωριστικό μάρκας.

Συμβολοσειρά:minLength: 1maxLength: 63

conditionΣυμβολοσειράΠροαιρετικό

Κατάσταση προϊόντος.

Περιορισμοί

enum

["new", "refurbished", "used", "returned", "display", "damaged"]

descriptionΣυμβολοσειρά | nullΠροαιρετικό

Περιγραφή στην επιλεγμένη γλώσσα.

Συμβολοσειρά:maxLength: 100000

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

expected_variant_price_versionsΑντικείμενοΠρόσθετα πεδία: Ακέραιος

minimum: 0maximum: 9223372036854775807

Προαιρετικό

Εκδόσεις τιμών που διαβάστηκαν προηγουμένως, με κλειδί το αναγνωριστικό παραλλαγής.

maxProperties: 250

Περιορισμοί

propertyNames

{"maxLength": 63, "minLength": 1}

expected_versionΑκέραιοςΥποχρεωτικό

Έκδοση που διαβάστηκε πριν από την εγγραφή· αν δεν συμφωνεί, η ενημέρωση απορρίπτεται.

minimum: 1maximum: 9223372036854775807

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

feature_value_idsΠίνακας <Συμβολοσειρά> Προαιρετικό

Αναγνωριστικά επιλεγμένων τιμών χαρακτηριστικού.

maxItems: 1000

Πίνακας:minLength: 1maxLength: 63

identifiersProductIdentifiers | nullΠροαιρετικό

Κωδικοί αναγνώρισης προϊόντος.

market_idsΠίνακας <Συμβολοσειρά> Προαιρετικό

Αναγνωριστικά επιλεγμένων αγορών.

maxItems: 1000

Πίνακας:minLength: 1maxLength: 63

media_idsΠίνακας <Συμβολοσειρά> Προαιρετικό

Αναγνωριστικά ήδη υπαρχόντων αρχείων πολυμέσων.

maxItems: 20

Πίνακας:minLength: 1maxLength: 63

meta_descriptionΣυμβολοσειρά | nullΠροαιρετικό

Περιγραφή για μηχανές αναζήτησης στην επιλεγμένη γλώσσα.

Συμβολοσειρά:maxLength: 160

meta_keywordsΠίνακας <Συμβολοσειρά> | nullΠροαιρετικό

Λέξεις-κλειδιά για μηχανές αναζήτησης στην επιλεγμένη γλώσσα.

Πίνακας:maxItems: 20

Πίνακας / Πίνακας:maxLength: 50

meta_titleΣυμβολοσειρά | nullΠροαιρετικό

Τίτλος για μηχανές αναζήτησης στην επιλεγμένη γλώσσα.

Συμβολοσειρά:maxLength: 70

nameΣυμβολοσειρά | nullΠροαιρετικό

Όνομα πόρου στο σχετικό πλαίσιο.

Συμβολοσειρά:maxLength: 300

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

pricingProductPrice Προαιρετικό

Ρυθμίσεις τιμολόγησης και εκδόσεις ελέγχου ταυτόχρονων εγγραφών.

Παράδειγμα: {"amount":"0.00","currency":"PLN","expected_price_list_version":1,"expected_version":0,"kind":"base","price_list_id":"example","tax_included":true}

primary_category_idΣυμβολοσειρά | nullΠροαιρετικό

Αναγνωριστικό κύριας κατηγορίας.

Συμβολοσειρά:minLength: 1maxLength: 63

publishedΛογική τιμήΠροαιρετικό

Δείχνει αν ο πόρος έχει δημοσιευτεί.

skuΣυμβολοσειράΠροαιρετικό

Κωδικός μονάδας αποθέματος.

minLength: 1maxLength: 100

Περιορισμοί

pattern

"^\\S+$"

Παράδειγμα: "example"

slugΣυμβολοσειρά | nullΠροαιρετικό

Τμήμα διαδρομής URL στην επιλεγμένη γλώσσα.

Συμβολοσειρά:maxLength: 160

tax_category_idΣυμβολοσειρά | nullΠροαιρετικό

Αναγνωριστικό φορολογικής κατηγορίας.

Συμβολοσειρά:minLength: 1maxLength: 63

variant_value_idsΠίνακας <Συμβολοσειρά> Προαιρετικό

Αναγνωριστικά επιλεγμένων τιμών παραλλαγής.

maxItems: 250

Πίνακας:minLength: 1maxLength: 63

variants_enabledΛογική τιμήΠροαιρετικό

Δείχνει αν το προϊόν χρησιμοποιεί παραλλαγές.

Πρόσθετα πεδία: Όχι