Preskoči na vsebino
ShopentlyLearn
Slovenščina

Podatkovne sheme: Izdelki

Podatkovne sheme: Izdelki. Polja, vrste in omejitve podatkov, ki jih API sprejema ali vrača.

Podatkovne sheme

ApiResponse_ProductFileListData_

ApiResponse_ProductFileListData_ · Polja, vrste in omejitve podatkov, ki jih API sprejema ali vrača. Po ustvarjanju upload_id pošljite datoteke kot multipart/form-data in jih povežite z izdelkom. Prenos zahteva žeton Bearer in dovoljenje za category; odgovor vsebuje bajte datoteke brez javnega naslova ali gesla. Za mode=period izberite days (1–3650) ali dosedanji months, nikoli obeh. Pogoji se shranijo ob nakupu; vračilo odvzame dostop samo vrnjeni postavki.
dataProductFileListData Obvezno

Vsebina uspešnega 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 Obvezno

Metapodatki odgovora.

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

Dodatna polja: Ne

ApiResponse_ReleaseListData_

ApiResponse_ReleaseListData_ · Polja, vrste in omejitve podatkov, ki jih API sprejema ali vrača. Po ustvarjanju upload_id pošljite datoteke kot multipart/form-data in jih povežite z izdelkom. Prenos zahteva žeton Bearer in dovoljenje za category; odgovor vsebuje bajte datoteke brez javnega naslova ali gesla. Za mode=period izberite days (1–3650) ali dosedanji months, nikoli obeh. Pogoji se shranijo ob nakupu; vračilo odvzame dostop samo vrnjeni postavki.
dataReleaseListData Obvezno

Vsebina uspešnega 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 Obvezno

Metapodatki odgovora.

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

Dodatna polja: Ne

ApiResponse_UploadData_

ApiResponse_UploadData_ · Polja, vrste in omejitve podatkov, ki jih API sprejema ali vrača. Po ustvarjanju upload_id pošljite datoteke kot multipart/form-data in jih povežite z izdelkom. Prenos zahteva žeton Bearer in dovoljenje za category; odgovor vsebuje bajte datoteke brez javnega naslova ali gesla. Za mode=period izberite days (1–3650) ali dosedanji months, nikoli obeh. Pogoji se shranijo ob nakupu; vračilo odvzame dostop samo vrnjeni postavki.
dataUploadData Obvezno

Vsebina uspešnega 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 Obvezno

Metapodatki odgovora.

Primer: {"request_id":"example"}

Dodatna polja: Ne

ApiResponse[AudienceData]

ApiResponse_AudienceData_ · Preberi pravilo dostopa in različico izdelka. Prva objava ostane časovna osnova.
dataAudienceData Obvezno

Vsebina uspešnega 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 Obvezno

Metapodatki odgovora.

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

Dodatna polja: Ne

Prikaži seznam — Izdelki — Odgovor

ApiResponse_list_ProductSummaryData__ · Polja, vrste in omejitve podatkov, ki jih API sprejema ali vrača.
dataPolje elementov <ProductSummaryData > Obvezno

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 Obvezno

Metapodatki 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

Pridobi — Izdelki — Odgovor

ApiResponse_ProductDetailData_ · Polja, vrste in omejitve podatkov, ki jih API sprejema ali vrača.
dataProductDetailData Obvezno

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 Obvezno

Metapodatki odgovora.

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

Dodatna polja: Ne

AudienceChange

AudienceChange · Izberi upravičene nakupe. Izbrana naročila morajo vsebovati ta izdelek, ki je plačan in ni povrnjen.
audienceAudienceSelection Obvezno

Izrecno pravilo dostopa do skupne datoteke.

Primer: {"mode":"all_purchasers"}
expected_versionCelo številoObvezno

Različica, prebrana pred zapisom; neujemanje zavrne posodobitev.

minimum: 1maximum: 9223372036854775807
Primer: 1

Dodatna polja: Ne

AudienceData

AudienceData · Preberi pravilo dostopa in različico izdelka. Prva objava ostane časovna osnova.
anchor_atNizObvezno

Prva objava; sprememba pravila ne spremeni datuma.

format: "date-time"
Primer: "2026-11-03T12:00:00Z"
effective_atNizObvezno

Čas objave tega pravila dostopa.

format: "date-time"
Primer: "2026-11-03T12:00:00Z"
file_idNizObvezno

