Sheme podataka: Proizvodi

Sheme podataka: Proizvodi. Polja, vrste i ograničenja podataka koje API prihvaća ili vraća.

Sheme podataka

ApiResponse_ProductFileListData_

ApiResponse_ProductFileListData_ · Polja, vrste i ograničenja podataka koje API prihvaća ili vraća. Nakon izrade upload_id pošaljite datoteke kao multipart/form-data i pridružite ih proizvodu. Preuzimanje zahtijeva token Bearer i ovlast za category; odgovor sadrži bajtove datoteke bez javne adrese i lozinke. Za mode=period odaberite days (1–3650) ili dosadašnji months, nikad oboje. Uvjeti se bilježe pri kupnji; povrat novca ukida pristup samo vraćenoj stavci.

dataProductFileListData Obvezno: Podaci uspješnog odgovora.

Primjer: {"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 Obvezno: Metapodaci odgovora.

Primjer: {"pagination":{"has_more":false,"limit":50,"next_cursor":null},"request_id":"example"}

Dodatna polja: Ne

ApiResponse_ReleaseListData_

ApiResponse_ReleaseListData_ · Polja, vrste i ograničenja podataka koje API prihvaća ili vraća. Nakon izrade upload_id pošaljite datoteke kao multipart/form-data i pridružite ih proizvodu. Preuzimanje zahtijeva token Bearer i ovlast za category; odgovor sadrži bajtove datoteke bez javne adrese i lozinke. Za mode=period odaberite days (1–3650) ili dosadašnji months, nikad oboje. Uvjeti se bilježe pri kupnji; povrat novca ukida pristup samo vraćenoj stavci.

dataReleaseListData Obvezno: Podaci uspješnog odgovora.

Primjer: {"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 Obvezno: Metapodaci odgovora.

Primjer: {"pagination":{"has_more":false,"limit":50,"next_cursor":null},"request_id":"example"}

Dodatna polja: Ne

ApiResponse_UploadData_

ApiResponse_UploadData_ · Polja, vrste i ograničenja podataka koje API prihvaća ili vraća. Nakon izrade upload_id pošaljite datoteke kao multipart/form-data i pridružite ih proizvodu. Preuzimanje zahtijeva token Bearer i ovlast za category; odgovor sadrži bajtove datoteke bez javne adrese i lozinke. Za mode=period odaberite days (1–3650) ili dosadašnji months, nikad oboje. Uvjeti se bilježe pri kupnji; povrat novca ukida pristup samo vraćenoj stavci.

dataUploadData Obvezno: Podaci uspješnog odgovora.

Primjer: {"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 Obvezno: Metapodaci odgovora.

Primjer: {"request_id":"example"}

Dodatna polja: Ne

ApiResponse[AudienceData]

ApiResponse_AudienceData_ · Pročitaj pravilo pristupa i verziju proizvoda. Prva objava ostaje vremenska osnova.

dataAudienceData Obvezno: Podaci uspješnog odgovora.

Primjer: {"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 Obvezno: Metapodaci odgovora.

Primjer: {"request_id":"example-request"}

Dodatna polja: Ne

Popis — Proizvodi — Odgovor

ApiResponse_list_ProductSummaryData__ · Polja, vrste i ograničenja podataka koje API prihvaća ili vraća.

dataPolje vrijednosti <ProductSummaryData > Obvezno: Primjer odgovora · ApiResponse_list_ProductSummaryData__.

Primjer: [{"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 Obvezno: Metapodaci odgovora.

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

Dodatna polja: Ne

Dohvati — Proizvodi — Odgovor

ApiResponse_ProductDetailData_ · Polja, vrste i ograničenja podataka koje API prihvaća ili vraća.

dataProductDetailData Obvezno: Primjer odgovora · ProductDetailData.

Primjer: {"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 Obvezno: Metapodaci odgovora.

Primjer: {"locale":"en","market_code":"PL","market_id":"example","request_id":"example"}

Dodatna polja: Ne

AudienceChange

AudienceChange · Odaberi prihvatljive kupnje. Odabrane narudžbe moraju sadržavati ovaj proizvod kao plaćen, bez izvršenog povrata novca.

audienceAudienceSelection Obvezno: Izričito pravilo pristupa zajedničkoj datoteci.

Primjer: {"mode":"all_purchasers"}
expected_versionCijeli brojObvezno: Verzija pročitana prije upisa; nepodudaranje odbija ažuriranje.

minimum: 1maximum: 9223372036854775807

Primjer: 1

Dodatna polja: Ne

AudienceData

AudienceData · Pročitaj pravilo pristupa i verziju proizvoda. Prva objava ostaje vremenska osnova.

anchor_atNiz znakovaObvezno: Prva objava; promjena pravila ne mijenja datum.

format: "date-time"

Primjer: "2026-11-03T12:00:00Z"
effective_atNiz znakovaObvezno: Vrijeme objave ovog pravila pristupa.

format: "date-time"

Primjer: "2026-11-03T12:00:00Z"
file_idNiz znakovaObvezno: Identifikator resursa; sačuvajte ga u vraćenom obliku. · file_id

Primjer: "00000000-0000-4000-8000-000000000007"
file_version_idNiz znakovaObvezno: ID nepromjenjive verzije datoteke.

Primjer: "00000000-0000-4000-8000-000000000010"
historical_access_preservedLogička vrijednostNeobavezno: Ranije dodijeljena prava ostaju nakon sužavanja pravila.

Zadano: truePrimjer: true
idNiz znakovaObvezno: Identifikator resursa; sačuvajte ga u vraćenom obliku.

Primjer: "00000000-0000-4000-8000-000000000009"
lookback_daysCijeli broj nullObvezno: 1–3650 dana prije prve objave; samo recent_and_new.

Primjer: null
modeNiz znakovaObvezno: Izričito pravilo pristupa zajedničkoj datoteci. new_purchases / recent_and_new / selected / all_purchasers.

Primjer: "all_purchasers"
next_cursorNiz znakova nullObvezno: Vrijednost za nastavak na sljedeću stranicu ili null.

Primjer: null
order_idsPolje vrijednosti <Niz znakova> Obvezno: Narudžbe s ovim plaćenim proizvodom bez povrata novca za njega.

Primjer: []
product_versionCijeli brojObvezno: Trenutačna verzija proizvoda za kontrolu istodobnih upisa.

Primjer: 3
revisionCijeli brojObvezno: Uzastopna revizija pravila pristupa.

Primjer: 1

Dodatna polja: Ne

AudienceSelection

AudienceSelection · Odaberi prihvatljive kupnje. Odabrane narudžbe moraju sadržavati ovaj proizvod kao plaćen, bez izvršenog povrata novca.

lookback_daysCijeli broj nullNeobavezno

1–3650 dana prije prve objave; samo recent_and_new.

Cijeli broj:minimum: 1maximum: 3650

modeNiz znakovaObvezno

Izričito pravilo pristupa zajedničkoj datoteci. new_purchases / recent_and_new / selected / all_purchasers.

Ograničenja

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

Primjer: "new_purchases"

order_idsPolje vrijednosti <Niz znakova> Neobavezno

Narudžbe s ovim plaćenim proizvodom bez povrata novca za njega.

maxItems: 1000

Ograničenja · Polje vrijednosti 1

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

Zadano: []

Dodatna polja: Ne

Podaci o dostupnosti za odabrani kontekst

AvailabilityData · Shema · Sheme podataka: Proizvodi

available_fromNiz znakova nullObvezno: Početak dostupnosti.

Niz znakova:format: "date-time"

Primjer: null
available_untilNiz znakova nullObvezno: Kraj dostupnosti.

Niz znakova:format: "date-time"

Primjer: null
is_availableLogička vrijednostObvezno: Je li stavka dostupna u ovom kontekstu.

Primjer: true

Dodatna polja: Ne

FileAssign

FileAssign · Polja, vrste i ograničenja podataka koje API prihvaća ili vraća. Nakon izrade upload_id pošaljite datoteke kao multipart/form-data i pridružite ih proizvodu. Preuzimanje zahtijeva token Bearer i ovlast za category; odgovor sadrži bajtove datoteke bez javne adrese i lozinke. Za mode=period odaberite days (1–3650) ili dosadašnji months, nikad oboje. Uvjeti se bilježe pri kupnji; povrat novca ukida pristup samo vraćenoj stavci.

audienceAudienceSelection nullNeobavezno: Izričito pravilo pristupa zajedničkoj datoteci.

Primjer: {"mode":"new_purchases"}
expected_versionCijeli brojObvezno: Verzija pročitana prije upisa; nepodudaranje odbija ažuriranje.

minimum: 1maximum: 9223372036854775807

Primjer: 1
labelNiz znakovaNeobavezno: Naziv resursa u odgovarajućem kontekstu.

maxLength: 300

Zadano: ""
upload_idNiz znakovaObvezno: Identifikator resursa; sačuvajte ga u vraćenom obliku. · upload_id

format: "uuid"

Primjer: "00000000-0000-4000-8000-000000000001"

Dodatna polja: Ne

FileCategory

FileCategory · Polja, vrste i ograničenja podataka koje API prihvaća ili vraća. Nakon izrade upload_id pošaljite datoteke kao multipart/form-data i pridružite ih proizvodu. Preuzimanje zahtijeva token Bearer i ovlast za category; odgovor sadrži bajtove datoteke bez javne adrese i lozinke. Za mode=period odaberite days (1–3650) ili dosadašnji months, nikad oboje. Uvjeti se bilježe pri kupnji; povrat novca ukida pristup samo vraćenoj stavci.

Niz znakova

Ograničenja

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

Dodatna polja: Da

Podaci o cijeni u odabranom kontekstu

PriceData · Shema · Sheme podataka: Proizvodi

amountNiz znakovaObvezno

Decimalni iznos kodiran kao JSON niz znakova; null samo gdje je dopušten.

Primjer: "0.00"

currencyNiz znakovaObvezno

Kod valute iznosa.

Ograničenja

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

Primjer: "PLN"

minor_unitsCijeli brojObvezno

Broj decimalnih znamenki valute.

minimum: 0maximum: 4

Primjer: 2

tax_includedLogička vrijednostObvezno

Uključuje li poslana cijena porez.

Primjer: true

Dodatna polja: Ne

Podaci cjenika

PriceListData · Shema · Sheme podataka: Proizvodi

currencyNiz znakovaObvezno: Kod valute iznosa.
idNiz znakovaObvezno: Identifikator resursa; sačuvajte ga u vraćenom obliku. (PriceListData).
tax_includedLogička vrijednostObvezno: Uključuje li poslana cijena porez.
versionCijeli brojObvezno: Verzija resursa za kontrolu istodobnih upisa.

Dodatna polja: Ne

Stvori — Proizvodi — Tijelo zahtjeva

ProductCreate · Polja, vrste i ograničenja podataka koje API prihvaća ili vraća.

brand_idNiz znakova nullNeobavezno

Identifikator marke.

Niz znakova:minLength: 1maxLength: 63

conditionNiz znakovaNeobavezno

Stanje proizvoda.

Ograničenja

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

Zadano: "new"

descriptionNiz znakova nullNeobavezno

Opis na odabranom jeziku.

Niz znakova:maxLength: 100000

feature_value_idsPolje vrijednosti <Niz znakova> Neobavezno

Identifikatori odabranih vrijednosti svojstva.

maxItems: 1000

Polje vrijednosti:minLength: 1maxLength: 63

identifiersProductIdentifiers nullNeobavezno

Identifikacijski kodovi proizvoda.

market_idsPolje vrijednosti <Niz znakova> Neobavezno

Identifikatori odabranih tržišta.

maxItems: 1000

Polje vrijednosti:minLength: 1maxLength: 63

media_idsPolje vrijednosti <Niz znakova> Neobavezno

Identifikatori već postojećih medijskih datoteka.

maxItems: 30

Polje vrijednosti:minLength: 1maxLength: 63

meta_descriptionNiz znakova nullNeobavezno

Opis za tražilice na odabranom jeziku.

Niz znakova:maxLength: 160

meta_keywordsPolje vrijednosti <Niz znakova> nullNeobavezno

Ključne riječi za tražilice na odabranom jeziku.

Polje vrijednosti:maxItems: 20

Polje vrijednosti / Polje vrijednosti:maxLength: 50

meta_titleNiz znakova nullNeobavezno

Naslov za tražilice na odabranom jeziku.

Niz znakova:maxLength: 70

nameNiz znakovaObvezno

Naziv resursa u odgovarajućem kontekstu.

minLength: 1maxLength: 300

Primjer: "Example"

pricingProductPrice Neobavezno

Postavke cijena i njihove verzije za kontrolu istodobnih upisa.

primary_category_idNiz znakova nullNeobavezno

Identifikator glavne kategorije.

Niz znakova:minLength: 1maxLength: 63

publishedLogička vrijednostNeobavezno

Je li resurs objavljen.

Zadano: false

skuNiz znakovaObvezno

Šifra skladišne jedinice.

minLength: 1maxLength: 100

Ograničenja

pattern: "^\\S+$"

Primjer: "example"

slugNiz znakova nullNeobavezno

Dio URL putanje na odabranom jeziku.

Niz znakova:maxLength: 160

tax_category_idNiz znakova nullNeobavezno

Identifikator porezne kategorije.

Niz znakova:minLength: 1maxLength: 63

variant_value_idsPolje vrijednosti <Niz znakova> Neobavezno

Identifikatori odabranih vrijednosti varijante.

maxItems: 250

Polje vrijednosti:minLength: 1maxLength: 63

variants_enabledLogička vrijednostNeobavezno

Koristi li proizvod varijante.

Zadano: false

Dodatna polja: Ne

Dohvati — Proizvodi — Odgovor

ProductDetailData · Polja, vrste i ograničenja podataka koje API prihvaća ili vraća.

availabilityAvailabilityData Obvezno

Podaci o dostupnosti za odabrani kontekst.

Primjer: {"available_from":null,"available_until":null,"is_available":true}

brand_idNiz znakova nullObvezno

Identifikator marke.

Primjer: null

conditionNiz znakovaObvezno

Stanje proizvoda.

Ograničenja

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

Primjer: "new"

created_atNiz znakovaObvezno

Vrijeme izrade.

format: "date-time"

Primjer: "2026-01-01T12:00:00Z"

descriptionNiz znakova nullObvezno

Opis na odabranom jeziku.

Primjer: "example"

featuresPolje vrijednosti <FeatureSelectionData > Obvezno

Svojstva proizvoda.

Primjer: [{"feature_id":"example","feature_name":"example","value":"example","value_id":"example"}]

idNiz znakovaObvezno

Identifikator resursa; sačuvajte ga u vraćenom obliku. (ProductDetailData).

Primjer: "example"

identifiersObjektDodatna polja: Niz znakovaObvezno

Identifikacijski kodovi proizvoda.

Primjer: {}

mediaPolje vrijednosti <ProductMediaData > Obvezno

Podaci o priloženim medijima.

Primjer:

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

meta_descriptionNiz znakova nullObvezno

Opis za tražilice na odabranom jeziku.

Primjer: "example"

meta_keywordsPolje vrijednosti <Niz znakova> nullObvezno

Ključne riječi za tražilice na odabranom jeziku.

Primjer: ["example"]

meta_titleNiz znakova nullObvezno

Naslov za tražilice na odabranom jeziku.

Primjer: "example"

nameNiz znakova nullObvezno

Naziv resursa u odgovarajućem kontekstu.

Primjer: "Example"

numberNiz znakovaObvezno

Broj narudžbe ili zahtjeva namijenjen korisniku.

Primjer: "example"

pricePriceData nullObvezno

Podaci o cijeni u odabranom kontekstu.

Primjer: {"amount":"0.00","currency":"PLN","minor_units":2,"tax_included":true}

price_versionCijeli brojObvezno

Trenutačna verzija cijene za kontrolu istodobnih upisa.

Primjer: 1

primary_category_idNiz znakova nullObvezno

Identifikator glavne kategorije.

Primjer: "example"

primary_media_idNiz znakova nullObvezno

Identifikator glavne medijske datoteke.

Primjer: "example"

publishedLogička vrijednostObvezno

Je li resurs objavljen.

Primjer: false

skuNiz znakovaObvezno

Šifra skladišne jedinice.

Primjer: "example"

slugNiz znakova nullObvezno

Dio URL putanje na odabranom jeziku.

Primjer: "example"

tax_category_idNiz znakovaObvezno

Identifikator porezne kategorije.

Primjer: "example"

updated_atNiz znakovaObvezno

Vrijeme posljednjeg ažuriranja.

format: "date-time"

Primjer: "2026-01-01T12:00:00Z"

variants_enabledLogička vrijednostObvezno

Koristi li proizvod varijante.

Primjer: false

versionCijeli brojObvezno

Verzija resursa za kontrolu istodobnih upisa.

Primjer: 1

Dodatna polja: Ne

ProductFileData

ProductFileData · Polja, vrste i ograničenja podataka koje API prihvaća ili vraća. Nakon izrade upload_id pošaljite datoteke kao multipart/form-data i pridružite ih proizvodu. Preuzimanje zahtijeva token Bearer i ovlast za category; odgovor sadrži bajtove datoteke bez javne adrese i lozinke. Za mode=period odaberite days (1–3650) ili dosadašnji months, nikad oboje. Uvjeti se bilježe pri kupnji; povrat novca ukida pristup samo vraćenoj stavci.

categoryFileCategory Obvezno: Kategorija datoteke: internal / customer_document / digital

Primjer: "digital"
created_atNiz znakovaObvezno: Vrijeme izrade.

format: "date-time"

Primjer: "2026-01-01T12:00:00Z"
current_version_idNiz znakovaObvezno: Identifikator resursa; sačuvajte ga u vraćenom obliku. · current_version_id

format: "uuid"

Primjer: "00000000-0000-4000-8000-000000000001"
file_idNiz znakovaObvezno: Identifikator resursa; sačuvajte ga u vraćenom obliku. · file_id

format: "uuid"

Primjer: "00000000-0000-4000-8000-000000000001"
filenameNiz znakovaObvezno: Datoteka

Primjer: "manual.pdf"
idNiz znakovaObvezno: Identifikator resursa; sačuvajte ga u vraćenom obliku.

format: "uuid"

Primjer: "00000000-0000-4000-8000-000000000001"
labelNiz znakovaObvezno: Naziv resursa u odgovarajućem kontekstu.

Primjer: "Manual"
mime_typeNiz znakovaObvezno: Vrsta medijskog sadržaja.

Primjer: "application/pdf"
sha256Niz znakovaObvezno: SHA-256 (hex, 64)

Primjer: "5cd2f1cb0e5532b397e7ab1887baf6000c49450fd80ae279eb047c06e4545ecd"
size_bytesCijeli brojObvezno: Veličina u bajtovima

Primjer: 46
stateNiz znakovaObvezno: Status

Primjer: "active"
version_numberCijeli brojObvezno: Verzija

Primjer: 1

Dodatna polja: Ne

ProductFileListData

ProductFileListData · Polja, vrste i ograničenja podataka koje API prihvaća ili vraća. Nakon izrade upload_id pošaljite datoteke kao multipart/form-data i pridružite ih proizvodu. Preuzimanje zahtijeva token Bearer i ovlast za category; odgovor sadrži bajtove datoteke bez javne adrese i lozinke. Za mode=period odaberite days (1–3650) ili dosadašnji months, nikad oboje. Uvjeti se bilježe pri kupnji; povrat novca ukida pristup samo vraćenoj stavci.

filesPolje vrijednosti <ProductFileData > Obvezno: Datoteke proizvoda

Primjer: [{"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_versionCijeli brojObvezno: Trenutačna verzija proizvoda za kontrolu istodobnih upisa.

Primjer: 2

Dodatna polja: Ne

Identifikacijski kodovi proizvoda

ProductIdentifiers · Shema · Sheme podataka: Proizvodi

eanNiz znakova nullNeobavezno: EAN identifikator proizvoda.

Niz znakova:minLength: 1maxLength: 100
isbnNiz znakova nullNeobavezno: ISBN identifikator.

Niz znakova:minLength: 1maxLength: 100
mpnNiz znakova nullNeobavezno: Kataloški broj proizvođača.

Niz znakova:minLength: 1maxLength: 100
upcNiz znakova nullNeobavezno: UPC identifikator proizvoda.

Niz znakova:minLength: 1maxLength: 100

Dodatna polja: Ne

Podaci o priloženim medijima

ProductMediaData · Shema · Sheme podataka: Proizvodi

alt_textNiz znakova nullObvezno

Zamjenski tekst slike.

Primjer: "example"

idNiz znakovaObvezno

Identifikator resursa; sačuvajte ga u vraćenom obliku. (ProductMediaData).

Primjer: "example"

is_primaryLogička vrijednostObvezno

Je li ovo glavna stavka.

Primjer: true

kindNiz znakovaObvezno

Varijanta strukture podataka opisana dopuštenim vrijednostima.

Ograničenja

enum: ["image", "video", "model_3d"]

Primjer: "image"

mime_typeNiz znakovaObvezno

Vrsta medijskog sadržaja.

Primjer: "image/jpeg"

positionCijeli brojObvezno

Položaj u uređenoj zbirci.

Primjer: 1

urlNiz znakova nullObvezno

URL resursa.

Primjer: "https://example.invalid/product.jpg"

Dodatna polja: Ne

Postavke cijena i njihove verzije za kontrolu istodobnih upisa

ProductPrice · Shema · Sheme podataka: Proizvodi

amountNiz znakova nullObvezno

Decimalni iznos kodiran kao JSON niz znakova; null samo gdje je dopušten.

Niz znakova:maxLength: 19

Ograničenja · Niz znakova 1

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

Primjer: "0.00"

currencyNiz znakovaObvezno

Kod valute iznosa.

Ograničenja

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

Primjer: "PLN"

expected_price_list_versionCijeli brojObvezno

Prethodno pročitana verzija cjenika potrebna za ovaj upis.

minimum: 1maximum: 9223372036854775807

Primjer: 1

expected_versionCijeli brojObvezno

Verzija pročitana prije upisa; nepodudaranje odbija ažuriranje.

minimum: 0maximum: 9223372036854775807

Primjer: 0

kindNiz znakovaObvezno

Varijanta strukture podataka opisana dopuštenim vrijednostima.

Ograničenja

enum: ["base", "market_fixed"]

Primjer: "base"

price_list_idNiz znakovaObvezno

Identifikator cjenika.

minLength: 1maxLength: 63

Primjer: "example"

tax_includedLogička vrijednostObvezno

Uključuje li poslana cijena porez.

Primjer: true

Dodatna polja: Ne

Popis — Proizvodi — Odgovor

ProductSummaryData · Polja, vrste i ograničenja podataka koje API prihvaća ili vraća.

availabilityAvailabilityData Obvezno

Podaci o dostupnosti za odabrani kontekst.

Primjer: {"available_from":null,"available_until":null,"is_available":true}

brand_idNiz znakova nullObvezno

Identifikator marke.

Primjer: null

conditionNiz znakovaObvezno

Stanje proizvoda.

Ograničenja

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

Primjer: "new"

created_atNiz znakovaObvezno

Vrijeme izrade.

format: "date-time"

Primjer: "2026-01-01T12:00:00Z"

idNiz znakovaObvezno

Identifikator resursa; sačuvajte ga u vraćenom obliku. (ProductSummaryData).

Primjer: "example"

nameNiz znakova nullObvezno

Naziv resursa u odgovarajućem kontekstu.

Primjer: "Example"

numberNiz znakovaObvezno

Broj narudžbe ili zahtjeva namijenjen korisniku.

Primjer: "example"

pricePriceData nullObvezno

Podaci o cijeni u odabranom kontekstu.

Primjer: {"amount":"0.00","currency":"PLN","minor_units":2,"tax_included":true}

price_versionCijeli brojObvezno

Trenutačna verzija cijene za kontrolu istodobnih upisa.

Primjer: 1

primary_category_idNiz znakova nullObvezno

Identifikator glavne kategorije.

Primjer: "example"

primary_media_idNiz znakova nullObvezno

Identifikator glavne medijske datoteke.

Primjer: "example"

publishedLogička vrijednostObvezno

Je li resurs objavljen.

Primjer: false

skuNiz znakovaObvezno

Šifra skladišne jedinice.

Primjer: "example"

slugNiz znakova nullObvezno

Dio URL putanje na odabranom jeziku.

Primjer: "example"

tax_category_idNiz znakovaObvezno

Identifikator porezne kategorije.

Primjer: "example"

updated_atNiz znakovaObvezno

Vrijeme posljednjeg ažuriranja.

format: "date-time"

Primjer: "2026-01-01T12:00:00Z"

variants_enabledLogička vrijednostObvezno

Koristi li proizvod varijante.

Primjer: false

versionCijeli brojObvezno

Verzija resursa za kontrolu istodobnih upisa.

Primjer: 1

Dodatna polja: Ne

Ažuriraj — Proizvodi — Tijelo zahtjeva

ProductUpdate · Polja, vrste i ograničenja podataka koje API prihvaća ili vraća.

brand_idNiz znakova nullNeobavezno

Identifikator marke.

Niz znakova:minLength: 1maxLength: 63

conditionNiz znakovaNeobavezno

Stanje proizvoda.

Ograničenja

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

descriptionNiz znakova nullNeobavezno

Opis na odabranom jeziku.

Niz znakova:maxLength: 100000

Primjer: null

expected_variant_price_versionsObjektDodatna polja: Cijeli broj

minimum: 0maximum: 9223372036854775807

Neobavezno

Prethodno pročitane verzije cijena s identifikatorom varijante kao ključem.

maxProperties: 250

Ograničenja

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

expected_versionCijeli brojObvezno

Verzija pročitana prije upisa; nepodudaranje odbija ažuriranje.

minimum: 1maximum: 9223372036854775807

Primjer: 1

feature_value_idsPolje vrijednosti <Niz znakova> Neobavezno

Identifikatori odabranih vrijednosti svojstva.

maxItems: 1000

Polje vrijednosti:minLength: 1maxLength: 63

identifiersProductIdentifiers nullNeobavezno

Identifikacijski kodovi proizvoda.

market_idsPolje vrijednosti <Niz znakova> Neobavezno

Identifikatori odabranih tržišta.

maxItems: 1000

Polje vrijednosti:minLength: 1maxLength: 63

media_idsPolje vrijednosti <Niz znakova> Neobavezno

Identifikatori već postojećih medijskih datoteka.

maxItems: 30

Polje vrijednosti:minLength: 1maxLength: 63

meta_descriptionNiz znakova nullNeobavezno

Opis za tražilice na odabranom jeziku.

Niz znakova:maxLength: 160

meta_keywordsPolje vrijednosti <Niz znakova> nullNeobavezno

Ključne riječi za tražilice na odabranom jeziku.

Polje vrijednosti:maxItems: 20

Polje vrijednosti / Polje vrijednosti:maxLength: 50

meta_titleNiz znakova nullNeobavezno

Naslov za tražilice na odabranom jeziku.

Niz znakova:maxLength: 70

nameNiz znakova nullNeobavezno

Naziv resursa u odgovarajućem kontekstu.

Niz znakova:maxLength: 300

pricingProductPrice Neobavezno

Postavke cijena i njihove verzije za kontrolu istodobnih upisa.

Primjer:

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

primary_category_idNiz znakova nullNeobavezno

Identifikator glavne kategorije.

Niz znakova:minLength: 1maxLength: 63

publishedLogička vrijednostNeobavezno

Je li resurs objavljen.

skuNiz znakovaNeobavezno

Šifra skladišne jedinice.

minLength: 1maxLength: 100

Ograničenja

pattern: "^\\S+$"

Primjer: "example"

slugNiz znakova nullNeobavezno

Dio URL putanje na odabranom jeziku.

Niz znakova:maxLength: 160

tax_category_idNiz znakova nullNeobavezno

Identifikator porezne kategorije.

Niz znakova:minLength: 1maxLength: 63

variant_value_idsPolje vrijednosti <Niz znakova> Neobavezno

Identifikatori odabranih vrijednosti varijante.

maxItems: 250

Polje vrijednosti:minLength: 1maxLength: 63

variants_enabledLogička vrijednostNeobavezno

Koristi li proizvod varijante.

Dodatna polja: Ne

ProductVersion

ProductVersion · Ova je operacija povučena i vraća 409 bez izmjene podataka. Pristup svakoj digitalnoj datoteci postavi odabirom primatelja.

expected_versionCijeli brojObvezno: Verzija pročitana prije upisa; nepodudaranje odbija ažuriranje.

minimum: 1maximum: 9223372036854775807

Primjer: 1

Dodatna polja: Ne

ReleaseData

ReleaseData · Polja, vrste i ograničenja podataka koje API prihvaća ili vraća. Nakon izrade upload_id pošaljite datoteke kao multipart/form-data i pridružite ih proizvodu. Preuzimanje zahtijeva token Bearer i ovlast za category; odgovor sadrži bajtove datoteke bez javne adrese i lozinke. Za mode=period odaberite days (1–3650) ili dosadašnji months, nikad oboje. Uvjeti se bilježe pri kupnji; povrat novca ukida pristup samo vraćenoj stavci.

changelogNiz znakovaObvezno: Opis promjena

Primjer: "Manual update"
filesPolje vrijednosti <ReleaseFileData > Obvezno: Datoteke proizvoda

Primjer: [{"file_id":"00000000-0000-4000-8000-000000000001","sort_order":0,"version_id":"00000000-0000-4000-8000-000000000001"}]
idNiz znakovaObvezno: Identifikator resursa; sačuvajte ga u vraćenom obliku.

format: "uuid"

Primjer: "00000000-0000-4000-8000-000000000001"
manifest_sha256Niz znakova nullObvezno: Digitalna izdanja · SHA-256

Primjer: "1111111111111111111111111111111111111111111111111111111111111111"
published_atNiz znakova nullObvezno: Objavi izdanje · UTC

Niz znakova:format: "date-time"

Primjer: null
release_sequenceCijeli broj nullObvezno: Digitalna izdanja · Položaj u uređenoj zbirci.

Primjer: null
stateNiz znakovaObvezno: Status

Primjer: "active"
version_labelNiz znakovaObvezno: Verzija

Primjer: "1.0"
withdrawn_atNiz znakova nullObvezno: Povuci ponudu · UTC

Niz znakova:format: "date-time"

Primjer: null

Dodatna polja: Ne

ReleaseDraft

ReleaseDraft · Ova je operacija povučena i vraća 409 bez izmjene podataka. Pristup svakoj digitalnoj datoteci postavi odabirom primatelja.

changelogNiz znakovaNeobavezno: Opis promjena

maxLength: 20000

Zadano: ""
expected_versionCijeli brojObvezno: Verzija pročitana prije upisa; nepodudaranje odbija ažuriranje.

minimum: 1maximum: 9223372036854775807

Primjer: 1
version_idsPolje vrijednosti <Niz znakova> Obvezno: Verzija · UUID[]

minItems: 1maxItems: 20
Polje vrijednosti:format: "uuid"

Primjer: ["00000000-0000-4000-8000-000000000001"]
version_labelNiz znakovaObvezno: Verzija

minLength: 1maxLength: 64

Primjer: "1.0"

Dodatna polja: Ne

ReleaseFileData

ReleaseFileData · Polja, vrste i ograničenja podataka koje API prihvaća ili vraća. Nakon izrade upload_id pošaljite datoteke kao multipart/form-data i pridružite ih proizvodu. Preuzimanje zahtijeva token Bearer i ovlast za category; odgovor sadrži bajtove datoteke bez javne adrese i lozinke. Za mode=period odaberite days (1–3650) ili dosadašnji months, nikad oboje. Uvjeti se bilježe pri kupnji; povrat novca ukida pristup samo vraćenoj stavci.

file_idNiz znakovaObvezno: Identifikator resursa; sačuvajte ga u vraćenom obliku. · file_id

format: "uuid"

Primjer: "00000000-0000-4000-8000-000000000001"
sort_orderCijeli brojObvezno: Položaj u uređenoj zbirci.

Primjer: 0
version_idNiz znakovaObvezno: Identifikator resursa; sačuvajte ga u vraćenom obliku. · version_id

format: "uuid"

Primjer: "00000000-0000-4000-8000-000000000001"

Dodatna polja: Ne

ReleaseListData

ReleaseListData · Polja, vrste i ograničenja podataka koje API prihvaća ili vraća. Nakon izrade upload_id pošaljite datoteke kao multipart/form-data i pridružite ih proizvodu. Preuzimanje zahtijeva token Bearer i ovlast za category; odgovor sadrži bajtove datoteke bez javne adrese i lozinke. Za mode=period odaberite days (1–3650) ili dosadašnji months, nikad oboje. Uvjeti se bilježe pri kupnji; povrat novca ukida pristup samo vraćenoj stavci.

current_release_idNiz znakova nullObvezno: Identifikator resursa; sačuvajte ga u vraćenom obliku. · current_release_id

Niz znakova:format: "uuid"

Primjer: "00000000-0000-4000-8000-000000000001"
product_versionCijeli brojObvezno: Trenutačna verzija proizvoda za kontrolu istodobnih upisa.

Primjer: 2
releasesPolje vrijednosti <ReleaseData > Obvezno: Digitalna izdanja

Primjer: [{"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_daysCijeli broj nullObvezno: Broj dana (days; null)

Primjer: 365
update_modeNiz znakovaObvezno: Pristup budućim datotekama nakon kupnje: none / period / unlimited

Primjer: "period"
update_monthsCijeli broj nullObvezno: Mjeseci (months; null)

Primjer: null

Dodatna polja: Ne

UpdatePolicy

UpdatePolicy · Ova je operacija povučena i vraća 409 bez izmjene podataka. Pristup svakoj digitalnoj datoteci postavi odabirom primatelja.

daysCijeli broj nullNeobavezno

Broj dana (1–3650; mode=period; months=null)

Cijeli broj:minimum: 1maximum: 3650

Primjer: 365

expected_versionCijeli brojObvezno

Verzija pročitana prije upisa; nepodudaranje odbija ažuriranje.

minimum: 1maximum: 9223372036854775807

Primjer: 1

modeNiz znakovaObvezno

Pristup budućim datotekama nakon kupnje: none / period / unlimited

Ograničenja

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

Primjer: "period"

monthsCijeli broj nullNeobavezno

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

Cijeli broj:minimum: 1maximum: 120

Primjer: null

Dodatna polja: Ne

UploadCreate

UploadCreate · Polja, vrste i ograničenja podataka koje API prihvaća ili vraća. Nakon izrade upload_id pošaljite datoteke kao multipart/form-data i pridružite ih proizvodu. Preuzimanje zahtijeva token Bearer i ovlast za category; odgovor sadrži bajtove datoteke bez javne adrese i lozinke. Za mode=period odaberite days (1–3650) ili dosadašnji months, nikad oboje. Uvjeti se bilježe pri kupnji; povrat novca ukida pristup samo vraćenoj stavci.

filenameNiz znakovaObvezno

Datoteka

minLength: 1maxLength: 255

Primjer: "manual.pdf"

product_idNiz znakova nullNeobavezno

Identifikator proizvoda.

Ograničenja · Niz znakova 1

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

Primjer: "example"

sha256Niz znakovaObvezno

SHA-256 (hex, 64)

Ograničenja

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

Primjer: "5cd2f1cb0e5532b397e7ab1887baf6000c49450fd80ae279eb047c06e4545ecd"

size_bytesCijeli brojObvezno

Veličina u bajtovima

minimum: 1maximum: 262144000

Primjer: 46

Dodatna polja: Ne

UploadData

UploadData · Polja, vrste i ograničenja podataka koje API prihvaća ili vraća. Nakon izrade upload_id pošaljite datoteke kao multipart/form-data i pridružite ih proizvodu. Preuzimanje zahtijeva token Bearer i ovlast za category; odgovor sadrži bajtove datoteke bez javne adrese i lozinke. Za mode=period odaberite days (1–3650) ili dosadašnji months, nikad oboje. Uvjeti se bilježe pri kupnji; povrat novca ukida pristup samo vraćenoj stavci.

categoryFileCategory Obvezno: Kategorija datoteke: internal / customer_document / digital

Primjer: "digital"
expires_atNiz znakovaObvezno: Datum i vrijeme isteka vjerodajnice.

format: "date-time"

Primjer: "2026-01-01T12:00:00Z"
filenameNiz znakovaObvezno: Datoteka

Primjer: "manual.pdf"
idNiz znakovaObvezno: Identifikator resursa; sačuvajte ga u vraćenom obliku.

format: "uuid"

Primjer: "00000000-0000-4000-8000-000000000001"
product_idNiz znakova nullObvezno: Identifikator proizvoda.

Primjer: "example"
received_bytesCijeli brojObvezno: Prijenos… · Veličina u bajtovima

Primjer: 46
sha256Niz znakovaObvezno: SHA-256 (hex, 64)

Primjer: "5cd2f1cb0e5532b397e7ab1887baf6000c49450fd80ae279eb047c06e4545ecd"
size_bytesCijeli brojObvezno: Veličina u bajtovima

Primjer: 46
statusNiz znakovaObvezno: Status prihvaćen za ovu određenu operaciju.

Primjer: "ready"

Dodatna polja: Ne