Adatsémák: Termékek

Adatsémák: Termékek. Az API által fogadott vagy visszaadott adatok mezői, típusai és korlátozásai.

Adatsémák

ApiResponse_ProductFileListData_

ApiResponse_ProductFileListData_ · Az API által fogadott vagy visszaadott adatok mezői, típusai és korlátozásai. Az upload_id létrehozása után küldje a fájlokat multipart/form-data formátumban, majd rendelje a termékhez. A letöltéshez Bearer-token és a category szerinti jogosultság szükséges; a válasz a fájl bájtjait tartalmazza nyilvános cím és jelszó nélkül. A mode=period esetén days (1–3650) vagy a korábbi months adható meg, egyszerre mindkettő nem. A feltételek vásárláskor rögzülnek; a visszatérítés csak az érintett tétel hozzáférését vonja vissza.

dataProductFileListData Kötelező: A sikeres válasz adatai.

Példa: {"files":[{"category":"digital","created_at":"2026-01-01T12:00:00Z","current_version_id":"00000000-0000-4000-8000-000000000001","file_id":"00000000-0000-4000-8000-000000000001","filename":"manual.pdf","id":"00000000-0000-4000-8000-000000000001","label":"Manual","mime_type":"application/pdf","sha256":"5cd2f1cb0e5532b397e7ab1887baf6000c49450fd80ae279eb047c06e4545ecd","size_bytes":46,"state":"active","version_number":1}],"product_version":2}
metaContextPageMeta ContextMeta PageMeta RequestMeta Kötelező: A válasz metaadatai.

Példa: {"pagination":{"has_more":false,"limit":50,"next_cursor":null},"request_id":"example"}

További mezők: Nem

ApiResponse_ReleaseListData_

ApiResponse_ReleaseListData_ · Az API által fogadott vagy visszaadott adatok mezői, típusai és korlátozásai. Az upload_id létrehozása után küldje a fájlokat multipart/form-data formátumban, majd rendelje a termékhez. A letöltéshez Bearer-token és a category szerinti jogosultság szükséges; a válasz a fájl bájtjait tartalmazza nyilvános cím és jelszó nélkül. A mode=period esetén days (1–3650) vagy a korábbi months adható meg, egyszerre mindkettő nem. A feltételek vásárláskor rögzülnek; a visszatérítés csak az érintett tétel hozzáférését vonja vissza.

dataReleaseListData Kötelező: A sikeres válasz adatai.

Példa: {"current_release_id":"00000000-0000-4000-8000-000000000001","product_version":2,"releases":[{"changelog":"Manual update","files":[{"file_id":"00000000-0000-4000-8000-000000000001","sort_order":0,"version_id":"00000000-0000-4000-8000-000000000001"}],"id":"00000000-0000-4000-8000-000000000001","manifest_sha256":"1111111111111111111111111111111111111111111111111111111111111111","published_at":null,"release_sequence":null,"state":"active","version_label":"1.0","withdrawn_at":null}],"update_days":365,"update_mode":"period","update_months":null}
metaContextPageMeta ContextMeta PageMeta RequestMeta Kötelező: A válasz metaadatai.

Példa: {"pagination":{"has_more":false,"limit":50,"next_cursor":null},"request_id":"example"}

További mezők: Nem

ApiResponse_UploadData_

ApiResponse_UploadData_ · Az API által fogadott vagy visszaadott adatok mezői, típusai és korlátozásai. Az upload_id létrehozása után küldje a fájlokat multipart/form-data formátumban, majd rendelje a termékhez. A letöltéshez Bearer-token és a category szerinti jogosultság szükséges; a válasz a fájl bájtjait tartalmazza nyilvános cím és jelszó nélkül. A mode=period esetén days (1–3650) vagy a korábbi months adható meg, egyszerre mindkettő nem. A feltételek vásárláskor rögzülnek; a visszatérítés csak az érintett tétel hozzáférését vonja vissza.

dataUploadData Kötelező: A sikeres válasz adatai.