Identifikator vira; ohranite ga v vrnjeni obliki. · file_id

Primer: "00000000-0000-4000-8000-000000000007"
file_version_idNizObvezno

ID nespremenljive različice datoteke.

Primer: "00000000-0000-4000-8000-000000000010"
historical_access_preservedLogična vrednostIzbirno

Prej dodeljene pravice ostanejo ob zožitvi pravila.

Privzeto: truePrimer: true
idNizObvezno

Identifikator vira; ohranite ga v vrnjeni obliki.

Primer: "00000000-0000-4000-8000-000000000009"
lookback_daysCelo število nullObvezno

1–3650 dni pred prvo objavo; samo recent_and_new.

Primer: null
modeNizObvezno

Izrecno pravilo dostopa do skupne datoteke. new_purchases / recent_and_new / selected / all_purchasers.

Primer: "all_purchasers"
next_cursorNiz nullObvezno

Nadaljevalna vrednost za naslednjo stran ali null.

Primer: null
order_idsPolje elementov <Niz> Obvezno

Naročila s tem plačanim izdelkom brez vračila kupnine zanj.

Primer: []
product_versionCelo številoObvezno

Trenutna različica izdelka za nadzor sočasnosti.

Primer: 3
revisionCelo številoObvezno

Zaporedna revizija pravila dostopa.

Primer: 1

Dodatna polja: Ne

AudienceSelection

AudienceSelection · Izberi upravičene nakupe. Izbrana naročila morajo vsebovati ta izdelek, ki je plačan in ni povrnjen.
lookback_daysCelo število nullIzbirno

1–3650 dni pred prvo objavo; samo recent_and_new.

Celo število:minimum: 1maximum: 3650
modeNizObvezno

Izrecno pravilo dostopa do skupne datoteke. new_purchases / recent_and_new / selected / all_purchasers.

Omejitve
enum
["new_purchases", "recent_and_new", "selected", "all_purchasers"]
Primer: "new_purchases"
order_idsPolje elementov <Niz> Izbirno

Naročila s tem plačanim izdelkom brez vračila kupnine zanj.

maxItems: 1000
Omejitve · Polje elementov 1
pattern
"^[a-z0-9][a-z0-9_-]{0,62}$"
Privzeto: []

Dodatna polja: Ne

Podatki o razpoložljivosti v izbranem kontekstu

AvailabilityData · Shema · Podatkovne sheme: Izdelki
available_fromNiz nullObvezno

Začetek razpoložljivosti.

Niz:format: "date-time"
Primer: null
available_untilNiz nullObvezno

Konec razpoložljivosti.

Niz:format: "date-time"
Primer: null
is_availableLogična vrednostObvezno

Ali je element na voljo v tem kontekstu.

Primer: true

Dodatna polja: Ne

FileAssign

FileAssign · Polja, vrste in omejitve podatkov, ki jih API sprejema ali vrača. Po ustvarjanju upload_id pošljite datoteke kot multipart/form-data in jih povežite z izdelkom. Prenos zahteva žeton Bearer in dovoljenje za category; odgovor vsebuje bajte datoteke brez javnega naslova ali gesla. Za mode=period izberite days (1–3650) ali dosedanji months, nikoli obeh. Pogoji se shranijo ob nakupu; vračilo odvzame dostop samo vrnjeni postavki.
audienceAudienceSelection nullIzbirno

Izrecno pravilo dostopa do skupne datoteke.

Primer: {"mode":"new_purchases"}
expected_versionCelo številoObvezno

Različica, prebrana pred zapisom; neujemanje zavrne posodobitev.

minimum: 1maximum: 9223372036854775807
Primer: 1
labelNizIzbirno

Ime vira v ustreznem kontekstu.

maxLength: 300
Privzeto: ""
upload_idNizObvezno

Identifikator vira; ohranite ga v vrnjeni obliki. · upload_id

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

Dodatna polja: Ne

FileCategory

FileCategory · Polja, vrste in omejitve podatkov, ki jih API sprejema ali vrača. Po ustvarjanju upload_id pošljite datoteke kot multipart/form-data in jih povežite z izdelkom. Prenos zahteva žeton Bearer in dovoljenje za category; odgovor vsebuje bajte datoteke brez javnega naslova ali gesla. Za mode=period izberite days (1–3650) ali dosedanji months, nikoli obeh. Pogoji se shranijo ob nakupu; vračilo odvzame dostop samo vrnjeni postavki. Niz
Omejitve
enum
["internal", "customer_document", "digital"]

