Adatsémák: Termékek

dataTömb <ProductSummaryData > Kötelező

Példaválasz · ApiResponse_list_ProductSummaryData__.

Példa: [{"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 Kötelező

A válasz metaadatai.

Példa: {"locale":"en","market_code":"PL","market_id":"example","pagination":{"has_more":false,"limit":20,"next_cursor":null},"request_id":"example"}

További mezők: Nem

dataProductDetailData Kötelező

Példaválasz · ProductDetailData.

Példa: {"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 Kötelező

A válasz metaadatai.

Példa: {"locale":"en","market_code":"PL","market_id":"example","request_id":"example"}

További mezők: Nem

available_fromKarakterlánc | nullKötelező

Az elérhetőség kezdete.

Karakterlánc:format: "date-time"

Példa: null

available_untilKarakterlánc | nullKötelező

Az elérhetőség vége.

Karakterlánc:format: "date-time"

Példa: null

is_availableLogikai értékKötelező

Jelzi, hogy a tétel elérhető-e ebben a környezetben.

Példa: true

További mezők: Nem

amountKarakterláncKötelező

JSON-karakterláncként kódolt tizedes összeg; null csak ott, ahol engedélyezett.

Példa: "0.00"

currencyKarakterláncKötelező

Az összeg pénznemkódja.

Korlátozások

pattern

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

Példa: "PLN"

minor_unitsEgész számKötelező

A pénznem által használt tizedesjegyek száma.

minimum: 0maximum: 4

Példa: 2

tax_includedLogikai értékKötelező

Jelzi, hogy a megadott ár tartalmazza-e az adót.

Példa: true

További mezők: Nem

currencyKarakterláncKötelező

Az összeg pénznemkódja.

idKarakterláncKötelező

Erőforrás-azonosító; a visszaadott alakban őrizze meg. (PriceListData).

tax_includedLogikai értékKötelező

Jelzi, hogy a megadott ár tartalmazza-e az adót.

versionEgész számKötelező

Az erőforrás verziója az egyidejű módosítások ellenőrzéséhez.

További mezők: Nem

brand_idKarakterlánc | nullNem kötelező

Márkaazonosító.

Karakterlánc:minLength: 1maxLength: 63

conditionKarakterláncNem kötelező

A termék állapota.

Korlátozások

enum

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

Alapértelmezett: "new"

descriptionKarakterlánc | nullNem kötelező

Leírás a kiválasztott nyelven.

Karakterlánc:maxLength: 100000

feature_value_idsTömb <Karakterlánc> Nem kötelező

A kiválasztott jellemzőértékek azonosítói.

maxItems: 1000

Tömb:minLength: 1maxLength: 63

identifiersProductIdentifiers | nullNem kötelező

A termék azonosítókódjai.

market_idsTömb <Karakterlánc> Nem kötelező

A kiválasztott piacok azonosítói.

maxItems: 1000

Tömb:minLength: 1maxLength: 63

media_idsTömb <Karakterlánc> Nem kötelező

Már létező médiaelemek azonosítói.

maxItems: 20

Tömb:minLength: 1maxLength: 63

meta_descriptionKarakterlánc | nullNem kötelező

Keresőmotoroknak szánt leírás a kiválasztott nyelven.

Karakterlánc:maxLength: 160

meta_keywordsTömb <Karakterlánc> | nullNem kötelező

Keresőmotoroknak szánt kulcsszavak a kiválasztott nyelven.

Tömb:maxItems: 20

Tömb / Tömb:maxLength: 50

meta_titleKarakterlánc | nullNem kötelező

Keresőmotoroknak szánt cím a kiválasztott nyelven.

Karakterlánc:maxLength: 70

nameKarakterláncKötelező

Az erőforrás neve az adott környezetben.

minLength: 1maxLength: 300

Példa: "Example"

pricingProductPrice Nem kötelező

Árbeállítások és a hozzájuk tartozó verzióértékek.

primary_category_idKarakterlánc | nullNem kötelező

Az elsődleges kategória azonosítója.

Karakterlánc:minLength: 1maxLength: 63

publishedLogikai értékNem kötelező

Jelzi, hogy az erőforrás közzé van-e téve.

Alapértelmezett: false

skuKarakterláncKötelező

Készletnyilvántartási cikkszám.

minLength: 1maxLength: 100

Korlátozások

pattern

"^\\S+$"

Példa: "example"

slugKarakterlánc | nullNem kötelező

URL-útvonalszegmens a kiválasztott nyelven.

Karakterlánc:maxLength: 160

tax_category_idKarakterlánc | nullNem kötelező

Adókategória-azonosító.

Karakterlánc:minLength: 1maxLength: 63

variant_value_idsTömb <Karakterlánc> Nem kötelező

A kiválasztott variánsértékek azonosítói.

maxItems: 250

Tömb:minLength: 1maxLength: 63

variants_enabledLogikai értékNem kötelező

Jelzi, hogy a termék használ-e variánsokat.

Alapértelmezett: false

További mezők: Nem

availabilityAvailabilityData Kötelező

Elérhetőségi adatok a kiválasztott környezetben.

Példa: {"available_from":null,"available_until":null,"is_available":true}

brand_idKarakterlánc | nullKötelező

Márkaazonosító.

Példa: null

conditionKarakterláncKötelező

A termék állapota.

Korlátozások

enum

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

Példa: "new"

created_atKarakterláncKötelező

A létrehozás időpontja.

format: "date-time"

Példa: "2026-01-01T12:00:00Z"

descriptionKarakterlánc | nullKötelező

Leírás a kiválasztott nyelven.

Példa: "example"

featuresTömb <FeatureSelectionData > Kötelező

Termékjellemzők.

Példa: [{"feature_id":"example","feature_name":"example","value":"example","value_id":"example"}]

idKarakterláncKötelező

Erőforrás-azonosító; a visszaadott alakban őrizze meg. (ProductDetailData).

Példa: "example"

identifiersObjektumTovábbi mezők: KarakterláncKötelező

A termék azonosítókódjai.

Példa: {}

mediaTömb <ProductMediaData > Kötelező

A csatolt média adatai.

Példa: [{"alt_text":"example","id":"example","is_primary":true,"kind":"image","mime_type":"image/jpeg","position":1,"url":"https://example.invalid/product.jpg"}]

meta_descriptionKarakterlánc | nullKötelező

Keresőmotoroknak szánt leírás a kiválasztott nyelven.

Példa: "example"

meta_keywordsTömb <Karakterlánc> | nullKötelező

Keresőmotoroknak szánt kulcsszavak a kiválasztott nyelven.

Példa: ["example"]

meta_titleKarakterlánc | nullKötelező

Keresőmotoroknak szánt cím a kiválasztott nyelven.

Példa: "example"

nameKarakterlánc | nullKötelező

Az erőforrás neve az adott környezetben.

Példa: "Example"

numberKarakterláncKötelező

A rendelés vagy bejelentés felhasználóknak szánt száma.

Példa: "example"

pricePriceData | nullKötelező

Áradatok a kiválasztott környezetben.

Példa: {"amount":"0.00","currency":"PLN","minor_units":2,"tax_included":true}

price_versionEgész számKötelező

Az ár aktuális verziója az egyidejű módosítások ellenőrzéséhez.

Példa: 1

primary_category_idKarakterlánc | nullKötelező

Az elsődleges kategória azonosítója.

Példa: "example"

primary_media_idKarakterlánc | nullKötelező

Az elsődleges médiaelem azonosítója.

Példa: "example"

publishedLogikai értékKötelező

Jelzi, hogy az erőforrás közzé van-e téve.

Példa: false

skuKarakterláncKötelező

Készletnyilvántartási cikkszám.

Példa: "example"

slugKarakterlánc | nullKötelező

URL-útvonalszegmens a kiválasztott nyelven.

Példa: "example"

tax_category_idKarakterláncKötelező

Adókategória-azonosító.

Példa: "example"

updated_atKarakterláncKötelező

A legutóbbi módosítás időpontja.

format: "date-time"

Példa: "2026-01-01T12:00:00Z"

variants_enabledLogikai értékKötelező

Jelzi, hogy a termék használ-e variánsokat.

Példa: false

versionEgész számKötelező

Az erőforrás verziója az egyidejű módosítások ellenőrzéséhez.

Példa: 1

További mezők: Nem

eanKarakterlánc | nullNem kötelező

A termék EAN-azonosítója.

Karakterlánc:minLength: 1maxLength: 100

isbnKarakterlánc | nullNem kötelező

ISBN-azonosító.

Karakterlánc:minLength: 1maxLength: 100

mpnKarakterlánc | nullNem kötelező

Gyártói cikkszám.

Karakterlánc:minLength: 1maxLength: 100

upcKarakterlánc | nullNem kötelező

A termék UPC-azonosítója.

Karakterlánc:minLength: 1maxLength: 100

További mezők: Nem

alt_textKarakterlánc | nullKötelező

A kép alternatív szövege.

Példa: "example"

idKarakterláncKötelező

Erőforrás-azonosító; a visszaadott alakban őrizze meg. (ProductMediaData).

Példa: "example"

is_primaryLogikai értékKötelező

Jelzi, hogy ez az elsődleges elem-e.

Példa: true

kindKarakterláncKötelező

Az adatstruktúra változata, a megengedett értékek szerint.

Korlátozások

enum

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

Példa: "image"

mime_typeKarakterláncKötelező

A média tartalomtípusa.

Példa: "image/jpeg"

positionEgész számKötelező

Pozíció a rendezett gyűjteményben.

Példa: 1

urlKarakterlánc | nullKötelező

Az erőforrás URL-je.

Példa: "https://example.invalid/product.jpg"

További mezők: Nem

amountKarakterlánc | nullKötelező

JSON-karakterláncként kódolt tizedes összeg; null csak ott, ahol engedélyezett.

Karakterlánc:maxLength: 19

Korlátozások · Karakterlánc 1

pattern

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

Példa: "0.00"

currencyKarakterláncKötelező

Az összeg pénznemkódja.

Korlátozások

pattern

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

Példa: "PLN"

expected_price_list_versionEgész számKötelező

Az íráshoz szükséges, korábban kiolvasott árlistaverzió.

minimum: 1maximum: 9223372036854775807

Példa: 1

expected_versionEgész számKötelező

Az írás előtt kiolvasott verzió; eltérés esetén a módosítás elutasításra kerül.

minimum: 0maximum: 9223372036854775807

Példa: 0

kindKarakterláncKötelező

Az adatstruktúra változata, a megengedett értékek szerint.

Korlátozások

enum

["base", "market_fixed"]

Példa: "base"

price_list_idKarakterláncKötelező

Árlista-azonosító.

minLength: 1maxLength: 63

Példa: "example"

tax_includedLogikai értékKötelező

Jelzi, hogy a megadott ár tartalmazza-e az adót.

Példa: true

További mezők: Nem

availabilityAvailabilityData Kötelező

Elérhetőségi adatok a kiválasztott környezetben.

Példa: {"available_from":null,"available_until":null,"is_available":true}

brand_idKarakterlánc | nullKötelező

Márkaazonosító.

Példa: null

conditionKarakterláncKötelező

A termék állapota.

Korlátozások

enum

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

Példa: "new"

created_atKarakterláncKötelező

A létrehozás időpontja.

format: "date-time"

Példa: "2026-01-01T12:00:00Z"

idKarakterláncKötelező

Erőforrás-azonosító; a visszaadott alakban őrizze meg. (ProductSummaryData).

Példa: "example"

nameKarakterlánc | nullKötelező

Az erőforrás neve az adott környezetben.

Példa: "Example"

numberKarakterláncKötelező

A rendelés vagy bejelentés felhasználóknak szánt száma.

Példa: "example"

pricePriceData | nullKötelező

Áradatok a kiválasztott környezetben.

Példa: {"amount":"0.00","currency":"PLN","minor_units":2,"tax_included":true}

price_versionEgész számKötelező

Az ár aktuális verziója az egyidejű módosítások ellenőrzéséhez.

Példa: 1

primary_category_idKarakterlánc | nullKötelező

Az elsődleges kategória azonosítója.

Példa: "example"

primary_media_idKarakterlánc | nullKötelező

Az elsődleges médiaelem azonosítója.

Példa: "example"

publishedLogikai értékKötelező

Jelzi, hogy az erőforrás közzé van-e téve.

Példa: false

skuKarakterláncKötelező

Készletnyilvántartási cikkszám.

Példa: "example"

slugKarakterlánc | nullKötelező

URL-útvonalszegmens a kiválasztott nyelven.

Példa: "example"

tax_category_idKarakterláncKötelező

Adókategória-azonosító.

Példa: "example"

updated_atKarakterláncKötelező

A legutóbbi módosítás időpontja.

format: "date-time"

Példa: "2026-01-01T12:00:00Z"

variants_enabledLogikai értékKötelező

Jelzi, hogy a termék használ-e variánsokat.

Példa: false

versionEgész számKötelező

Az erőforrás verziója az egyidejű módosítások ellenőrzéséhez.

Példa: 1

További mezők: Nem

brand_idKarakterlánc | nullNem kötelező

Márkaazonosító.

Karakterlánc:minLength: 1maxLength: 63

conditionKarakterláncNem kötelező

A termék állapota.

Korlátozások

enum

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

descriptionKarakterlánc | nullNem kötelező

Leírás a kiválasztott nyelven.

Karakterlánc:maxLength: 100000

Példa: null

expected_variant_price_versionsObjektumTovábbi mezők: Egész szám

minimum: 0maximum: 9223372036854775807

Nem kötelező

Korábban kiolvasott árverziók, variánsazonosító szerint indexelve.

maxProperties: 250

Korlátozások

propertyNames

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

expected_versionEgész számKötelező

Az írás előtt kiolvasott verzió; eltérés esetén a módosítás elutasításra kerül.

minimum: 1maximum: 9223372036854775807

Példa: 1

feature_value_idsTömb <Karakterlánc> Nem kötelező

A kiválasztott jellemzőértékek azonosítói.

maxItems: 1000

Tömb:minLength: 1maxLength: 63

identifiersProductIdentifiers | nullNem kötelező

A termék azonosítókódjai.

market_idsTömb <Karakterlánc> Nem kötelező

A kiválasztott piacok azonosítói.

maxItems: 1000

Tömb:minLength: 1maxLength: 63

media_idsTömb <Karakterlánc> Nem kötelező

Már létező médiaelemek azonosítói.

maxItems: 20

Tömb:minLength: 1maxLength: 63

meta_descriptionKarakterlánc | nullNem kötelező

Keresőmotoroknak szánt leírás a kiválasztott nyelven.

Karakterlánc:maxLength: 160

meta_keywordsTömb <Karakterlánc> | nullNem kötelező

Keresőmotoroknak szánt kulcsszavak a kiválasztott nyelven.

Tömb:maxItems: 20

Tömb / Tömb:maxLength: 50

meta_titleKarakterlánc | nullNem kötelező

Keresőmotoroknak szánt cím a kiválasztott nyelven.

Karakterlánc:maxLength: 70

nameKarakterlánc | nullNem kötelező

Az erőforrás neve az adott környezetben.

Karakterlánc:maxLength: 300

Példa: null

pricingProductPrice Nem kötelező

Árbeállítások és a hozzájuk tartozó verzióértékek.

Példa: {"amount":"0.00","currency":"PLN","expected_price_list_version":1,"expected_version":0,"kind":"base","price_list_id":"example","tax_included":true}

primary_category_idKarakterlánc | nullNem kötelező

Az elsődleges kategória azonosítója.

Karakterlánc:minLength: 1maxLength: 63

publishedLogikai értékNem kötelező

Jelzi, hogy az erőforrás közzé van-e téve.

skuKarakterláncNem kötelező

Készletnyilvántartási cikkszám.

minLength: 1maxLength: 100

Korlátozások

pattern

"^\\S+$"

Példa: "example"

slugKarakterlánc | nullNem kötelező

URL-útvonalszegmens a kiválasztott nyelven.

Karakterlánc:maxLength: 160

tax_category_idKarakterlánc | nullNem kötelező

Adókategória-azonosító.

Karakterlánc:minLength: 1maxLength: 63

variant_value_idsTömb <Karakterlánc> Nem kötelező

A kiválasztott variánsértékek azonosítói.

maxItems: 250

Tömb:minLength: 1maxLength: 63

variants_enabledLogikai értékNem kötelező

Jelzi, hogy a termék használ-e variánsokat.

További mezők: Nem