Példa: {"category":"digital","expires_at":"2026-01-01T12:00:00Z","filename":"manual.pdf","id":"00000000-0000-4000-8000-000000000001","product_id":"example","received_bytes":46,"sha256":"5cd2f1cb0e5532b397e7ab1887baf6000c49450fd80ae279eb047c06e4545ecd","size_bytes":46,"status":"ready"}
metaContextPageMeta ContextMeta PageMeta RequestMeta Kötelező: A válasz metaadatai.

Példa: {"request_id":"example"}

További mezők: Nem

ApiResponse[AudienceData]

ApiResponse_AudienceData_ · Olvasd be a hozzáférési szabályt és termékverziót. Az első közzététel marad az időbeli viszonyítási pont.

dataAudienceData Kötelező: A sikeres válasz adatai.

Példa: {"anchor_at":"2026-11-03T12:00:00Z","effective_at":"2026-11-03T12:00:00Z","file_id":"00000000-0000-4000-8000-000000000007","file_version_id":"00000000-0000-4000-8000-000000000010","historical_access_preserved":true,"id":"00000000-0000-4000-8000-000000000009","lookback_days":null,"mode":"all_purchasers","next_cursor":null,"order_ids":[],"product_version":3,"revision":1}
metaContextPageMeta ContextMeta PageMeta RequestMeta Kötelező: A válasz metaadatai.

Példa: {"request_id":"example-request"}

További mezők: Nem

Listázás — Termékek — Válasz

ApiResponse_list_ProductSummaryData__ · Az API által fogadott vagy visszaadott adatok mezői, típusai és korlátozásai.

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

Lekérés — Termékek — Válasz

ApiResponse_ProductDetailData_ · Az API által fogadott vagy visszaadott adatok mezői, típusai és korlátozásai.

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

AudienceChange

AudienceChange · Válassz jogosult vásárlásokat. A kijelölt rendeléseknek kifizetett, vissza nem térített terméket kell tartalmazniuk.

audienceAudienceSelection Kötelező: A megosztott fájl kifejezett hozzáférési szabálya.

Példa: {"mode":"all_purchasers"}
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

További mezők: Nem

AudienceData

AudienceData · Olvasd be a hozzáférési szabályt és termékverziót. Az első közzététel marad az időbeli viszonyítási pont.

anchor_atKarakterláncKötelező: Első közzététel; szabálymódosításkor nem változik.

format: "date-time"

Példa: "2026-11-03T12:00:00Z"
effective_atKarakterláncKötelező: A hozzáférési szabály közzétételi ideje.

format: "date-time"

Példa: "2026-11-03T12:00:00Z"
file_idKarakterláncKötelező: Erőforrás-azonosító; a visszaadott alakban őrizze meg. · file_id

Példa: "00000000-0000-4000-8000-000000000007"
file_version_idKarakterláncKötelező: Egy változtathatatlan fájlverzió azonosítója.

Példa: "00000000-0000-4000-8000-000000000010"
historical_access_preservedLogikai értékNem kötelező: A korábban megadott jogok a szabály szűkítésekor is megmaradnak.

Alapértelmezett: truePélda: true
idKarakterláncKötelező: Erőforrás-azonosító; a visszaadott alakban őrizze meg.

Példa: "00000000-0000-4000-8000-000000000009"
lookback_daysEgész szám nullKötelező: 1–3650 nap az első közzététel előtt; csak recent_and_new.

Példa: null
modeKarakterláncKötelező: A megosztott fájl kifejezett hozzáférési szabálya. new_purchases / recent_and_new / selected / all_purchasers.

Példa: "all_purchasers"
next_cursorKarakterlánc nullKötelező: A következő oldal folytatási értéke, vagy null.

Példa: null
order_idsTömb <Karakterlánc> Kötelező: Olyan rendelések, amelyekben ez a termék kifizetett és nem visszatérített.

Példa: []
product_versionEgész számKötelező: A termék aktuális verziója az egyidejű módosítások ellenőrzéséhez.

Példa: 3
revisionEgész számKötelező: A hozzáférési szabály soron következő revíziója.

Példa: 1

További mezők: Nem

AudienceSelection

AudienceSelection · Válassz jogosult vásárlásokat. A kijelölt rendeléseknek kifizetett, vissza nem térített terméket kell tartalmazniuk.

lookback_daysEgész szám nullNem kötelező

1–3650 nap az első közzététel előtt; csak recent_and_new.