Dodatna polja: Da

Podatki o ceni v izbranem kontekstu

PriceData · Shema · Podatkovne sheme: Izdelki
amountNizObvezno

Decimalni znesek, kodiran kot niz JSON; null le tam, kjer je dovoljen.

Primer: "0.00"
currencyNizObvezno

Koda valute zneska.

Omejitve
pattern
"^[A-Z]{3}$"
Primer: "PLN"
minor_unitsCelo številoObvezno

Število decimalnih mest valute.

minimum: 0maximum: 4
Primer: 2
tax_includedLogična vrednostObvezno

Ali posredovana cena vključuje davek.

Primer: true

Dodatna polja: Ne

Podatki cenika

PriceListData · Shema · Podatkovne sheme: Izdelki
currencyNizObvezno

Koda valute zneska.

idNizObvezno

Identifikator vira; ohranite ga v vrnjeni obliki. (PriceListData).

tax_includedLogična vrednostObvezno

Ali posredovana cena vključuje davek.

versionCelo številoObvezno

Različica vira za nadzor sočasnosti.

Dodatna polja: Ne

Ustvari — Izdelki — Telo zahteve

ProductCreate · Polja, vrste in omejitve podatkov, ki jih API sprejema ali vrača.
brand_idNiz nullIzbirno

Identifikator znamke.

Niz:minLength: 1maxLength: 63
conditionNizIzbirno

Stanje izdelka.

Omejitve
enum
["new", "refurbished", "used", "returned", "display", "damaged"]
Privzeto: "new"
descriptionNiz nullIzbirno

Opis v izbranem jeziku.

Niz:maxLength: 100000
feature_value_idsPolje elementov <Niz> Izbirno

Identifikatorji izbranih vrednosti lastnosti.

maxItems: 1000
Polje elementov:minLength: 1maxLength: 63
identifiersProductIdentifiers nullIzbirno

Identifikacijske kode izdelka.

market_idsPolje elementov <Niz> Izbirno

Identifikatorji izbranih trgov.

maxItems: 1000
Polje elementov:minLength: 1maxLength: 63
media_idsPolje elementov <Niz> Izbirno

Identifikatorji že obstoječih medijskih datotek.

maxItems: 30
Polje elementov:minLength: 1maxLength: 63
meta_descriptionNiz nullIzbirno

Opis za iskalnike v izbranem jeziku.

Niz:maxLength: 160
meta_keywordsPolje elementov <Niz> nullIzbirno

Ključne besede za iskalnike v izbranem jeziku.

Polje elementov:maxItems: 20
Polje elementov / Polje elementov:maxLength: 50
meta_titleNiz nullIzbirno

Naslov za iskalnike v izbranem jeziku.

Niz:maxLength: 70
nameNizObvezno

Ime vira v ustreznem kontekstu.

minLength: 1maxLength: 300
Primer: "Example"
pricingProductPrice Izbirno

Nastavitve cen in njihove različice za nadzor sočasnosti.

primary_category_idNiz nullIzbirno

Identifikator primarne kategorije.

Niz:minLength: 1maxLength: 63
publishedLogična vrednostIzbirno

Ali je vir objavljen.

Privzeto: false
skuNizObvezno

Koda enote za vodenje zaloge.

minLength: 1maxLength: 100
Omejitve
pattern
"^\\S+$"
Primer: "example"
slugNiz nullIzbirno

Del poti URL v izbranem jeziku.

Niz:maxLength: 160
tax_category_idNiz nullIzbirno

Identifikator davčne kategorije.

Niz:minLength: 1maxLength: 63
variant_value_idsPolje elementov <Niz> Izbirno

Identifikatorji izbranih vrednosti različic.

maxItems: 250
Polje elementov:minLength: 1maxLength: 63
variants_enabledLogična vrednostIzbirno

Ali izdelek uporablja različice.

Privzeto: false

Dodatna polja: Ne

Pridobi — Izdelki — Odgovor

ProductDetailData · Polja, vrste in omejitve podatkov, ki jih API sprejema ali vrača.
availabilityAvailabilityData Obvezno

Podatki o razpoložljivosti v izbranem kontekstu.

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

Identifikator znamke.

