Šeme podataka: Proizvodi

Šeme podataka: Proizvodi. Polja, tipovi i ograničenja podataka koje API prihvata ili vraća.

Šeme podataka

ApiResponse_ProductFileListData_

ApiResponse_ProductFileListData_ · Polja, tipovi i ograničenja podataka koje API prihvata ili vraća. Nakon kreiranja upload_id pošaljite datoteke kao multipart/form-data i povežite ih s proizvodom. Preuzimanje zahteva Bearer token i dozvolu za category; odgovor sadrži bajtove datoteke bez javne adrese i lozinke. Za mode=period izaberite days (1–3650) ili dosadašnji months, nikada oba. Uslovi se beleže pri kupovini; povraćaj novca ukida pristup samo vraćenoj stavci.

dataProductFileListData Obavezno: Podaci uspešnog odgovora.

Primer: {"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 Obavezno: Metapodaci odgovora.

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

Dodatna polja: Ne

ApiResponse_ReleaseListData_

ApiResponse_ReleaseListData_ · Polja, tipovi i ograničenja podataka koje API prihvata ili vraća. Nakon kreiranja upload_id pošaljite datoteke kao multipart/form-data i povežite ih s proizvodom. Preuzimanje zahteva Bearer token i dozvolu za category; odgovor sadrži bajtove datoteke bez javne adrese i lozinke. Za mode=period izaberite days (1–3650) ili dosadašnji months, nikada oba. Uslovi se beleže pri kupovini; povraćaj novca ukida pristup samo vraćenoj stavci.

dataReleaseListData Obavezno: Podaci uspešnog odgovora.

Primer: {"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 Obavezno: Metapodaci odgovora.

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

Dodatna polja: Ne

ApiResponse_UploadData_

ApiResponse_UploadData_ · Polja, tipovi i ograničenja podataka koje API prihvata ili vraća. Nakon kreiranja upload_id pošaljite datoteke kao multipart/form-data i povežite ih s proizvodom. Preuzimanje zahteva Bearer token i dozvolu za category; odgovor sadrži bajtove datoteke bez javne adrese i lozinke. Za mode=period izaberite days (1–3650) ili dosadašnji months, nikada oba. Uslovi se beleže pri kupovini; povraćaj novca ukida pristup samo vraćenoj stavci.

dataUploadData Obavezno: Podaci uspešnog odgovora.

Primer: {"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 Obavezno: Metapodaci odgovora.

Primer: {"request_id":"example"}

Dodatna polja: Ne

ApiResponse[AudienceData]

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

dataAudienceData Obavezno: Podaci uspešnog odgovora.

Primer: {"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 Obavezno: Metapodaci odgovora.

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

Dodatna polja: Ne

Prikaži listu — Proizvodi — Odgovor

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

dataNiz vrednosti <ProductSummaryData > Obavezno: Primer odgovora · ApiResponse_list_ProductSummaryData__.

Primer: [{"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 Obavezno: Metapodaci odgovora.

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

Dodatna polja: Ne

Preuzmi — Proizvodi — Odgovor

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

dataProductDetailData Obavezno: Primer odgovora · ProductDetailData.

Primer: {"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 Obavezno: Metapodaci odgovora.

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

Dodatna polja: Ne

AudienceChange

AudienceChange · Izaberi odgovarajuće kupovine. Izabrane porudžbine moraju sadržati plaćen proizvod za koji novac nije vraćen.

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

Primer: {"mode":"all_purchasers"}
expected_versionCeli brojObavezno: Verzija pročitana pre upisa; nepodudaranje odbija ažuriranje.

minimum: 1maximum: 9223372036854775807

Primer: 1

Dodatna polja: Ne

AudienceData

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

anchor_atNiz znakovaObavezno: Prva objava; promena pravila ne menja datum.

format: "date-time"

Primer: "2026-11-03T12:00:00Z"
effective_atNiz znakovaObavezno: Vreme objave ovog pravila pristupa.

format: "date-time"

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

Primer: "00000000-0000-4000-8000-000000000007"
file_version_idNiz znakovaObavezno: ID nepromenljive verzije datoteke.

Primer: "00000000-0000-4000-8000-000000000010"
historical_access_preservedLogička vrednostOpciono: Ranije dodeljena prava ostaju nakon sužavanja pravila.

Podrazumevano: truePrimer: true
idNiz znakovaObavezno: Identifikator resursa; sačuvajte ga u vraćenom obliku.

Primer: "00000000-0000-4000-8000-000000000009"
lookback_daysCeli broj nullObavezno: 1–3650 dana pre prve objave; samo recent_and_new.

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

Primer: "all_purchasers"
next_cursorNiz znakova nullObavezno: Vrednost za nastavak na sledeću stranicu ili null.

Primer: null
order_idsNiz vrednosti <Niz znakova> Obavezno: Porudžbine sa ovim plaćenim proizvodom bez povraćaja novca za njega.

Primer: []
product_versionCeli brojObavezno: Trenutna verzija proizvoda za kontrolu istovremenih upisa.

Primer: 3
revisionCeli brojObavezno: Uzastopna revizija pravila pristupa.

Primer: 1

Dodatna polja: Ne

AudienceSelection

AudienceSelection · Izaberi odgovarajuće kupovine. Izabrane porudžbine moraju sadržati plaćen proizvod za koji novac nije vraćen.

lookback_daysCeli broj nullOpciono

1–3650 dana pre prve objave; samo recent_and_new.

Celi broj:minimum: 1maximum: 3650

modeNiz znakovaObavezno

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"]

Primer: "new_purchases"

order_idsNiz vrednosti <Niz znakova> Opciono

Porudžbine sa ovim plaćenim proizvodom bez povraćaja novca za njega.

maxItems: 1000

Ograničenja · Niz vrednosti 1

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

Podrazumevano: []

Dodatna polja: Ne

Podaci o dostupnosti za odabrani kontekst

AvailabilityData · Šema · Šeme podataka: Proizvodi

available_fromNiz znakova nullObavezno: Početak dostupnosti.

Niz znakova:format: "date-time"

Primer: null
available_untilNiz znakova nullObavezno: Kraj dostupnosti.

Niz znakova:format: "date-time"

Primer: null
is_availableLogička vrednostObavezno: Da li je stavka dostupna u ovom kontekstu.

Primer: true

Dodatna polja: Ne

FileAssign

FileAssign · Polja, tipovi i ograničenja podataka koje API prihvata ili vraća. Nakon kreiranja upload_id pošaljite datoteke kao multipart/form-data i povežite ih s proizvodom. Preuzimanje zahteva Bearer token i dozvolu za category; odgovor sadrži bajtove datoteke bez javne adrese i lozinke. Za mode=period izaberite days (1–3650) ili dosadašnji months, nikada oba. Uslovi se beleže pri kupovini; povraćaj novca ukida pristup samo vraćenoj stavci.

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

Primer: {"mode":"new_purchases"}
expected_versionCeli brojObavezno: Verzija pročitana pre upisa; nepodudaranje odbija ažuriranje.

minimum: 1maximum: 9223372036854775807

Primer: 1
labelNiz znakovaOpciono: Naziv resursa u odgovarajućem kontekstu.

maxLength: 300

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

format: "uuid"

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

Dodatna polja: Ne

FileCategory

FileCategory · Polja, tipovi i ograničenja podataka koje API prihvata ili vraća. Nakon kreiranja upload_id pošaljite datoteke kao multipart/form-data i povežite ih s proizvodom. Preuzimanje zahteva Bearer token i dozvolu za category; odgovor sadrži bajtove datoteke bez javne adrese i lozinke. Za mode=period izaberite days (1–3650) ili dosadašnji months, nikada oba. Uslovi se beleže pri kupovini; povraćaj novca ukida pristup samo vraćenoj stavci.

Niz znakova

Ograničenja

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

Dodatna polja: Da

Podaci o ceni u odabranom kontekstu

PriceData · Šema · Šeme podataka: Proizvodi

amountNiz znakovaObavezno

Decimalni iznos kodiran kao JSON niz znakova; null samo gde je dozvoljen.

Primer: "0.00"

currencyNiz znakovaObavezno

Kod valute iznosa.

Ograničenja

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

Primer: "PLN"

minor_unitsCeli brojObavezno

Broj decimalnih cifara valute.

minimum: 0maximum: 4

Primer: 2

tax_includedLogička vrednostObavezno

Da li uključuje poslana cena porez.

Primer: true

Dodatna polja: Ne

Podaci cenovnika

PriceListData · Šema · Šeme podataka: Proizvodi

currencyNiz znakovaObavezno: Kod valute iznosa.
idNiz znakovaObavezno: Identifikator resursa; sačuvajte ga u vraćenom obliku. (PriceListData).
tax_includedLogička vrednostObavezno: Da li uključuje poslana cena porez.
versionCeli brojObavezno: Verzija resursa za kontrolu istovremenih upisa.

Dodatna polja: Ne

Kreiraj — Proizvodi — Telo zahteva

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

brand_idNiz znakova nullOpciono

Identifikator marke.

Niz znakova:minLength: 1maxLength: 63

conditionNiz znakovaOpciono

Stanje proizvoda.

Ograničenja

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

Podrazumevano: "new"

descriptionNiz znakova nullOpciono

Opis na odabranom jeziku.

Niz znakova:maxLength: 100000

feature_value_idsNiz vrednosti <Niz znakova> Opciono

Identifikatori odabranih vrednosti svojstva.

maxItems: 1000

Niz vrednosti:minLength: 1maxLength: 63

identifiersProductIdentifiers nullOpciono

Identifikacijski kodovi proizvoda.

market_idsNiz vrednosti <Niz znakova> Opciono

Identifikatori odabranih tržišta.

maxItems: 1000

Niz vrednosti:minLength: 1maxLength: 63

media_idsNiz vrednosti <Niz znakova> Opciono

Identifikatori već postojećih medijskih datoteka.

maxItems: 30

Niz vrednosti:minLength: 1maxLength: 63

meta_descriptionNiz znakova nullOpciono

Opis za pretraživače na odabranom jeziku.

Niz znakova:maxLength: 160

meta_keywordsNiz vrednosti <Niz znakova> nullOpciono

Ključne reči za pretraživače na odabranom jeziku.

Niz vrednosti:maxItems: 20

Niz vrednosti / Niz vrednosti:maxLength: 50

meta_titleNiz znakova nullOpciono

Naslov za pretraživače na odabranom jeziku.

Niz znakova:maxLength: 70

nameNiz znakovaObavezno

Naziv resursa u odgovarajućem kontekstu.

minLength: 1maxLength: 300

Primer: "Example"

pricingProductPrice Opciono

Postavke cena i njihove verzije za kontrolu istovremenih upisa.

primary_category_idNiz znakova nullOpciono

Identifikator glavne kategorije.

Niz znakova:minLength: 1maxLength: 63

publishedLogička vrednostOpciono

Da li je resurs objavljen.

Podrazumevano: false

skuNiz znakovaObavezno

Šifra skladišne jedinice.

minLength: 1maxLength: 100

Ograničenja

pattern: "^\\S+$"

Primer: "example"

slugNiz znakova nullOpciono

Deo URL putanje na odabranom jeziku.

Niz znakova:maxLength: 160

tax_category_idNiz znakova nullOpciono

Identifikator poreske kategorije.

Niz znakova:minLength: 1maxLength: 63

variant_value_idsNiz vrednosti <Niz znakova> Opciono

Identifikatori odabranih vrednosti varijante.

maxItems: 250

Niz vrednosti:minLength: 1maxLength: 63

variants_enabledLogička vrednostOpciono

Da li koristi proizvod varijante.

Podrazumevano: false

Dodatna polja: Ne

Preuzmi — Proizvodi — Odgovor

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

availabilityAvailabilityData Obavezno

Podaci o dostupnosti za odabrani kontekst.

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

brand_idNiz znakova nullObavezno

Identifikator marke.

Primer: null

conditionNiz znakovaObavezno

Stanje proizvoda.

Ograničenja

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

Primer: "new"

created_atNiz znakovaObavezno

Vreme kreiranja.

format: "date-time"

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

descriptionNiz znakova nullObavezno

Opis na odabranom jeziku.

Primer: "example"

featuresNiz vrednosti <FeatureSelectionData > Obavezno

Svojstva proizvoda.

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

idNiz znakovaObavezno

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

Primer: "example"

identifiersObjekatDodatna polja: Niz znakovaObavezno

Identifikacijski kodovi proizvoda.

Primer: {}

mediaNiz vrednosti <ProductMediaData > Obavezno

Podaci o priloženim medijima.

Primer:

[{"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 nullObavezno

Opis za pretraživače na odabranom jeziku.

Primer: "example"

meta_keywordsNiz vrednosti <Niz znakova> nullObavezno

Ključne reči za pretraživače na odabranom jeziku.

Primer: ["example"]

meta_titleNiz znakova nullObavezno

Naslov za pretraživače na odabranom jeziku.

Primer: "example"

nameNiz znakova nullObavezno

Naziv resursa u odgovarajućem kontekstu.

Primer: "Example"

numberNiz znakovaObavezno

Broj porudžbine ili zahteva namenjen korisniku.

Primer: "example"

pricePriceData nullObavezno

Podaci o ceni u odabranom kontekstu.

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

price_versionCeli brojObavezno

Trenutna verzija cene za kontrolu istovremenih upisa.

Primer: 1

primary_category_idNiz znakova nullObavezno

Identifikator glavne kategorije.

Primer: "example"

primary_media_idNiz znakova nullObavezno

Identifikator glavne medijske datoteke.

Primer: "example"

publishedLogička vrednostObavezno

Da li je resurs objavljen.

Primer: false

skuNiz znakovaObavezno

Šifra skladišne jedinice.

Primer: "example"

slugNiz znakova nullObavezno

Deo URL putanje na odabranom jeziku.

Primer: "example"

tax_category_idNiz znakovaObavezno

Identifikator poreske kategorije.

Primer: "example"

updated_atNiz znakovaObavezno

Vreme poslednjeg ažuriranja.

format: "date-time"

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

variants_enabledLogička vrednostObavezno

Da li koristi proizvod varijante.

Primer: false

versionCeli brojObavezno

Verzija resursa za kontrolu istovremenih upisa.

Primer: 1

Dodatna polja: Ne

ProductFileData

ProductFileData · Polja, tipovi i ograničenja podataka koje API prihvata ili vraća. Nakon kreiranja upload_id pošaljite datoteke kao multipart/form-data i povežite ih s proizvodom. Preuzimanje zahteva Bearer token i dozvolu za category; odgovor sadrži bajtove datoteke bez javne adrese i lozinke. Za mode=period izaberite days (1–3650) ili dosadašnji months, nikada oba. Uslovi se beleže pri kupovini; povraćaj novca ukida pristup samo vraćenoj stavci.

categoryFileCategory Obavezno: Kategorija datoteke: internal / customer_document / digital

Primer: "digital"
created_atNiz znakovaObavezno: Vreme kreiranja.

format: "date-time"

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

format: "uuid"

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

format: "uuid"

Primer: "00000000-0000-4000-8000-000000000001"
filenameNiz znakovaObavezno: Datoteka

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

format: "uuid"

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

Primer: "Manual"
mime_typeNiz znakovaObavezno: Vrsta medijskog sadržaja.

Primer: "application/pdf"
sha256Niz znakovaObavezno: SHA-256 (hex, 64)

Primer: "5cd2f1cb0e5532b397e7ab1887baf6000c49450fd80ae279eb047c06e4545ecd"
size_bytesCeli brojObavezno: Veličina u bajtovima

Primer: 46
stateNiz znakovaObavezno: Status

Primer: "active"
version_numberCeli brojObavezno: Verzija

Primer: 1

Dodatna polja: Ne

ProductFileListData

ProductFileListData · Polja, tipovi i ograničenja podataka koje API prihvata ili vraća. Nakon kreiranja upload_id pošaljite datoteke kao multipart/form-data i povežite ih s proizvodom. Preuzimanje zahteva Bearer token i dozvolu za category; odgovor sadrži bajtove datoteke bez javne adrese i lozinke. Za mode=period izaberite days (1–3650) ili dosadašnji months, nikada oba. Uslovi se beleže pri kupovini; povraćaj novca ukida pristup samo vraćenoj stavci.

filesNiz vrednosti <ProductFileData > Obavezno: Datoteke proizvoda

Primer: [{"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_versionCeli brojObavezno: Trenutna verzija proizvoda za kontrolu istovremenih upisa.

Primer: 2

Dodatna polja: Ne

Identifikacijski kodovi proizvoda

ProductIdentifiers · Šema · Šeme podataka: Proizvodi

eanNiz znakova nullOpciono: EAN identifikator proizvoda.

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

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

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

Niz znakova:minLength: 1maxLength: 100

Dodatna polja: Ne

Podaci o priloženim medijima

ProductMediaData · Šema · Šeme podataka: Proizvodi

alt_textNiz znakova nullObavezno

Zamenski tekst slike.

Primer: "example"

idNiz znakovaObavezno

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

Primer: "example"

is_primaryLogička vrednostObavezno

Da li je ovo glavna stavka.

Primer: true

kindNiz znakovaObavezno

Varijanta strukture podataka opisana dozvoljenim vrednostima.

Ograničenja

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

Primer: "image"

mime_typeNiz znakovaObavezno

Vrsta medijskog sadržaja.

Primer: "image/jpeg"

positionCeli brojObavezno

Položaj u uređenoj kolekciji.

Primer: 1

urlNiz znakova nullObavezno

URL resursa.

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

Dodatna polja: Ne

Postavke cena i njihove verzije za kontrolu istovremenih upisa

ProductPrice · Šema · Šeme podataka: Proizvodi

amountNiz znakova nullObavezno

Decimalni iznos kodiran kao JSON niz znakova; null samo gde je dozvoljen.

Niz znakova:maxLength: 19

Ograničenja · Niz znakova 1

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

Primer: "0.00"

currencyNiz znakovaObavezno

Kod valute iznosa.

Ograničenja

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

Primer: "PLN"

expected_price_list_versionCeli brojObavezno

Prethodno pročitana verzija cenovnika potrebna za ovaj upis.

minimum: 1maximum: 9223372036854775807

Primer: 1

expected_versionCeli brojObavezno

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

minimum: 0maximum: 9223372036854775807

Primer: 0

kindNiz znakovaObavezno

Varijanta strukture podataka opisana dozvoljenim vrednostima.

Ograničenja

enum: ["base", "market_fixed"]

Primer: "base"

price_list_idNiz znakovaObavezno

Identifikator cenovnika.

minLength: 1maxLength: 63

Primer: "example"

tax_includedLogička vrednostObavezno

Da li uključuje poslana cena porez.

Primer: true

Dodatna polja: Ne

Prikaži listu — Proizvodi — Odgovor

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

availabilityAvailabilityData Obavezno

Podaci o dostupnosti za odabrani kontekst.

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

brand_idNiz znakova nullObavezno

Identifikator marke.

Primer: null

conditionNiz znakovaObavezno

Stanje proizvoda.

Ograničenja

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

Primer: "new"

created_atNiz znakovaObavezno

Vreme kreiranja.

format: "date-time"

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

idNiz znakovaObavezno

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

Primer: "example"

nameNiz znakova nullObavezno

Naziv resursa u odgovarajućem kontekstu.

Primer: "Example"

numberNiz znakovaObavezno

Broj porudžbine ili zahteva namenjen korisniku.

Primer: "example"

pricePriceData nullObavezno

Podaci o ceni u odabranom kontekstu.

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

price_versionCeli brojObavezno

Trenutna verzija cene za kontrolu istovremenih upisa.

Primer: 1

primary_category_idNiz znakova nullObavezno

Identifikator glavne kategorije.

Primer: "example"

primary_media_idNiz znakova nullObavezno

Identifikator glavne medijske datoteke.

Primer: "example"

publishedLogička vrednostObavezno

Da li je resurs objavljen.

Primer: false

skuNiz znakovaObavezno

Šifra skladišne jedinice.

Primer: "example"

slugNiz znakova nullObavezno

Deo URL putanje na odabranom jeziku.

Primer: "example"

tax_category_idNiz znakovaObavezno

Identifikator poreske kategorije.

Primer: "example"

updated_atNiz znakovaObavezno

Vreme poslednjeg ažuriranja.

format: "date-time"

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

variants_enabledLogička vrednostObavezno

Da li koristi proizvod varijante.

Primer: false

versionCeli brojObavezno

Verzija resursa za kontrolu istovremenih upisa.

Primer: 1

Dodatna polja: Ne

Ažuriraj — Proizvodi — Telo zahteva

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

brand_idNiz znakova nullOpciono

Identifikator marke.

Niz znakova:minLength: 1maxLength: 63

conditionNiz znakovaOpciono

Stanje proizvoda.

Ograničenja

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

descriptionNiz znakova nullOpciono

Opis na odabranom jeziku.

Niz znakova:maxLength: 100000

Primer: null

expected_variant_price_versionsObjekatDodatna polja: Celi broj

minimum: 0maximum: 9223372036854775807

Opciono

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

maxProperties: 250

Ograničenja

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

expected_versionCeli brojObavezno

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

minimum: 1maximum: 9223372036854775807

Primer: 1

feature_value_idsNiz vrednosti <Niz znakova> Opciono

Identifikatori odabranih vrednosti svojstva.

maxItems: 1000

Niz vrednosti:minLength: 1maxLength: 63

identifiersProductIdentifiers nullOpciono

Identifikacijski kodovi proizvoda.

market_idsNiz vrednosti <Niz znakova> Opciono

Identifikatori odabranih tržišta.

maxItems: 1000

Niz vrednosti:minLength: 1maxLength: 63

media_idsNiz vrednosti <Niz znakova> Opciono

Identifikatori već postojećih medijskih datoteka.

maxItems: 30

Niz vrednosti:minLength: 1maxLength: 63

meta_descriptionNiz znakova nullOpciono

Opis za pretraživače na odabranom jeziku.

Niz znakova:maxLength: 160

meta_keywordsNiz vrednosti <Niz znakova> nullOpciono

Ključne reči za pretraživače na odabranom jeziku.

Niz vrednosti:maxItems: 20

Niz vrednosti / Niz vrednosti:maxLength: 50

meta_titleNiz znakova nullOpciono

Naslov za pretraživače na odabranom jeziku.

Niz znakova:maxLength: 70

nameNiz znakova nullOpciono

Naziv resursa u odgovarajućem kontekstu.

Niz znakova:maxLength: 300

pricingProductPrice Opciono

Postavke cena i njihove verzije za kontrolu istovremenih upisa.

Primer:

{"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 nullOpciono

Identifikator glavne kategorije.

Niz znakova:minLength: 1maxLength: 63

publishedLogička vrednostOpciono

Da li je resurs objavljen.

skuNiz znakovaOpciono

Šifra skladišne jedinice.

minLength: 1maxLength: 100

Ograničenja

pattern: "^\\S+$"

Primer: "example"

slugNiz znakova nullOpciono

Deo URL putanje na odabranom jeziku.

Niz znakova:maxLength: 160

tax_category_idNiz znakova nullOpciono

Identifikator poreske kategorije.

Niz znakova:minLength: 1maxLength: 63

variant_value_idsNiz vrednosti <Niz znakova> Opciono

Identifikatori odabranih vrednosti varijante.

maxItems: 250

Niz vrednosti:minLength: 1maxLength: 63

variants_enabledLogička vrednostOpciono

Da li koristi proizvod varijante.

Dodatna polja: Ne

ProductVersion

ProductVersion · Ova operacija je povučena i vraća 409 bez izmene podataka. Pristup svakoj digitalnoj datoteci podesi izborom primalaca.

expected_versionCeli brojObavezno: Verzija pročitana pre upisa; nepodudaranje odbija ažuriranje.

minimum: 1maximum: 9223372036854775807

Primer: 1

Dodatna polja: Ne

ReleaseData

ReleaseData · Polja, tipovi i ograničenja podataka koje API prihvata ili vraća. Nakon kreiranja upload_id pošaljite datoteke kao multipart/form-data i povežite ih s proizvodom. Preuzimanje zahteva Bearer token i dozvolu za category; odgovor sadrži bajtove datoteke bez javne adrese i lozinke. Za mode=period izaberite days (1–3650) ili dosadašnji months, nikada oba. Uslovi se beleže pri kupovini; povraćaj novca ukida pristup samo vraćenoj stavci.

changelogNiz znakovaObavezno: Opis izmena

Primer: "Manual update"
filesNiz vrednosti <ReleaseFileData > Obavezno: Datoteke proizvoda

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

format: "uuid"

Primer: "00000000-0000-4000-8000-000000000001"
manifest_sha256Niz znakova nullObavezno: Digitalna izdanja · SHA-256

Primer: "1111111111111111111111111111111111111111111111111111111111111111"
published_atNiz znakova nullObavezno: Objavi izdanje · UTC

Niz znakova:format: "date-time"

Primer: null
release_sequenceCeli broj nullObavezno: Digitalna izdanja · Položaj u uređenoj kolekciji.

Primer: null
stateNiz znakovaObavezno: Status

Primer: "active"
version_labelNiz znakovaObavezno: Verzija

Primer: "1.0"
withdrawn_atNiz znakova nullObavezno: Povuci ponudu · UTC

Niz znakova:format: "date-time"

Primer: null

Dodatna polja: Ne

ReleaseDraft

ReleaseDraft · Ova operacija je povučena i vraća 409 bez izmene podataka. Pristup svakoj digitalnoj datoteci podesi izborom primalaca.

changelogNiz znakovaOpciono: Opis izmena

maxLength: 20000

Podrazumevano: ""
expected_versionCeli brojObavezno: Verzija pročitana pre upisa; nepodudaranje odbija ažuriranje.

minimum: 1maximum: 9223372036854775807

Primer: 1
version_idsNiz vrednosti <Niz znakova> Obavezno: Verzija · UUID[]

minItems: 1maxItems: 20
Niz vrednosti:format: "uuid"

Primer: ["00000000-0000-4000-8000-000000000001"]
version_labelNiz znakovaObavezno: Verzija

minLength: 1maxLength: 64

Primer: "1.0"

Dodatna polja: Ne

ReleaseFileData

ReleaseFileData · Polja, tipovi i ograničenja podataka koje API prihvata ili vraća. Nakon kreiranja upload_id pošaljite datoteke kao multipart/form-data i povežite ih s proizvodom. Preuzimanje zahteva Bearer token i dozvolu za category; odgovor sadrži bajtove datoteke bez javne adrese i lozinke. Za mode=period izaberite days (1–3650) ili dosadašnji months, nikada oba. Uslovi se beleže pri kupovini; povraćaj novca ukida pristup samo vraćenoj stavci.

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

format: "uuid"

Primer: "00000000-0000-4000-8000-000000000001"
sort_orderCeli brojObavezno: Položaj u uređenoj kolekciji.

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

format: "uuid"

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

Dodatna polja: Ne

ReleaseListData

ReleaseListData · Polja, tipovi i ograničenja podataka koje API prihvata ili vraća. Nakon kreiranja upload_id pošaljite datoteke kao multipart/form-data i povežite ih s proizvodom. Preuzimanje zahteva Bearer token i dozvolu za category; odgovor sadrži bajtove datoteke bez javne adrese i lozinke. Za mode=period izaberite days (1–3650) ili dosadašnji months, nikada oba. Uslovi se beleže pri kupovini; povraćaj novca ukida pristup samo vraćenoj stavci.

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

Niz znakova:format: "uuid"

Primer: "00000000-0000-4000-8000-000000000001"
product_versionCeli brojObavezno: Trenutna verzija proizvoda za kontrolu istovremenih upisa.

Primer: 2
releasesNiz vrednosti <ReleaseData > Obavezno: Digitalna izdanja

Primer: [{"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_daysCeli broj nullObavezno: Broj dana (days; null)

Primer: 365
update_modeNiz znakovaObavezno: Pristup budućim datotekama nakon kupovine: none / period / unlimited

Primer: "period"
update_monthsCeli broj nullObavezno: Meseci (months; null)

Primer: null

Dodatna polja: Ne

UpdatePolicy

UpdatePolicy · Ova operacija je povučena i vraća 409 bez izmene podataka. Pristup svakoj digitalnoj datoteci podesi izborom primalaca.

daysCeli broj nullOpciono

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

Celi broj:minimum: 1maximum: 3650

Primer: 365

expected_versionCeli brojObavezno

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

minimum: 1maximum: 9223372036854775807

Primer: 1

modeNiz znakovaObavezno

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

Ograničenja

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

Primer: "period"

monthsCeli broj nullOpciono

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

Celi broj:minimum: 1maximum: 120

Primer: null

Dodatna polja: Ne

UploadCreate

UploadCreate · Polja, tipovi i ograničenja podataka koje API prihvata ili vraća. Nakon kreiranja upload_id pošaljite datoteke kao multipart/form-data i povežite ih s proizvodom. Preuzimanje zahteva Bearer token i dozvolu za category; odgovor sadrži bajtove datoteke bez javne adrese i lozinke. Za mode=period izaberite days (1–3650) ili dosadašnji months, nikada oba. Uslovi se beleže pri kupovini; povraćaj novca ukida pristup samo vraćenoj stavci.

filenameNiz znakovaObavezno

Datoteka

minLength: 1maxLength: 255

Primer: "manual.pdf"

product_idNiz znakova nullOpciono

Identifikator proizvoda.

Ograničenja · Niz znakova 1

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

Primer: "example"

sha256Niz znakovaObavezno

SHA-256 (hex, 64)

Ograničenja

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

Primer: "5cd2f1cb0e5532b397e7ab1887baf6000c49450fd80ae279eb047c06e4545ecd"

size_bytesCeli brojObavezno

Veličina u bajtovima

minimum: 1maximum: 262144000

Primer: 46

Dodatna polja: Ne

UploadData

UploadData · Polja, tipovi i ograničenja podataka koje API prihvata ili vraća. Nakon kreiranja upload_id pošaljite datoteke kao multipart/form-data i povežite ih s proizvodom. Preuzimanje zahteva Bearer token i dozvolu za category; odgovor sadrži bajtove datoteke bez javne adrese i lozinke. Za mode=period izaberite days (1–3650) ili dosadašnji months, nikada oba. Uslovi se beleže pri kupovini; povraćaj novca ukida pristup samo vraćenoj stavci.

categoryFileCategory Obavezno: Kategorija datoteke: internal / customer_document / digital

Primer: "digital"
expires_atNiz znakovaObavezno: Datum i vreme isteka akreditiva.

format: "date-time"

Primer: "2026-01-01T12:00:00Z"
filenameNiz znakovaObavezno: Datoteka

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

format: "uuid"

Primer: "00000000-0000-4000-8000-000000000001"
product_idNiz znakova nullObavezno: Identifikator proizvoda.

Primer: "example"
received_bytesCeli brojObavezno: Otpremanje… · Veličina u bajtovima

Primer: 46
sha256Niz znakovaObavezno: SHA-256 (hex, 64)

Primer: "5cd2f1cb0e5532b397e7ab1887baf6000c49450fd80ae279eb047c06e4545ecd"
size_bytesCeli brojObavezno: Veličina u bajtovima

Primer: 46
statusNiz znakovaObavezno: Status prihvaćen za ovu određenu operaciju.

Primer: "ready"

Dodatna polja: Ne