Egész szám:minimum: 1maximum: 3650

modeKarakterláncKötelező

A megosztott fájl kifejezett hozzáférési szabálya. new_purchases / recent_and_new / selected / all_purchasers.

Korlátozások

enum: ["new_purchases", "recent_and_new", "selected", "all_purchasers"]

Példa: "new_purchases"

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

Olyan rendelések, amelyekben ez a termék kifizetett és nem visszatérített.

maxItems: 1000

Korlátozások · Tömb 1

pattern: "^[a-z0-9][a-z0-9_-]{0,62}$"

Alapértelmezett: []

További mezők: Nem

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

AvailabilityData · Séma · Adatsémák: Termékek

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

FileAssign

FileAssign · Az API által fogadott vagy visszaadott adatok mezői, típusai és korlátozásai. Az upload_id létrehozása után küldje a fájlokat multipart/form-data formátumban, majd rendelje a termékhez. A letöltéshez Bearer-token és a category szerinti jogosultság szükséges; a válasz a fájl bájtjait tartalmazza nyilvános cím és jelszó nélkül. A mode=period esetén days (1–3650) vagy a korábbi months adható meg, egyszerre mindkettő nem. A feltételek vásárláskor rögzülnek; a visszatérítés csak az érintett tétel hozzáférését vonja vissza.

audienceAudienceSelection nullNem kötelező: A megosztott fájl kifejezett hozzáférési szabálya.

Példa: {"mode":"new_purchases"}
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
labelKarakterláncNem kötelező: Az erőforrás neve az adott környezetben.

maxLength: 300

Alapértelmezett: ""
upload_idKarakterláncKötelező: Erőforrás-azonosító; a visszaadott alakban őrizze meg. · upload_id

format: "uuid"

Példa: "00000000-0000-4000-8000-000000000001"

További mezők: Nem

FileCategory

FileCategory · Az API által fogadott vagy visszaadott adatok mezői, típusai és korlátozásai. Az upload_id létrehozása után küldje a fájlokat multipart/form-data formátumban, majd rendelje a termékhez. A letöltéshez Bearer-token és a category szerinti jogosultság szükséges; a válasz a fájl bájtjait tartalmazza nyilvános cím és jelszó nélkül. A mode=period esetén days (1–3650) vagy a korábbi months adható meg, egyszerre mindkettő nem. A feltételek vásárláskor rögzülnek; a visszatérítés csak az érintett tétel hozzáférését vonja vissza.

Karakterlánc

Korlátozások

enum: ["internal", "customer_document", "digital"]

További mezők: Igen

Áradatok a kiválasztott környezetben

PriceData · Séma · Adatsémák: Termékek

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

Árlistaadatok

PriceListData · Séma · Adatsémák: Termékek

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

Létrehozás — Termékek — Kérés törzse

ProductCreate · Az API által fogadott vagy visszaadott adatok mezői, típusai és korlátozásai.

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: 30

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

Lekérés — Termékek — Válasz

ProductDetailData · Az API által fogadott vagy visszaadott adatok mezői, típusai és korlátozásai.

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

ProductFileData

ProductFileData · Az API által fogadott vagy visszaadott adatok mezői, típusai és korlátozásai. Az upload_id létrehozása után küldje a fájlokat multipart/form-data formátumban, majd rendelje a termékhez. A letöltéshez Bearer-token és a category szerinti jogosultság szükséges; a válasz a fájl bájtjait tartalmazza nyilvános cím és jelszó nélkül. A mode=period esetén days (1–3650) vagy a korábbi months adható meg, egyszerre mindkettő nem. A feltételek vásárláskor rögzülnek; a visszatérítés csak az érintett tétel hozzáférését vonja vissza.

categoryFileCategory Kötelező: Fájlkategória: internal / customer_document / digital

Példa: "digital"
created_atKarakterláncKötelező: A létrehozás időpontja.

format: "date-time"

Példa: "2026-01-01T12:00:00Z"
current_version_idKarakterláncKötelező: Erőforrás-azonosító; a visszaadott alakban őrizze meg. · current_version_id

format: "uuid"

Példa: "00000000-0000-4000-8000-000000000001"
file_idKarakterláncKötelező: Erőforrás-azonosító; a visszaadott alakban őrizze meg. · file_id