Primer: null
conditionNizObvezno

Stanje izdelka.

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

Čas nastanka.

format: "date-time"
Primer: "2026-01-01T12:00:00Z"
descriptionNiz nullObvezno

Opis v izbranem jeziku.

Primer: "example"
featuresPolje elementov <FeatureSelectionData > Obvezno

Lastnosti izdelka.

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

Identifikator vira; ohranite ga v vrnjeni obliki. (ProductDetailData).

Primer: "example"
identifiersObjektDodatna polja: NizObvezno

Identifikacijske kode izdelka.

Primer: {}
mediaPolje elementov <ProductMediaData > Obvezno

Podatki o priloženih medijih.

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 nullObvezno

Opis za iskalnike v izbranem jeziku.

Primer: "example"
meta_keywordsPolje elementov <Niz> nullObvezno

Ključne besede za iskalnike v izbranem jeziku.

Primer: ["example"]
meta_titleNiz nullObvezno

Naslov za iskalnike v izbranem jeziku.

Primer: "example"
nameNiz nullObvezno

Ime vira v ustreznem kontekstu.

Primer: "Example"
numberNizObvezno

Uporabniku prikazana številka naročila ali zahtevka.

Primer: "example"
pricePriceData nullObvezno

Podatki o ceni v izbranem kontekstu.

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

Trenutna različica cene za nadzor sočasnosti.

Primer: 1
primary_category_idNiz nullObvezno

Identifikator primarne kategorije.

Primer: "example"
primary_media_idNiz nullObvezno

Identifikator primarne medijske datoteke.

Primer: "example"
publishedLogična vrednostObvezno

Ali je vir objavljen.

Primer: false
skuNizObvezno

Koda enote za vodenje zaloge.

Primer: "example"
slugNiz nullObvezno

Del poti URL v izbranem jeziku.

Primer: "example"
tax_category_idNizObvezno

Identifikator davčne kategorije.

Primer: "example"
updated_atNizObvezno

Čas zadnje posodobitve.

format: "date-time"
Primer: "2026-01-01T12:00:00Z"
variants_enabledLogična vrednostObvezno

Ali izdelek uporablja različice.

Primer: false
versionCelo številoObvezno

Različica vira za nadzor sočasnosti.

Primer: 1

Dodatna polja: Ne

ProductFileData

ProductFileData · Polja, vrste in omejitve podatkov, ki jih API sprejema ali vrača. Po ustvarjanju upload_id pošljite datoteke kot multipart/form-data in jih povežite z izdelkom. Prenos zahteva žeton Bearer in dovoljenje za category; odgovor vsebuje bajte datoteke brez javnega naslova ali gesla. Za mode=period izberite days (1–3650) ali dosedanji months, nikoli obeh. Pogoji se shranijo ob nakupu; vračilo odvzame dostop samo vrnjeni postavki.
categoryFileCategory Obvezno

Kategorija datoteke: internal / customer_document / digital

Primer: "digital"
created_atNizObvezno

Čas nastanka.

format: "date-time"
Primer: "2026-01-01T12:00:00Z"
current_version_idNizObvezno

Identifikator vira; ohranite ga v vrnjeni obliki. · current_version_id

format: "uuid"
Primer: "00000000-0000-4000-8000-000000000001"
file_idNizObvezno

Identifikator vira; ohranite ga v vrnjeni obliki. · file_id

format: "uuid"
Primer: "00000000-0000-4000-8000-000000000001"
filenameNizObvezno

Datoteka

Primer: "manual.pdf"
idNizObvezno

Identifikator vira; ohranite ga v vrnjeni obliki.

format: "uuid"
Primer: "00000000-0000-4000-8000-000000000001"
labelNizObvezno

Ime vira v ustreznem kontekstu.

Primer: "Manual"
mime_typeNizObvezno

Vrsta medijske vsebine.

Primer: "application/pdf"
sha256NizObvezno

SHA-256 (hex, 64)

Primer: "5cd2f1cb0e5532b397e7ab1887baf6000c49450fd80ae279eb047c06e4545ecd"
size_bytesCelo številoObvezno

Velikost v bajtih

Primer: 46
stateNizObvezno

Stanje

Primer: "active"
version_numberCelo številoObvezno

Različica

Primer: 1

Dodatna polja: Ne

ProductFileListData

