Preskočiť na obsah
ShopentlyLearn

Dátové schémy: Produkty

Dátové schémy: Produkty. Polia, typy a obmedzenia údajov prijímaných alebo vracaných API.

Dátové schémy

ApiResponse_ProductFileListData_

ApiResponse_ProductFileListData_ · Polia, typy a obmedzenia údajov prijímaných alebo vracaných API. Po vytvorení upload_id odošlite súbory ako multipart/form-data a priraďte ich produktu. Stiahnutie vyžaduje token Bearer a oprávnenie pre category; odpoveď obsahuje bajty súboru bez verejnej adresy a hesla. Pre mode=period zvoľte days (1–3650) alebo doterajšie months, nikdy oboje. Podmienky sa uložia pri nákupe; vrátenie peňazí odoberie prístup iba vrátenej položke.
dataProductFileListData Povinné

Obsah úspešnej odpovede.

Príklad: {"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 Povinné

Metaúdaje odpovede.

Príklad: {"pagination":{"has_more":false,"limit":50,"next_cursor":null},"request_id":"example"}

Ďalšie polia: Nie

ApiResponse_ReleaseListData_

ApiResponse_ReleaseListData_ · Polia, typy a obmedzenia údajov prijímaných alebo vracaných API. Po vytvorení upload_id odošlite súbory ako multipart/form-data a priraďte ich produktu. Stiahnutie vyžaduje token Bearer a oprávnenie pre category; odpoveď obsahuje bajty súboru bez verejnej adresy a hesla. Pre mode=period zvoľte days (1–3650) alebo doterajšie months, nikdy oboje. Podmienky sa uložia pri nákupe; vrátenie peňazí odoberie prístup iba vrátenej položke.
dataReleaseListData Povinné

Obsah úspešnej odpovede.

Príklad: {"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 Povinné

Metaúdaje odpovede.

Príklad: {"pagination":{"has_more":false,"limit":50,"next_cursor":null},"request_id":"example"}

Ďalšie polia: Nie

ApiResponse_UploadData_

ApiResponse_UploadData_ · Polia, typy a obmedzenia údajov prijímaných alebo vracaných API. Po vytvorení upload_id odošlite súbory ako multipart/form-data a priraďte ich produktu. Stiahnutie vyžaduje token Bearer a oprávnenie pre category; odpoveď obsahuje bajty súboru bez verejnej adresy a hesla. Pre mode=period zvoľte days (1–3650) alebo doterajšie months, nikdy oboje. Podmienky sa uložia pri nákupe; vrátenie peňazí odoberie prístup iba vrátenej položke.
dataUploadData Povinné

Obsah úspešnej odpovede.

Príklad: {"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 Povinné

Metaúdaje odpovede.

Príklad: {"request_id":"example"}

Ďalšie polia: Nie

ApiResponse[AudienceData]

ApiResponse_AudienceData_ · Načítajte pravidlo prístupu a verziu produktu. Prvé zverejnenie zostáva časovým bodom.
dataAudienceData Povinné

Obsah úspešnej odpovede.

Príklad: {"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 Povinné

Metaúdaje odpovede.

Príklad: {"request_id":"example-request"}

Ďalšie polia: Nie

Zobraziť zoznam — Produkty — Odpoveď

ApiResponse_list_ProductSummaryData__ · Polia, typy a obmedzenia údajov prijímaných alebo vracaných API.
dataPole <ProductSummaryData > Povinné

Príklad odpovede · ApiResponse_list_ProductSummaryData__.

Príklad: [{"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 Povinné

Metaúdaje odpovede.

Príklad: {"locale":"en","market_code":"PL","market_id":"example","pagination":{"has_more":false,"limit":20,"next_cursor":null},"request_id":"example"}

Ďalšie polia: Nie

Načítať — Produkty — Odpoveď

ApiResponse_ProductDetailData_ · Polia, typy a obmedzenia údajov prijímaných alebo vracaných API.
dataProductDetailData Povinné

Príklad odpovede · ProductDetailData.

Príklad: {"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 Povinné

Metaúdaje odpovede.

Príklad: {"locale":"en","market_code":"PL","market_id":"example","request_id":"example"}

Ďalšie polia: Nie

AudienceChange

AudienceChange · Vyberte oprávnené nákupy. Zvolené objednávky musia obsahovať tento produkt zaplatený a nevrátený.
audienceAudienceSelection Povinné

Výslovné pravidlo prístupu k zdieľanému súboru.

Príklad: {"mode":"all_purchasers"}
expected_versionCelé čísloPovinné

Verzia načítaná pred zápisom; pri nezhode sa aktualizácia odmietne.

minimum: 1maximum: 9223372036854775807
Príklad: 1

Ďalšie polia: Nie

AudienceData

AudienceData · Načítajte pravidlo prístupu a verziu produktu. Prvé zverejnenie zostáva časovým bodom.
anchor_atReťazecPovinné

Prvé zverejnenie; zmena pravidla dátum nemení.

format: "date-time"
Príklad: "2026-11-03T12:00:00Z"
effective_atReťazecPovinné

Čas zverejnenia tohto pravidla prístupu.

format: "date-time"
Príklad: "2026-11-03T12:00:00Z"
file_idReťazecPovinné

Identifikátor zdroja; zachovajte ho v podobe, v akej bol vrátený. · file_id

Príklad: "00000000-0000-4000-8000-000000000007"
file_version_idReťazecPovinné

ID nemennej verzie súboru.

Príklad: "00000000-0000-4000-8000-000000000010"
historical_access_preservedLogická hodnotaVoliteľné

Predtým priznané práva zostávajú po zúžení pravidla.

Predvolená hodnota: truePríklad: true
idReťazecPovinné

Identifikátor zdroja; zachovajte ho v podobe, v akej bol vrátený.

Príklad: "00000000-0000-4000-8000-000000000009"
lookback_daysCelé číslo nullPovinné

1–3650 dní pred prvým zverejnením; iba recent_and_new.

Príklad: null
modeReťazecPovinné

Výslovné pravidlo prístupu k zdieľanému súboru. new_purchases / recent_and_new / selected / all_purchasers.

Príklad: "all_purchasers"
next_cursorReťazec nullPovinné

Hodnota na pokračovanie na ďalšiu stránku alebo null.

Príklad: null
order_idsPole <Reťazec> Povinné

Objednávky s týmto zaplateným produktom bez vrátenia peňazí zaň.

Príklad: []
product_versionCelé čísloPovinné

Aktuálna verzia produktu na riadenie súbežných zmien.

Príklad: 3
revisionCelé čísloPovinné

Postupná revízia pravidla prístupu.

Príklad: 1

Ďalšie polia: Nie

AudienceSelection

AudienceSelection · Vyberte oprávnené nákupy. Zvolené objednávky musia obsahovať tento produkt zaplatený a nevrátený.
lookback_daysCelé číslo nullVoliteľné

1–3650 dní pred prvým zverejnením; iba recent_and_new.

Celé číslo:minimum: 1maximum: 3650
modeReťazecPovinné

Výslovné pravidlo prístupu k zdieľanému súboru. new_purchases / recent_and_new / selected / all_purchasers.

Obmedzenia
enum
["new_purchases", "recent_and_new", "selected", "all_purchasers"]
Príklad: "new_purchases"
order_idsPole <Reťazec> Voliteľné

Objednávky s týmto zaplateným produktom bez vrátenia peňazí zaň.

maxItems: 1000
Obmedzenia · Pole 1
pattern
"^[a-z0-9][a-z0-9_-]{0,62}$"
Predvolená hodnota: []

Ďalšie polia: Nie

Informácie o dostupnosti vo vybranom kontexte

AvailabilityData · Schéma · Dátové schémy: Produkty
available_fromReťazec nullPovinné

Začiatok dostupnosti.

Reťazec:format: "date-time"
Príklad: null
available_untilReťazec nullPovinné

Koniec dostupnosti.

Reťazec:format: "date-time"
Príklad: null
is_availableLogická hodnotaPovinné

Či je položka v tomto kontexte dostupná.

Príklad: true

Ďalšie polia: Nie

FileAssign

FileAssign · Polia, typy a obmedzenia údajov prijímaných alebo vracaných API. Po vytvorení upload_id odošlite súbory ako multipart/form-data a priraďte ich produktu. Stiahnutie vyžaduje token Bearer a oprávnenie pre category; odpoveď obsahuje bajty súboru bez verejnej adresy a hesla. Pre mode=period zvoľte days (1–3650) alebo doterajšie months, nikdy oboje. Podmienky sa uložia pri nákupe; vrátenie peňazí odoberie prístup iba vrátenej položke.
audienceAudienceSelection nullVoliteľné

Výslovné pravidlo prístupu k zdieľanému súboru.

Príklad: {"mode":"new_purchases"}
expected_versionCelé čísloPovinné

Verzia načítaná pred zápisom; pri nezhode sa aktualizácia odmietne.

minimum: 1maximum: 9223372036854775807
Príklad: 1
labelReťazecVoliteľné

Názov zdroja v príslušnom kontexte.

maxLength: 300
Predvolená hodnota: ""
upload_idReťazecPovinné

Identifikátor zdroja; zachovajte ho v podobe, v akej bol vrátený. · upload_id

format: "uuid"
Príklad: "00000000-0000-4000-8000-000000000001"

Ďalšie polia: Nie

FileCategory

FileCategory · Polia, typy a obmedzenia údajov prijímaných alebo vracaných API. Po vytvorení upload_id odošlite súbory ako multipart/form-data a priraďte ich produktu. Stiahnutie vyžaduje token Bearer a oprávnenie pre category; odpoveď obsahuje bajty súboru bez verejnej adresy a hesla. Pre mode=period zvoľte days (1–3650) alebo doterajšie months, nikdy oboje. Podmienky sa uložia pri nákupe; vrátenie peňazí odoberie prístup iba vrátenej položke.
Reťazec
Obmedzenia
enum
["internal", "customer_document", "digital"]

Ďalšie polia: Áno

Informácie o cene vo vybranom kontexte

PriceData · Schéma · Dátové schémy: Produkty
amountReťazecPovinné

Desatinná suma zapísaná ako reťazec JSON; null iba tam, kde je povolené.

Príklad: "0.00"
currencyReťazecPovinné

Kód meny sumy.

Obmedzenia
pattern
"^[A-Z]{3}$"
Príklad: "PLN"
minor_unitsCelé čísloPovinné

Počet desatinných miest používaných menou.

minimum: 0maximum: 4
Príklad: 2
tax_includedLogická hodnotaPovinné

Či zadaná cena zahŕňa daň.

Príklad: true

Ďalšie polia: Nie

Informácie o cenníku

PriceListData · Schéma · Dátové schémy: Produkty
currencyReťazecPovinné

Kód meny sumy.

idReťazecPovinné

Identifikátor zdroja; zachovajte ho v podobe, v akej bol vrátený. (PriceListData).

tax_includedLogická hodnotaPovinné

Či zadaná cena zahŕňa daň.

versionCelé čísloPovinné

Verzia zdroja používaná na riadenie súbežných zmien.

Ďalšie polia: Nie

Vytvoriť — Produkty — Telo požiadavky

ProductCreate · Polia, typy a obmedzenia údajov prijímaných alebo vracaných API.
brand_idReťazec nullVoliteľné

Identifikátor značky.

Reťazec:minLength: 1maxLength: 63
conditionReťazecVoliteľné

Stav produktu.

Obmedzenia
enum
["new", "refurbished", "used", "returned", "display", "damaged"]
Predvolená hodnota: "new"
descriptionReťazec nullVoliteľné

Opis vo vybranom jazyku.

Reťazec:maxLength: 100000
feature_value_idsPole <Reťazec> Voliteľné

Identifikátory vybraných hodnôt vlastností.

maxItems: 1000
Pole:minLength: 1maxLength: 63
identifiersProductIdentifiers nullVoliteľné

Identifikačné kódy produktu.

market_idsPole <Reťazec> Voliteľné

Identifikátory vybraných trhov.

maxItems: 1000
Pole:minLength: 1maxLength: 63
media_idsPole <Reťazec> Voliteľné

Identifikátory už existujúcich mediálnych súborov.

maxItems: 30
Pole:minLength: 1maxLength: 63
meta_descriptionReťazec nullVoliteľné

Opis pre vyhľadávače vo vybranom jazyku.

Reťazec:maxLength: 160
meta_keywordsPole <Reťazec> nullVoliteľné

Kľúčové slová pre vyhľadávače vo vybranom jazyku.

Pole:maxItems: 20
Pole / Pole:maxLength: 50
meta_titleReťazec nullVoliteľné

Titulok pre vyhľadávače vo vybranom jazyku.

Reťazec:maxLength: 70
nameReťazecPovinné

Názov zdroja v príslušnom kontexte.

minLength: 1maxLength: 300
Príklad: "Example"
pricingProductPrice Voliteľné

Nastavenie cien a ich verzie na riadenie súbežných zmien.

primary_category_idReťazec nullVoliteľné

Identifikátor hlavnej kategórie.

Reťazec:minLength: 1maxLength: 63
publishedLogická hodnotaVoliteľné

Či je zdroj zverejnený.

Predvolená hodnota: false
skuReťazecPovinné

Skladový kód položky.

minLength: 1maxLength: 100
Obmedzenia
pattern
"^\\S+$"
Príklad: "example"
slugReťazec nullVoliteľné

Úsek cesty URL vo vybranom jazyku.

Reťazec:maxLength: 160
tax_category_idReťazec nullVoliteľné

Identifikátor daňovej kategórie.

Reťazec:minLength: 1maxLength: 63
variant_value_idsPole <Reťazec> Voliteľné

Identifikátory vybraných hodnôt variantov.

maxItems: 250
Pole:minLength: 1maxLength: 63
variants_enabledLogická hodnotaVoliteľné

Či produkt používa varianty.

Predvolená hodnota: false

Ďalšie polia: Nie

Načítať — Produkty — Odpoveď

ProductDetailData · Polia, typy a obmedzenia údajov prijímaných alebo vracaných API.
availabilityAvailabilityData Povinné

Informácie o dostupnosti vo vybranom kontexte.

Príklad: {"available_from":null,"available_until":null,"is_available":true}
brand_idReťazec nullPovinné

Identifikátor značky.

Príklad: null
conditionReťazecPovinné

Stav produktu.

Obmedzenia
enum
["new", "refurbished", "used", "returned", "display", "damaged"]
Príklad: "new"
created_atReťazecPovinné

Čas vytvorenia.

format: "date-time"
Príklad: "2026-01-01T12:00:00Z"
descriptionReťazec nullPovinné

Opis vo vybranom jazyku.

Príklad: "example"
featuresPole <FeatureSelectionData > Povinné

Vlastnosti produktu.

Príklad: [{"feature_id":"example","feature_name":"example","value":"example","value_id":"example"}]
idReťazecPovinné

Identifikátor zdroja; zachovajte ho v podobe, v akej bol vrátený. (ProductDetailData).

Príklad: "example"
identifiersObjektĎalšie polia: ReťazecPovinné

Identifikačné kódy produktu.

Príklad: {}
mediaPole <ProductMediaData > Povinné

Informácie o pripojených médiách.

Príklad: [{"alt_text":"example","id":"example","is_primary":true,"kind":"image","mime_type":"image/jpeg","position":1,"url":"https://example.invalid/product.jpg"}]
meta_descriptionReťazec nullPovinné

Opis pre vyhľadávače vo vybranom jazyku.

Príklad: "example"
meta_keywordsPole <Reťazec> nullPovinné

Kľúčové slová pre vyhľadávače vo vybranom jazyku.

Príklad: ["example"]
meta_titleReťazec nullPovinné

Titulok pre vyhľadávače vo vybranom jazyku.

Príklad: "example"
nameReťazec nullPovinné

Názov zdroja v príslušnom kontexte.

Príklad: "Example"
numberReťazecPovinné

Číslo objednávky alebo zákazníckej žiadosti určené pre používateľa.

Príklad: "example"
pricePriceData nullPovinné

Informácie o cene vo vybranom kontexte.

Príklad: {"amount":"0.00","currency":"PLN","minor_units":2,"tax_included":true}
price_versionCelé čísloPovinné

Aktuálna verzia ceny na riadenie súbežných zmien.

Príklad: 1
primary_category_idReťazec nullPovinné

Identifikátor hlavnej kategórie.

Príklad: "example"
primary_media_idReťazec nullPovinné

Identifikátor hlavného mediálneho súboru.

Príklad: "example"
publishedLogická hodnotaPovinné

Či je zdroj zverejnený.

Príklad: false
skuReťazecPovinné

Skladový kód položky.

Príklad: "example"
slugReťazec nullPovinné

Úsek cesty URL vo vybranom jazyku.

Príklad: "example"
tax_category_idReťazecPovinné

Identifikátor daňovej kategórie.

Príklad: "example"
updated_atReťazecPovinné

Čas poslednej aktualizácie.

format: "date-time"
Príklad: "2026-01-01T12:00:00Z"
variants_enabledLogická hodnotaPovinné

Či produkt používa varianty.

Príklad: false
versionCelé čísloPovinné

Verzia zdroja používaná na riadenie súbežných zmien.

Príklad: 1

Ďalšie polia: Nie

ProductFileData

ProductFileData · Polia, typy a obmedzenia údajov prijímaných alebo vracaných API. Po vytvorení upload_id odošlite súbory ako multipart/form-data a priraďte ich produktu. Stiahnutie vyžaduje token Bearer a oprávnenie pre category; odpoveď obsahuje bajty súboru bez verejnej adresy a hesla. Pre mode=period zvoľte days (1–3650) alebo doterajšie months, nikdy oboje. Podmienky sa uložia pri nákupe; vrátenie peňazí odoberie prístup iba vrátenej položke.
categoryFileCategory Povinné

Kategória súboru: internal / customer_document / digital

Príklad: "digital"
created_atReťazecPovinné

Čas vytvorenia.

format: "date-time"
Príklad: "2026-01-01T12:00:00Z"
current_version_idReťazecPovinné

Identifikátor zdroja; zachovajte ho v podobe, v akej bol vrátený. · current_version_id

format: "uuid"
Príklad: "00000000-0000-4000-8000-000000000001"
file_idReťazecPovinné

Identifikátor zdroja; zachovajte ho v podobe, v akej bol vrátený. · file_id

format: "uuid"
Príklad: "00000000-0000-4000-8000-000000000001"
filenameReťazecPovinné

Súbor

Príklad: "manual.pdf"
idReťazecPovinné

Identifikátor zdroja; zachovajte ho v podobe, v akej bol vrátený.

format: "uuid"
Príklad: "00000000-0000-4000-8000-000000000001"
labelReťazecPovinné

Názov zdroja v príslušnom kontexte.

Príklad: "Manual"
mime_typeReťazecPovinné

Typ obsahu média.

Príklad: "application/pdf"
sha256ReťazecPovinné

SHA-256 (hex, 64)

Príklad: "5cd2f1cb0e5532b397e7ab1887baf6000c49450fd80ae279eb047c06e4545ecd"
size_bytesCelé čísloPovinné

Veľkosť v bajtoch

Príklad: 46
stateReťazecPovinné

Stav

Príklad: "active"
version_numberCelé čísloPovinné

Verzia

Príklad: 1

Ďalšie polia: Nie

ProductFileListData

ProductFileListData · Polia, typy a obmedzenia údajov prijímaných alebo vracaných API. Po vytvorení upload_id odošlite súbory ako multipart/form-data a priraďte ich produktu. Stiahnutie vyžaduje token Bearer a oprávnenie pre category; odpoveď obsahuje bajty súboru bez verejnej adresy a hesla. Pre mode=period zvoľte days (1–3650) alebo doterajšie months, nikdy oboje. Podmienky sa uložia pri nákupe; vrátenie peňazí odoberie prístup iba vrátenej položke.
filesPole <ProductFileData > Povinné

Súbory produktu

Príklad: [{"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_versionCelé čísloPovinné

Aktuálna verzia produktu na riadenie súbežných zmien.

Príklad: 2

Ďalšie polia: Nie

Identifikačné kódy produktu

ProductIdentifiers · Schéma · Dátové schémy: Produkty
eanReťazec nullVoliteľné

Identifikátor produktu EAN.

Reťazec:minLength: 1maxLength: 100
isbnReťazec nullVoliteľné

Identifikátor ISBN.

Reťazec:minLength: 1maxLength: 100
mpnReťazec nullVoliteľné

Katalógové číslo výrobcu.

Reťazec:minLength: 1maxLength: 100
upcReťazec nullVoliteľné

Identifikátor produktu UPC.

Reťazec:minLength: 1maxLength: 100

Ďalšie polia: Nie

Informácie o pripojených médiách

ProductMediaData · Schéma · Dátové schémy: Produkty
alt_textReťazec nullPovinné

Alternatívny text obrázka.

Príklad: "example"
idReťazecPovinné

Identifikátor zdroja; zachovajte ho v podobe, v akej bol vrátený. (ProductMediaData).

Príklad: "example"
is_primaryLogická hodnotaPovinné

Či ide o hlavnú položku.

Príklad: true
kindReťazecPovinné

Variant dátovej štruktúry opísaný povolenými hodnotami.

Obmedzenia
enum
["image", "video", "model_3d"]
Príklad: "image"
mime_typeReťazecPovinné

Typ obsahu média.

Príklad: "image/jpeg"
positionCelé čísloPovinné

Pozícia v zoradenom zozname.

Príklad: 1
urlReťazec nullPovinné

URL zdroja.

Príklad: "https://example.invalid/product.jpg"

Ďalšie polia: Nie

Nastavenie cien a ich verzie na riadenie súbežných zmien

ProductPrice · Schéma · Dátové schémy: Produkty
amountReťazec nullPovinné

Desatinná suma zapísaná ako reťazec JSON; null iba tam, kde je povolené.

Reťazec:maxLength: 19
Obmedzenia · Reťazec 1
pattern
"^(0|[1-9][0-9]{0,13})(\\.[0-9]{1,4})?$"
Príklad: "0.00"
currencyReťazecPovinné

Kód meny sumy.

Obmedzenia
pattern
"^[A-Z]{3}$"
Príklad: "PLN"
expected_price_list_versionCelé čísloPovinné

Skôr načítaná verzia cenníka požadovaná pre tento zápis.

minimum: 1maximum: 9223372036854775807
Príklad: 1
expected_versionCelé čísloPovinné

Verzia načítaná pred zápisom; pri nezhode sa aktualizácia odmietne.

minimum: 0maximum: 9223372036854775807
Príklad: 0
kindReťazecPovinné

Variant dátovej štruktúry opísaný povolenými hodnotami.

Obmedzenia
enum
["base", "market_fixed"]
Príklad: "base"
price_list_idReťazecPovinné

Identifikátor cenníka.

minLength: 1maxLength: 63
Príklad: "example"
tax_includedLogická hodnotaPovinné

Či zadaná cena zahŕňa daň.

Príklad: true

Ďalšie polia: Nie

Zobraziť zoznam — Produkty — Odpoveď

ProductSummaryData · Polia, typy a obmedzenia údajov prijímaných alebo vracaných API.
availabilityAvailabilityData Povinné

Informácie o dostupnosti vo vybranom kontexte.

Príklad: {"available_from":null,"available_until":null,"is_available":true}
brand_idReťazec nullPovinné

Identifikátor značky.

Príklad: null
conditionReťazecPovinné

Stav produktu.

Obmedzenia
enum
["new", "refurbished", "used", "returned", "display", "damaged"]
Príklad: "new"
created_atReťazecPovinné

Čas vytvorenia.

format: "date-time"
Príklad: "2026-01-01T12:00:00Z"
idReťazecPovinné

Identifikátor zdroja; zachovajte ho v podobe, v akej bol vrátený. (ProductSummaryData).

Príklad: "example"
nameReťazec nullPovinné

Názov zdroja v príslušnom kontexte.

Príklad: "Example"
numberReťazecPovinné

Číslo objednávky alebo zákazníckej žiadosti určené pre používateľa.

Príklad: "example"
pricePriceData nullPovinné

Informácie o cene vo vybranom kontexte.

Príklad: {"amount":"0.00","currency":"PLN","minor_units":2,"tax_included":true}
price_versionCelé čísloPovinné

Aktuálna verzia ceny na riadenie súbežných zmien.

Príklad: 1
primary_category_idReťazec nullPovinné

Identifikátor hlavnej kategórie.

Príklad: "example"
primary_media_idReťazec nullPovinné

Identifikátor hlavného mediálneho súboru.

Príklad: "example"
publishedLogická hodnotaPovinné

Či je zdroj zverejnený.

Príklad: false
skuReťazecPovinné

Skladový kód položky.

Príklad: "example"
slugReťazec nullPovinné

Úsek cesty URL vo vybranom jazyku.

Príklad: "example"
tax_category_idReťazecPovinné

Identifikátor daňovej kategórie.

Príklad: "example"
updated_atReťazecPovinné

Čas poslednej aktualizácie.

format: "date-time"
Príklad: "2026-01-01T12:00:00Z"
variants_enabledLogická hodnotaPovinné

Či produkt používa varianty.

Príklad: false
versionCelé čísloPovinné

Verzia zdroja používaná na riadenie súbežných zmien.

Príklad: 1

Ďalšie polia: Nie

Upraviť — Produkty — Telo požiadavky

ProductUpdate · Polia, typy a obmedzenia údajov prijímaných alebo vracaných API.
brand_idReťazec nullVoliteľné

Identifikátor značky.

Reťazec:minLength: 1maxLength: 63
conditionReťazecVoliteľné

Stav produktu.

Obmedzenia
enum
["new", "refurbished", "used", "returned", "display", "damaged"]
descriptionReťazec nullVoliteľné

Opis vo vybranom jazyku.

Reťazec:maxLength: 100000
Príklad: null
expected_variant_price_versionsObjektĎalšie polia: Celé číslo
minimum: 0maximum: 9223372036854775807
Voliteľné

Skôr načítané verzie cien s identifikátormi variantov ako kľúčmi.

maxProperties: 250
Obmedzenia
propertyNames
{"maxLength": 63, "minLength": 1}
expected_versionCelé čísloPovinné

Verzia načítaná pred zápisom; pri nezhode sa aktualizácia odmietne.

minimum: 1maximum: 9223372036854775807
Príklad: 1
feature_value_idsPole <Reťazec> Voliteľné

Identifikátory vybraných hodnôt vlastností.

maxItems: 1000
Pole:minLength: 1maxLength: 63
identifiersProductIdentifiers nullVoliteľné

Identifikačné kódy produktu.

market_idsPole <Reťazec> Voliteľné

Identifikátory vybraných trhov.

maxItems: 1000
Pole:minLength: 1maxLength: 63
media_idsPole <Reťazec> Voliteľné

Identifikátory už existujúcich mediálnych súborov.

maxItems: 30
Pole:minLength: 1maxLength: 63
meta_descriptionReťazec nullVoliteľné

Opis pre vyhľadávače vo vybranom jazyku.

Reťazec:maxLength: 160
meta_keywordsPole <Reťazec> nullVoliteľné

Kľúčové slová pre vyhľadávače vo vybranom jazyku.

Pole:maxItems: 20
Pole / Pole:maxLength: 50
meta_titleReťazec nullVoliteľné

Titulok pre vyhľadávače vo vybranom jazyku.

Reťazec:maxLength: 70
nameReťazec nullVoliteľné

Názov zdroja v príslušnom kontexte.

Reťazec:maxLength: 300
pricingProductPrice Voliteľné

Nastavenie cien a ich verzie na riadenie súbežných zmien.

Príklad: {"amount":"0.00","currency":"PLN","expected_price_list_version":1,"expected_version":0,"kind":"base","price_list_id":"example","tax_included":true}
primary_category_idReťazec nullVoliteľné

Identifikátor hlavnej kategórie.

Reťazec:minLength: 1maxLength: 63
publishedLogická hodnotaVoliteľné

Či je zdroj zverejnený.

skuReťazecVoliteľné

Skladový kód položky.

minLength: 1maxLength: 100
Obmedzenia
pattern
"^\\S+$"
Príklad: "example"
slugReťazec nullVoliteľné

Úsek cesty URL vo vybranom jazyku.

Reťazec:maxLength: 160
tax_category_idReťazec nullVoliteľné

Identifikátor daňovej kategórie.

Reťazec:minLength: 1maxLength: 63
variant_value_idsPole <Reťazec> Voliteľné

Identifikátory vybraných hodnôt variantov.

maxItems: 250
Pole:minLength: 1maxLength: 63
variants_enabledLogická hodnotaVoliteľné

Či produkt používa varianty.

Ďalšie polia: Nie

ProductVersion

ProductVersion · Táto operácia bola vyradená a vracia 409 bez zmeny údajov. Prístup nastavte pre každý digitálny súbor výberom príjemcov.
expected_versionCelé čísloPovinné

Verzia načítaná pred zápisom; pri nezhode sa aktualizácia odmietne.

minimum: 1maximum: 9223372036854775807
Príklad: 1

Ďalšie polia: Nie

ReleaseData

ReleaseData · Polia, typy a obmedzenia údajov prijímaných alebo vracaných API. Po vytvorení upload_id odošlite súbory ako multipart/form-data a priraďte ich produktu. Stiahnutie vyžaduje token Bearer a oprávnenie pre category; odpoveď obsahuje bajty súboru bez verejnej adresy a hesla. Pre mode=period zvoľte days (1–3650) alebo doterajšie months, nikdy oboje. Podmienky sa uložia pri nákupe; vrátenie peňazí odoberie prístup iba vrátenej položke.
changelogReťazecPovinné

Popis zmien

Príklad: "Manual update"
filesPole <ReleaseFileData > Povinné

Súbory produktu

Príklad: [{"file_id":"00000000-0000-4000-8000-000000000001","sort_order":0,"version_id":"00000000-0000-4000-8000-000000000001"}]
idReťazecPovinné

Identifikátor zdroja; zachovajte ho v podobe, v akej bol vrátený.

format: "uuid"
Príklad: "00000000-0000-4000-8000-000000000001"
manifest_sha256Reťazec nullPovinné

Digitálne vydania · SHA-256

Príklad: "1111111111111111111111111111111111111111111111111111111111111111"
published_atReťazec nullPovinné

Publikovať vydanie · UTC

Reťazec:format: "date-time"
Príklad: null
release_sequenceCelé číslo nullPovinné

Digitálne vydania · Pozícia v zoradenom zozname.

Príklad: null
stateReťazecPovinné

Stav

Príklad: "active"
version_labelReťazecPovinné

Verzia

Príklad: "1.0"
withdrawn_atReťazec nullPovinné

Stiahnuť ponuku · UTC

Reťazec:format: "date-time"
Príklad: null

Ďalšie polia: Nie

ReleaseDraft

ReleaseDraft · Táto operácia bola vyradená a vracia 409 bez zmeny údajov. Prístup nastavte pre každý digitálny súbor výberom príjemcov.
changelogReťazecVoliteľné

Popis zmien

maxLength: 20000
Predvolená hodnota: ""
expected_versionCelé čísloPovinné

Verzia načítaná pred zápisom; pri nezhode sa aktualizácia odmietne.

minimum: 1maximum: 9223372036854775807
Príklad: 1
version_idsPole <Reťazec> Povinné

Verzia · UUID[]

minItems: 1maxItems: 20
Pole:format: "uuid"
Príklad: ["00000000-0000-4000-8000-000000000001"]
version_labelReťazecPovinné

Verzia

minLength: 1maxLength: 64
Príklad: "1.0"

Ďalšie polia: Nie

ReleaseFileData

ReleaseFileData · Polia, typy a obmedzenia údajov prijímaných alebo vracaných API. Po vytvorení upload_id odošlite súbory ako multipart/form-data a priraďte ich produktu. Stiahnutie vyžaduje token Bearer a oprávnenie pre category; odpoveď obsahuje bajty súboru bez verejnej adresy a hesla. Pre mode=period zvoľte days (1–3650) alebo doterajšie months, nikdy oboje. Podmienky sa uložia pri nákupe; vrátenie peňazí odoberie prístup iba vrátenej položke.
file_idReťazecPovinné

Identifikátor zdroja; zachovajte ho v podobe, v akej bol vrátený. · file_id

format: "uuid"
Príklad: "00000000-0000-4000-8000-000000000001"
sort_orderCelé čísloPovinné

Pozícia v zoradenom zozname.

Príklad: 0
version_idReťazecPovinné

Identifikátor zdroja; zachovajte ho v podobe, v akej bol vrátený. · version_id

format: "uuid"
Príklad: "00000000-0000-4000-8000-000000000001"

Ďalšie polia: Nie

ReleaseListData

ReleaseListData · Polia, typy a obmedzenia údajov prijímaných alebo vracaných API. Po vytvorení upload_id odošlite súbory ako multipart/form-data a priraďte ich produktu. Stiahnutie vyžaduje token Bearer a oprávnenie pre category; odpoveď obsahuje bajty súboru bez verejnej adresy a hesla. Pre mode=period zvoľte days (1–3650) alebo doterajšie months, nikdy oboje. Podmienky sa uložia pri nákupe; vrátenie peňazí odoberie prístup iba vrátenej položke.
current_release_idReťazec nullPovinné

Identifikátor zdroja; zachovajte ho v podobe, v akej bol vrátený. · current_release_id

Reťazec:format: "uuid"
Príklad: "00000000-0000-4000-8000-000000000001"
product_versionCelé čísloPovinné

Aktuálna verzia produktu na riadenie súbežných zmien.

Príklad: 2
releasesPole <ReleaseData > Povinné

Digitálne vydania

Príklad: [{"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_daysCelé číslo nullPovinné

Počet dní (days; null)

Príklad: 365
update_modeReťazecPovinné

Prístup k budúcim súborom po nákupe: none / period / unlimited

Príklad: "period"
update_monthsCelé číslo nullPovinné

Mesiace (months; null)

Príklad: null

Ďalšie polia: Nie

UpdatePolicy

UpdatePolicy · Táto operácia bola vyradená a vracia 409 bez zmeny údajov. Prístup nastavte pre každý digitálny súbor výberom príjemcov.
daysCelé číslo nullVoliteľné

Počet dní (1–3650; mode=period; months=null)

Celé číslo:minimum: 1maximum: 3650
Príklad: 365
expected_versionCelé čísloPovinné

Verzia načítaná pred zápisom; pri nezhode sa aktualizácia odmietne.

minimum: 1maximum: 9223372036854775807
Príklad: 1
modeReťazecPovinné

Prístup k budúcim súborom po nákupe: none / period / unlimited

Obmedzenia
enum
["none", "period", "unlimited"]
Príklad: "period"
monthsCelé číslo nullVoliteľné

Mesiace (1–120; mode=period; days=null)

Celé číslo:minimum: 1maximum: 120
Príklad: null

Ďalšie polia: Nie

UploadCreate

UploadCreate · Polia, typy a obmedzenia údajov prijímaných alebo vracaných API. Po vytvorení upload_id odošlite súbory ako multipart/form-data a priraďte ich produktu. Stiahnutie vyžaduje token Bearer a oprávnenie pre category; odpoveď obsahuje bajty súboru bez verejnej adresy a hesla. Pre mode=period zvoľte days (1–3650) alebo doterajšie months, nikdy oboje. Podmienky sa uložia pri nákupe; vrátenie peňazí odoberie prístup iba vrátenej položke.
filenameReťazecPovinné

Súbor

minLength: 1maxLength: 255
Príklad: "manual.pdf"
product_idReťazec nullVoliteľné

Identifikátor produktu.

Obmedzenia · Reťazec 1
pattern
"^[a-z0-9][a-z0-9_-]{0,62}$"
Príklad: "example"
sha256ReťazecPovinné

SHA-256 (hex, 64)

Obmedzenia
pattern
"^[0-9a-f]{64}$"
Príklad: "5cd2f1cb0e5532b397e7ab1887baf6000c49450fd80ae279eb047c06e4545ecd"
size_bytesCelé čísloPovinné

Veľkosť v bajtoch

minimum: 1maximum: 262144000
Príklad: 46

Ďalšie polia: Nie

UploadData

UploadData · Polia, typy a obmedzenia údajov prijímaných alebo vracaných API. Po vytvorení upload_id odošlite súbory ako multipart/form-data a priraďte ich produktu. Stiahnutie vyžaduje token Bearer a oprávnenie pre category; odpoveď obsahuje bajty súboru bez verejnej adresy a hesla. Pre mode=period zvoľte days (1–3650) alebo doterajšie months, nikdy oboje. Podmienky sa uložia pri nákupe; vrátenie peňazí odoberie prístup iba vrátenej položke.
categoryFileCategory Povinné

Kategória súboru: internal / customer_document / digital

Príklad: "digital"
expires_atReťazecPovinné

Dátum a čas vypršania prístupového údaja.

format: "date-time"
Príklad: "2026-01-01T12:00:00Z"
filenameReťazecPovinné

Súbor

Príklad: "manual.pdf"
idReťazecPovinné

Identifikátor zdroja; zachovajte ho v podobe, v akej bol vrátený.

format: "uuid"
Príklad: "00000000-0000-4000-8000-000000000001"
product_idReťazec nullPovinné

Identifikátor produktu.

Príklad: "example"
received_bytesCelé čísloPovinné

Nahrávanie… · Veľkosť v bajtoch

Príklad: 46
sha256ReťazecPovinné

SHA-256 (hex, 64)

Príklad: "5cd2f1cb0e5532b397e7ab1887baf6000c49450fd80ae279eb047c06e4545ecd"
size_bytesCelé čísloPovinné

Veľkosť v bajtoch

Príklad: 46
statusReťazecPovinné

Stav prijímaný touto konkrétnou operáciou.

Príklad: "ready"

Ďalšie polia: Nie