format: "uuid"

Példa: "00000000-0000-4000-8000-000000000001"
filenameKarakterláncKötelező: Fájl

Példa: "manual.pdf"
idKarakterláncKötelező: Erőforrás-azonosító; a visszaadott alakban őrizze meg.

format: "uuid"

Példa: "00000000-0000-4000-8000-000000000001"
labelKarakterláncKötelező: Az erőforrás neve az adott környezetben.

Példa: "Manual"
mime_typeKarakterláncKötelező: A média tartalomtípusa.

Példa: "application/pdf"
sha256KarakterláncKötelező: SHA-256 (hex, 64)

Példa: "5cd2f1cb0e5532b397e7ab1887baf6000c49450fd80ae279eb047c06e4545ecd"
size_bytesEgész számKötelező: Méret bájtban

Példa: 46
stateKarakterláncKötelező: Állapot

Példa: "active"
version_numberEgész számKötelező: Verzió

Példa: 1

További mezők: Nem

ProductFileListData

ProductFileListData · Az API által fogadott vagy visszaadott adatok mezői, típusai és korlátozásai. Az upload_id létrehozása után küldje a fájlokat multipart/form-data formátumban, majd rendelje a termékhez. A letöltéshez Bearer-token és a category szerinti jogosultság szükséges; a válasz a fájl bájtjait tartalmazza nyilvános cím és jelszó nélkül. A mode=period esetén days (1–3650) vagy a korábbi months adható meg, egyszerre mindkettő nem. A feltételek vásárláskor rögzülnek; a visszatérítés csak az érintett tétel hozzáférését vonja vissza.

filesTömb <ProductFileData > Kötelező: Termékfájlok

Példa: [{"category":"digital","created_at":"2026-01-01T12:00:00Z","current_version_id":"00000000-0000-4000-8000-000000000001","file_id":"00000000-0000-4000-8000-000000000001","filename":"manual.pdf","id":"00000000-0000-4000-8000-000000000001","label":"Manual","mime_type":"application/pdf","sha256":"5cd2f1cb0e5532b397e7ab1887baf6000c49450fd80ae279eb047c06e4545ecd","size_bytes":46,"state":"active","version_number":1}]
product_versionEgész számKötelező: A termék aktuális verziója az egyidejű módosítások ellenőrzéséhez.

Példa: 2

További mezők: Nem

A termék azonosítókódjai

ProductIdentifiers · Séma · Adatsémák: Termékek

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

A csatolt média adatai

ProductMediaData · Séma · Adatsémák: Termékek

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

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

ProductPrice · Séma · Adatsémák: Termékek

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

Listázás — Termékek — Válasz

ProductSummaryData · Az API által fogadott vagy visszaadott adatok mezői, típusai és korlátozásai.

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

Módosítás — Termékek — Kérés törzse

ProductUpdate · Az API által fogadott vagy visszaadott adatok mezői, típusai és korlátozásai.

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: 30

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

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

ProductVersion

ProductVersion · Ez a művelet megszűnt, és adatváltoztatás nélkül 409-et ad vissza. Minden digitális fájl hozzáférését a címzettek kiválasztásával állítsd be.

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

További mezők: Nem

ReleaseData

ReleaseData · Az API által fogadott vagy visszaadott adatok mezői, típusai és korlátozásai. Az upload_id létrehozása után küldje a fájlokat multipart/form-data formátumban, majd rendelje a termékhez. A letöltéshez Bearer-token és a category szerinti jogosultság szükséges; a válasz a fájl bájtjait tartalmazza nyilvános cím és jelszó nélkül. A mode=period esetén days (1–3650) vagy a korábbi months adható meg, egyszerre mindkettő nem. A feltételek vásárláskor rögzülnek; a visszatérítés csak az érintett tétel hozzáférését vonja vissza.

changelogKarakterláncKötelező: Változások leírása

Példa: "Manual update"
filesTömb <ReleaseFileData > Kötelező: Termékfájlok

Példa: [{"file_id":"00000000-0000-4000-8000-000000000001","sort_order":0,"version_id":"00000000-0000-4000-8000-000000000001"}]
idKarakterláncKötelező: Erőforrás-azonosító; a visszaadott alakban őrizze meg.