ProductFileListData · Polja, vrste in omejitve podatkov, ki jih API sprejema ali vrača. Po ustvarjanju upload_id pošljite datoteke kot multipart/form-data in jih povežite z izdelkom. Prenos zahteva žeton Bearer in dovoljenje za category; odgovor vsebuje bajte datoteke brez javnega naslova ali gesla. Za mode=period izberite days (1–3650) ali dosedanji months, nikoli obeh. Pogoji se shranijo ob nakupu; vračilo odvzame dostop samo vrnjeni postavki.
filesPolje elementov <ProductFileData > Obvezno

Datoteke izdelka

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_versionCelo številoObvezno

Trenutna različica izdelka za nadzor sočasnosti.

Primer: 2

Dodatna polja: Ne

Identifikacijske kode izdelka

ProductIdentifiers · Shema · Podatkovne sheme: Izdelki
eanNiz nullIzbirno

Identifikator izdelka EAN.

Niz:minLength: 1maxLength: 100
isbnNiz nullIzbirno

Identifikator ISBN.

Niz:minLength: 1maxLength: 100
mpnNiz nullIzbirno

Kataloška številka proizvajalca.

Niz:minLength: 1maxLength: 100
upcNiz nullIzbirno

Identifikator izdelka UPC.

Niz:minLength: 1maxLength: 100

Dodatna polja: Ne

Podatki o priloženih medijih

ProductMediaData · Shema · Podatkovne sheme: Izdelki
alt_textNiz nullObvezno

Nadomestno besedilo slike.

Primer: "example"
idNizObvezno

Identifikator vira; ohranite ga v vrnjeni obliki. (ProductMediaData).

Primer: "example"
is_primaryLogična vrednostObvezno

Ali je to primarni element.

Primer: true
kindNizObvezno

Vrsta podatkovne strukture, opisana z dovoljenimi vrednostmi.

Omejitve
enum
["image", "video", "model_3d"]
Primer: "image"
mime_typeNizObvezno

Vrsta medijske vsebine.

Primer: "image/jpeg"
positionCelo številoObvezno

Položaj v urejeni zbirki.

Primer: 1
urlNiz nullObvezno

URL vira.

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

Dodatna polja: Ne

Nastavitve cen in njihove različice za nadzor sočasnosti

ProductPrice · Shema · Podatkovne sheme: Izdelki
amountNiz nullObvezno

Decimalni znesek, kodiran kot niz JSON; null le tam, kjer je dovoljen.

Niz:maxLength: 19
Omejitve · Niz 1
pattern
"^(0|[1-9][0-9]{0,13})(\\.[0-9]{1,4})?$"
Primer: "0.00"
currencyNizObvezno

Koda valute zneska.

Omejitve
pattern
"^[A-Z]{3}$"
Primer: "PLN"
expected_price_list_versionCelo številoObvezno

Predhodno prebrana različica cenika, zahtevana za ta zapis.

minimum: 1maximum: 9223372036854775807
Primer: 1
expected_versionCelo številoObvezno

Različica, prebrana pred zapisom; neujemanje zavrne posodobitev.

minimum: 0maximum: 9223372036854775807
Primer: 0
kindNizObvezno

Vrsta podatkovne strukture, opisana z dovoljenimi vrednostmi.

Omejitve
enum
["base", "market_fixed"]
Primer: "base"
price_list_idNizObvezno

Identifikator cenika.

minLength: 1maxLength: 63
Primer: "example"
tax_includedLogična vrednostObvezno

Ali posredovana cena vključuje davek.

Primer: true

Dodatna polja: Ne

Prikaži seznam — Izdelki — Odgovor

ProductSummaryData · Polja, vrste in omejitve podatkov, ki jih API sprejema ali vrača.
availabilityAvailabilityData Obvezno

Podatki o razpoložljivosti v izbranem kontekstu.

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

Identifikator znamke.

Primer: null
conditionNizObvezno

Stanje izdelka.

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

Čas nastanka.

format: "date-time"
Primer: "2026-01-01T12:00:00Z"
idNizObvezno

Identifikator vira; ohranite ga v vrnjeni obliki. (ProductSummaryData).

Primer: "example"
nameNiz nullObvezno

Ime vira v ustreznem kontekstu.

Primer: "Example"
numberNizObvezno

Uporabniku prikazana številka naročila ali zahtevka.

Primer: "example"
pricePriceData nullObvezno

