Pređi na sadržaj
ShopentlyLearn

Šeme podataka: Proizvodi

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

Šeme podataka

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

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

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

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: 20
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
Primer: null
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