format: "uuid"

Példa: "00000000-0000-4000-8000-000000000001"
manifest_sha256Karakterlánc nullKötelező: Digitális kiadások · SHA-256

Példa: "1111111111111111111111111111111111111111111111111111111111111111"
published_atKarakterlánc nullKötelező: Kiadás közzététele · UTC

Karakterlánc:format: "date-time"

Példa: null
release_sequenceEgész szám nullKötelező: Digitális kiadások · Pozíció a rendezett gyűjteményben.

Példa: null
stateKarakterláncKötelező: Állapot

Példa: "active"
version_labelKarakterláncKötelező: Verzió

Példa: "1.0"
withdrawn_atKarakterlánc nullKötelező: Ajánlat visszavonása · UTC

Karakterlánc:format: "date-time"

Példa: null

További mezők: Nem

ReleaseDraft

ReleaseDraft · Ez a művelet megszűnt, és adatváltoztatás nélkül 409-et ad vissza. Minden digitális fájl hozzáférését a címzettek kiválasztásával állítsd be.

changelogKarakterláncNem kötelező: Változások leírása

maxLength: 20000

Alapértelmezett: ""
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
version_idsTömb <Karakterlánc> Kötelező: Verzió · UUID[]

minItems: 1maxItems: 20
Tömb:format: "uuid"

Példa: ["00000000-0000-4000-8000-000000000001"]
version_labelKarakterláncKötelező: Verzió

minLength: 1maxLength: 64

Példa: "1.0"

További mezők: Nem

ReleaseFileData

ReleaseFileData · Az API által fogadott vagy visszaadott adatok mezői, típusai és korlátozásai. Az upload_id létrehozása után küldje a fájlokat multipart/form-data formátumban, majd rendelje a termékhez. A letöltéshez Bearer-token és a category szerinti jogosultság szükséges; a válasz a fájl bájtjait tartalmazza nyilvános cím és jelszó nélkül. A mode=period esetén days (1–3650) vagy a korábbi months adható meg, egyszerre mindkettő nem. A feltételek vásárláskor rögzülnek; a visszatérítés csak az érintett tétel hozzáférését vonja vissza.

file_idKarakterláncKötelező: Erőforrás-azonosító; a visszaadott alakban őrizze meg. · file_id

format: "uuid"

Példa: "00000000-0000-4000-8000-000000000001"
sort_orderEgész számKötelező: Pozíció a rendezett gyűjteményben.

Példa: 0
version_idKarakterláncKötelező: Erőforrás-azonosító; a visszaadott alakban őrizze meg. · version_id

format: "uuid"

Példa: "00000000-0000-4000-8000-000000000001"

További mezők: Nem

ReleaseListData

ReleaseListData · Az API által fogadott vagy visszaadott adatok mezői, típusai és korlátozásai. Az upload_id létrehozása után küldje a fájlokat multipart/form-data formátumban, majd rendelje a termékhez. A letöltéshez Bearer-token és a category szerinti jogosultság szükséges; a válasz a fájl bájtjait tartalmazza nyilvános cím és jelszó nélkül. A mode=period esetén days (1–3650) vagy a korábbi months adható meg, egyszerre mindkettő nem. A feltételek vásárláskor rögzülnek; a visszatérítés csak az érintett tétel hozzáférését vonja vissza.

current_release_idKarakterlánc nullKötelező: Erőforrás-azonosító; a visszaadott alakban őrizze meg. · current_release_id

Karakterlánc:format: "uuid"

Példa: "00000000-0000-4000-8000-000000000001"
product_versionEgész számKötelező: A termék aktuális verziója az egyidejű módosítások ellenőrzéséhez.

Példa: 2
releasesTömb <ReleaseData > Kötelező: Digitális kiadások

Példa: [{"changelog":"Manual update","files":[{"file_id":"00000000-0000-4000-8000-000000000001","sort_order":0,"version_id":"00000000-0000-4000-8000-000000000001"}],"id":"00000000-0000-4000-8000-000000000001","manifest_sha256":"1111111111111111111111111111111111111111111111111111111111111111","published_at":null,"release_sequence":null,"state":"active","version_label":"1.0","withdrawn_at":null}]
update_daysEgész szám nullKötelező: Napok száma (days; null)