Podatki o ceni v izbranem kontekstu.

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

Trenutna različica cene za nadzor sočasnosti.

Primer: 1
primary_category_idNiz nullObvezno

Identifikator primarne kategorije.

Primer: "example"
primary_media_idNiz nullObvezno

Identifikator primarne medijske datoteke.

Primer: "example"
publishedLogična vrednostObvezno

Ali je vir objavljen.

Primer: false
skuNizObvezno

Koda enote za vodenje zaloge.

Primer: "example"
slugNiz nullObvezno

Del poti URL v izbranem jeziku.

Primer: "example"
tax_category_idNizObvezno

Identifikator davčne kategorije.

Primer: "example"
updated_atNizObvezno

Čas zadnje posodobitve.

format: "date-time"
Primer: "2026-01-01T12:00:00Z"
variants_enabledLogična vrednostObvezno

Ali izdelek uporablja različice.

Primer: false
versionCelo številoObvezno

Različica vira za nadzor sočasnosti.

Primer: 1

Dodatna polja: Ne

Posodobi — Izdelki — Telo zahteve

ProductUpdate · Polja, vrste in omejitve podatkov, ki jih API sprejema ali vrača.
brand_idNiz nullIzbirno

Identifikator znamke.

Niz:minLength: 1maxLength: 63
conditionNizIzbirno

Stanje izdelka.

Omejitve
enum
["new", "refurbished", "used", "returned", "display", "damaged"]
descriptionNiz nullIzbirno

Opis v izbranem jeziku.

Niz:maxLength: 100000
Primer: null
expected_variant_price_versionsObjektDodatna polja: Celo število
minimum: 0maximum: 9223372036854775807
Izbirno

Predhodno prebrane različice cen, urejene po identifikatorju različice izdelka.

maxProperties: 250
Omejitve
propertyNames
{"maxLength": 63, "minLength": 1}
expected_versionCelo številoObvezno

Različica, prebrana pred zapisom; neujemanje zavrne posodobitev.

minimum: 1maximum: 9223372036854775807
Primer: 1
feature_value_idsPolje elementov <Niz> Izbirno

Identifikatorji izbranih vrednosti lastnosti.

maxItems: 1000
Polje elementov:minLength: 1maxLength: 63
identifiersProductIdentifiers nullIzbirno

Identifikacijske kode izdelka.

market_idsPolje elementov <Niz> Izbirno

Identifikatorji izbranih trgov.

maxItems: 1000
Polje elementov:minLength: 1maxLength: 63
media_idsPolje elementov <Niz> Izbirno

Identifikatorji že obstoječih medijskih datotek.

maxItems: 30
Polje elementov:minLength: 1maxLength: 63
meta_descriptionNiz nullIzbirno

Opis za iskalnike v izbranem jeziku.

Niz:maxLength: 160
meta_keywordsPolje elementov <Niz> nullIzbirno

Ključne besede za iskalnike v izbranem jeziku.

Polje elementov:maxItems: 20
Polje elementov / Polje elementov:maxLength: 50
meta_titleNiz nullIzbirno

Naslov za iskalnike v izbranem jeziku.

Niz:maxLength: 70
nameNiz nullIzbirno

Ime vira v ustreznem kontekstu.

Niz:maxLength: 300
pricingProductPrice Izbirno

Nastavitve cen in njihove različice za nadzor sočasnosti.

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 nullIzbirno

Identifikator primarne kategorije.

Niz:minLength: 1maxLength: 63
publishedLogična vrednostIzbirno

Ali je vir objavljen.

skuNizIzbirno

Koda enote za vodenje zaloge.

minLength: 1maxLength: 100
Omejitve
pattern
"^\\S+$"
Primer: "example"
slugNiz nullIzbirno

Del poti URL v izbranem jeziku.

Niz:maxLength: 160
tax_category_idNiz nullIzbirno

Identifikator davčne kategorije.

Niz:minLength: 1maxLength: 63
variant_value_idsPolje elementov <Niz> Izbirno

Identifikatorji izbranih vrednosti različic.

maxItems: 250
Polje elementov:minLength: 1maxLength: 63
variants_enabledLogična vrednostIzbirno

Ali izdelek uporablja različice.

Dodatna polja: Ne

ProductVersion

ProductVersion · Ta operacija je umaknjena in vrne 409 brez spremembe podatkov. Dostop do vsake digitalne datoteke določi z izbiro prejemnikov.
expected_versionCelo številoObvezno

Različica, prebrana pred zapisom; neujemanje zavrne posodobitev.

minimum: 1maximum: 9223372036854775807
Primer: 1

Dodatna polja: Ne

ReleaseData

ReleaseData · Polja, vrste in omejitve podatkov, ki jih API sprejema ali vrača. Po ustvarjanju upload_id pošljite datoteke kot multipart/form-data in jih povežite z izdelkom. Prenos zahteva žeton Bearer in dovoljenje za category; odgovor vsebuje bajte datoteke brez javnega naslova ali gesla. Za mode=period izberite days (1–3650) ali dosedanji months, nikoli obeh. Pogoji se shranijo ob nakupu; vračilo odvzame dostop samo vrnjeni postavki.
changelogNizObvezno

Opis sprememb

Primer: "Manual update"
filesPolje elementov <ReleaseFileData > Obvezno

Datoteke izdelka

Primer: [{"file_id":"00000000-0000-4000-8000-000000000001","sort_order":0,"version_id":"00000000-0000-4000-8000-000000000001"}]
idNizObvezno

Identifikator vira; ohranite ga v vrnjeni obliki.

format: "uuid"
Primer: "00000000-0000-4000-8000-000000000001"
manifest_sha256Niz nullObvezno

Digitalne izdaje · SHA-256

Primer: "1111111111111111111111111111111111111111111111111111111111111111"
published_atNiz nullObvezno

Objavi izdajo · UTC

Niz:format: "date-time"
Primer: null
release_sequenceCelo število nullObvezno

Digitalne izdaje · Položaj v urejeni zbirki.

Primer: null
stateNizObvezno

Stanje

Primer: "active"
version_labelNizObvezno

Različica

Primer: "1.0"
withdrawn_atNiz nullObvezno

Umakni ponudbo · UTC

Niz:format: "date-time"
Primer: null

Dodatna polja: Ne

ReleaseDraft

ReleaseDraft · Ta operacija je umaknjena in vrne 409 brez spremembe podatkov. Dostop do vsake digitalne datoteke določi z izbiro prejemnikov.
changelogNizIzbirno

Opis sprememb

maxLength: 20000
Privzeto: ""
expected_versionCelo številoObvezno

Različica, prebrana pred zapisom; neujemanje zavrne posodobitev.

minimum: 1maximum: 9223372036854775807
Primer: 1
version_idsPolje elementov <Niz> Obvezno

Različica · UUID[]

minItems: 1maxItems: 20
Polje elementov:format: "uuid"
Primer: ["00000000-0000-4000-8000-000000000001"]
version_labelNizObvezno

Različica

minLength: 1maxLength: 64
Primer: "1.0"

Dodatna polja: Ne

ReleaseFileData

ReleaseFileData · Polja, vrste in omejitve podatkov, ki jih API sprejema ali vrača. Po ustvarjanju upload_id pošljite datoteke kot multipart/form-data in jih povežite z izdelkom. Prenos zahteva žeton Bearer in dovoljenje za category; odgovor vsebuje bajte datoteke brez javnega naslova ali gesla. Za mode=period izberite days (1–3650) ali dosedanji months, nikoli obeh. Pogoji se shranijo ob nakupu; vračilo odvzame dostop samo vrnjeni postavki.
file_idNizObvezno

Identifikator vira; ohranite ga v vrnjeni obliki. · file_id

format: "uuid"
Primer: "00000000-0000-4000-8000-000000000001"
sort_orderCelo številoObvezno

Položaj v urejeni zbirki.

Primer: 0
version_idNizObvezno

Identifikator vira; ohranite ga v vrnjeni obliki. · version_id

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

Dodatna polja: Ne

ReleaseListData

ReleaseListData · Polja, vrste in omejitve podatkov, ki jih API sprejema ali vrača. Po ustvarjanju upload_id pošljite datoteke kot multipart/form-data in jih povežite z izdelkom. Prenos zahteva žeton Bearer in dovoljenje za category; odgovor vsebuje bajte datoteke brez javnega naslova ali gesla. Za mode=period izberite days (1–3650) ali dosedanji months, nikoli obeh. Pogoji se shranijo ob nakupu; vračilo odvzame dostop samo vrnjeni postavki.
current_release_idNiz nullObvezno