Példa: 365
update_modeKarakterláncKötelező: Hozzáférés a jövőbeli fájlokhoz vásárlás után: none / period / unlimited

Példa: "period"
update_monthsEgész szám nullKötelező: Hónapok (months; null)

Példa: null

További mezők: Nem

UpdatePolicy

UpdatePolicy · Ez a művelet megszűnt, és adatváltoztatás nélkül 409-et ad vissza. Minden digitális fájl hozzáférését a címzettek kiválasztásával állítsd be.

daysEgész szám nullNem kötelező

Napok száma (1–3650; mode=period; months=null)

Egész szám:minimum: 1maximum: 3650

Példa: 365

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

modeKarakterláncKötelező

Hozzáférés a jövőbeli fájlokhoz vásárlás után: none / period / unlimited

Korlátozások

enum: ["none", "period", "unlimited"]

Példa: "period"

monthsEgész szám nullNem kötelező

Hónapok (1–120; mode=period; days=null)

Egész szám:minimum: 1maximum: 120

Példa: null

További mezők: Nem

UploadCreate

UploadCreate · Az API által fogadott vagy visszaadott adatok mezői, típusai és korlátozásai. Az upload_id létrehozása után küldje a fájlokat multipart/form-data formátumban, majd rendelje a termékhez. A letöltéshez Bearer-token és a category szerinti jogosultság szükséges; a válasz a fájl bájtjait tartalmazza nyilvános cím és jelszó nélkül. A mode=period esetén days (1–3650) vagy a korábbi months adható meg, egyszerre mindkettő nem. A feltételek vásárláskor rögzülnek; a visszatérítés csak az érintett tétel hozzáférését vonja vissza.

filenameKarakterláncKötelező

Fájl

minLength: 1maxLength: 255

Példa: "manual.pdf"

product_idKarakterlánc nullNem kötelező

Termékazonosító.

Korlátozások · Karakterlánc 1

pattern: "^[a-z0-9][a-z0-9_-]{0,62}$"

Példa: "example"

sha256KarakterláncKötelező

SHA-256 (hex, 64)

Korlátozások

pattern: "^[0-9a-f]{64}$"

Példa: "5cd2f1cb0e5532b397e7ab1887baf6000c49450fd80ae279eb047c06e4545ecd"

size_bytesEgész számKötelező

Méret bájtban

minimum: 1maximum: 262144000

Példa: 46

További mezők: Nem

UploadData

UploadData · Az API által fogadott vagy visszaadott adatok mezői, típusai és korlátozásai. Az upload_id létrehozása után küldje a fájlokat multipart/form-data formátumban, majd rendelje a termékhez. A letöltéshez Bearer-token és a category szerinti jogosultság szükséges; a válasz a fájl bájtjait tartalmazza nyilvános cím és jelszó nélkül. A mode=period esetén days (1–3650) vagy a korábbi months adható meg, egyszerre mindkettő nem. A feltételek vásárláskor rögzülnek; a visszatérítés csak az érintett tétel hozzáférését vonja vissza.

categoryFileCategory Kötelező: Fájlkategória: internal / customer_document / digital

Példa: "digital"
expires_atKarakterláncKötelező: A hitelesítő adat lejárati dátuma és időpontja.

format: "date-time"

Példa: "2026-01-01T12:00:00Z"
filenameKarakterláncKötelező: Fájl

Példa: "manual.pdf"
idKarakterláncKötelező: Erőforrás-azonosító; a visszaadott alakban őrizze meg.

format: "uuid"

Példa: "00000000-0000-4000-8000-000000000001"
product_idKarakterlánc nullKötelező: Termékazonosító.

Példa: "example"
received_bytesEgész számKötelező: Feltöltés… · Méret bájtban

Példa: 46
sha256KarakterláncKötelező: SHA-256 (hex, 64)

Példa: "5cd2f1cb0e5532b397e7ab1887baf6000c49450fd80ae279eb047c06e4545ecd"
size_bytesEgész számKötelező: Méret bájtban

Példa: 46
statusKarakterláncKötelező: Az adott művelet által elfogadott állapot.

Példa: "ready"

További mezők: Nem