Identifikator vira; ohranite ga v vrnjeni obliki. · current_release_id

Niz:format: "uuid"
Primer: "00000000-0000-4000-8000-000000000001"
product_versionCelo številoObvezno

Trenutna različica izdelka za nadzor sočasnosti.

Primer: 2
releasesPolje elementov <ReleaseData > Obvezno

Digitalne izdaje

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_daysCelo število nullObvezno

Število dni (days; null)

Primer: 365
update_modeNizObvezno

Dostop do prihodnjih datotek po nakupu: none / period / unlimited

Primer: "period"
update_monthsCelo število nullObvezno

Meseci (months; null)

Primer: null

Dodatna polja: Ne

UpdatePolicy

UpdatePolicy · Ta operacija je umaknjena in vrne 409 brez spremembe podatkov. Dostop do vsake digitalne datoteke določi z izbiro prejemnikov.
daysCelo število nullIzbirno

Število dni (1–3650; mode=period; months=null)

Celo število:minimum: 1maximum: 3650
Primer: 365
expected_versionCelo številoObvezno

Različica, prebrana pred zapisom; neujemanje zavrne posodobitev.

minimum: 1maximum: 9223372036854775807
Primer: 1
modeNizObvezno

Dostop do prihodnjih datotek po nakupu: none / period / unlimited

Omejitve
enum
["none", "period", "unlimited"]
Primer: "period"
monthsCelo število nullIzbirno

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

Celo število:minimum: 1maximum: 120
Primer: null

Dodatna polja: Ne

UploadCreate

UploadCreate · Polja, vrste in omejitve podatkov, ki jih API sprejema ali vrača. Po ustvarjanju upload_id pošljite datoteke kot multipart/form-data in jih povežite z izdelkom. Prenos zahteva žeton Bearer in dovoljenje za category; odgovor vsebuje bajte datoteke brez javnega naslova ali gesla. Za mode=period izberite days (1–3650) ali dosedanji months, nikoli obeh. Pogoji se shranijo ob nakupu; vračilo odvzame dostop samo vrnjeni postavki.
filenameNizObvezno

Datoteka

minLength: 1maxLength: 255
Primer: "manual.pdf"
product_idNiz nullIzbirno

Identifikator izdelka.

Omejitve · Niz 1
pattern
"^[a-z0-9][a-z0-9_-]{0,62}$"
Primer: "example"
sha256NizObvezno

SHA-256 (hex, 64)

Omejitve
pattern
"^[0-9a-f]{64}$"
Primer: "5cd2f1cb0e5532b397e7ab1887baf6000c49450fd80ae279eb047c06e4545ecd"
size_bytesCelo številoObvezno

Velikost v bajtih

minimum: 1maximum: 262144000
Primer: 46

Dodatna polja: Ne

UploadData

UploadData · Polja, vrste in omejitve podatkov, ki jih API sprejema ali vrača. Po ustvarjanju upload_id pošljite datoteke kot multipart/form-data in jih povežite z izdelkom. Prenos zahteva žeton Bearer in dovoljenje za category; odgovor vsebuje bajte datoteke brez javnega naslova ali gesla. Za mode=period izberite days (1–3650) ali dosedanji months, nikoli obeh. Pogoji se shranijo ob nakupu; vračilo odvzame dostop samo vrnjeni postavki.
categoryFileCategory Obvezno

Kategorija datoteke: internal / customer_document / digital

Primer: "digital"
expires_atNizObvezno

Datum in čas poteka poverilnice.

format: "date-time"
Primer: "2026-01-01T12:00:00Z"
filenameNizObvezno

Datoteka

Primer: "manual.pdf"
idNizObvezno

Identifikator vira; ohranite ga v vrnjeni obliki.

format: "uuid"
Primer: "00000000-0000-4000-8000-000000000001"
product_idNiz nullObvezno

Identifikator izdelka.

Primer: "example"
received_bytesCelo številoObvezno

Nalaganje… · Velikost v bajtih

Primer: 46
sha256NizObvezno

SHA-256 (hex, 64)

Primer: "5cd2f1cb0e5532b397e7ab1887baf6000c49450fd80ae279eb047c06e4545ecd"
size_bytesCelo številoObvezno

Velikost v bajtih

Primer: 46
statusNizObvezno

Status, ki ga sprejema ta operacija.

Primer: "ready"

Dodatna polja: Ne