Mine sisu juurde
ShopentlyLearn
Eesti

Andmeskeemid: Tooted

Andmeskeemid: Tooted. API vastuvõetavate või tagastatavate andmete väljad, tüübid ja piirangud.

Andmeskeemid

ApiResponse_ProductFileListData_

ApiResponse_ProductFileListData_ · API vastuvõetavate või tagastatavate andmete väljad, tüübid ja piirangud. Pärast upload_id loomist saatke failid multipart/form-data kujul ja siduge need tootega. Allalaadimine nõuab Bearer-tokenit ja category õigust; vastus sisaldab faili baite ilma avaliku aadressi ja paroolita. Kui mode=period, valige days (1–3650) või senine months, mitte mõlemad. Tingimused salvestatakse ostul; tagasimakse eemaldab juurdepääsu ainult tagastatud tellimusrealt.
dataProductFileListData Kohustuslik

Eduka vastuse andmed.

Näide: {"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 Kohustuslik

Vastuse metaandmed.

Näide: {"pagination":{"has_more":false,"limit":50,"next_cursor":null},"request_id":"example"}

Lisaväljad: Ei

ApiResponse_ReleaseListData_

ApiResponse_ReleaseListData_ · API vastuvõetavate või tagastatavate andmete väljad, tüübid ja piirangud. Pärast upload_id loomist saatke failid multipart/form-data kujul ja siduge need tootega. Allalaadimine nõuab Bearer-tokenit ja category õigust; vastus sisaldab faili baite ilma avaliku aadressi ja paroolita. Kui mode=period, valige days (1–3650) või senine months, mitte mõlemad. Tingimused salvestatakse ostul; tagasimakse eemaldab juurdepääsu ainult tagastatud tellimusrealt.
dataReleaseListData Kohustuslik

Eduka vastuse andmed.

Näide: {"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 Kohustuslik

Vastuse metaandmed.

Näide: {"pagination":{"has_more":false,"limit":50,"next_cursor":null},"request_id":"example"}

Lisaväljad: Ei

ApiResponse_UploadData_

ApiResponse_UploadData_ · API vastuvõetavate või tagastatavate andmete väljad, tüübid ja piirangud. Pärast upload_id loomist saatke failid multipart/form-data kujul ja siduge need tootega. Allalaadimine nõuab Bearer-tokenit ja category õigust; vastus sisaldab faili baite ilma avaliku aadressi ja paroolita. Kui mode=period, valige days (1–3650) või senine months, mitte mõlemad. Tingimused salvestatakse ostul; tagasimakse eemaldab juurdepääsu ainult tagastatud tellimusrealt.
dataUploadData Kohustuslik

Eduka vastuse andmed.

Näide: {"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 Kohustuslik

Vastuse metaandmed.

Näide: {"request_id":"example"}

Lisaväljad: Ei

ApiResponse[AudienceData]

ApiResponse_AudienceData_ · Loe ligipääsureeglit ja toote versiooni. Esimene avaldamine jääb aja lähtepunktiks.
dataAudienceData Kohustuslik

Eduka vastuse andmed.

Näide: {"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 Kohustuslik

Vastuse metaandmed.

Näide: {"request_id":"example-request"}

Lisaväljad: Ei

Loend — Tooted — Vastus

ApiResponse_list_ProductSummaryData__ · API vastuvõetavate või tagastatavate andmete väljad, tüübid ja piirangud.
dataMassiiv <ProductSummaryData > Kohustuslik

Vastuse näide · ApiResponse_list_ProductSummaryData__.

Näide: [{"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 Kohustuslik

Vastuse metaandmed.

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

Lisaväljad: Ei

Hangi — Tooted — Vastus

ApiResponse_ProductDetailData_ · API vastuvõetavate või tagastatavate andmete väljad, tüübid ja piirangud.
dataProductDetailData Kohustuslik

Vastuse näide · ProductDetailData.

Näide: {"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 Kohustuslik

Vastuse metaandmed.

Näide: {"locale":"en","market_code":"PL","market_id":"example","request_id":"example"}

Lisaväljad: Ei

AudienceChange

AudienceChange · Vali sobivad ostud. Valitud tellimused peavad sisaldama seda toodet tasutuna ja tagastamata.
audienceAudienceSelection Kohustuslik

Jagatud faili selgesõnaline ligipääsureegel.

Näide: {"mode":"all_purchasers"}
expected_versionTäisarvKohustuslik

Enne muutmist loetud versioon; erinevuse korral lükatakse muudatus tagasi.

minimum: 1maximum: 9223372036854775807
Näide: 1

Lisaväljad: Ei

AudienceData

AudienceData · Loe ligipääsureeglit ja toote versiooni. Esimene avaldamine jääb aja lähtepunktiks.
anchor_atStringKohustuslik

Esimene avaldamine; reegli muutmine ei muuda kuupäeva.

format: "date-time"
Näide: "2026-11-03T12:00:00Z"
effective_atStringKohustuslik

Ligipääsureegli avaldamise aeg.

format: "date-time"
Näide: "2026-11-03T12:00:00Z"
file_idStringKohustuslik

Ressursi identifikaator; säilita see tagastatud kujul. · file_id

Näide: "00000000-0000-4000-8000-000000000007"
file_version_idStringKohustuslik

Muutumatu failiversiooni ID.

Näide: "00000000-0000-4000-8000-000000000010"
historical_access_preservedTõeväärtusValikuline

Varem antud õigused säilivad reegli kitsendamisel.

Vaikeväärtus: trueNäide: true
idStringKohustuslik

Ressursi identifikaator; säilita see tagastatud kujul.

Näide: "00000000-0000-4000-8000-000000000009"
lookback_daysTäisarv nullKohustuslik

1–3650 päeva enne esimest avaldamist; ainult recent_and_new.

Näide: null
modeStringKohustuslik

Jagatud faili selgesõnaline ligipääsureegel. new_purchases / recent_and_new / selected / all_purchasers.

Näide: "all_purchasers"
next_cursorString nullKohustuslik

Järgmise lehe jätkuväärtus või null.

Näide: null
order_idsMassiiv <String> Kohustuslik

Tellimused, kus see toode on tasutud ja tagastamata.

Näide: []
product_versionTäisarvKohustuslik

Toote kehtiv versioon samaaegsuse kontrolliks.

Näide: 3
revisionTäisarvKohustuslik

Ligipääsureegli järjestikune revisjon.

Näide: 1

Lisaväljad: Ei

AudienceSelection

AudienceSelection · Vali sobivad ostud. Valitud tellimused peavad sisaldama seda toodet tasutuna ja tagastamata.
lookback_daysTäisarv nullValikuline

1–3650 päeva enne esimest avaldamist; ainult recent_and_new.

Täisarv:minimum: 1maximum: 3650
modeStringKohustuslik

Jagatud faili selgesõnaline ligipääsureegel. new_purchases / recent_and_new / selected / all_purchasers.

Piirangud
enum
["new_purchases", "recent_and_new", "selected", "all_purchasers"]
Näide: "new_purchases"
order_idsMassiiv <String> Valikuline

Tellimused, kus see toode on tasutud ja tagastamata.

maxItems: 1000
Piirangud · Massiiv 1
pattern
"^[a-z0-9][a-z0-9_-]{0,62}$"
Vaikeväärtus: []

Lisaväljad: Ei

Saadavuse teave valitud kontekstis

AvailabilityData · Skeem · Andmeskeemid: Tooted
available_fromString nullKohustuslik

Saadavuse algus.

String:format: "date-time"
Näide: null
available_untilString nullKohustuslik

Saadavuse lõpp.

String:format: "date-time"
Näide: null
is_availableTõeväärtusKohustuslik

Kas kirje on selles kontekstis saadaval.

Näide: true

Lisaväljad: Ei

FileAssign

FileAssign · API vastuvõetavate või tagastatavate andmete väljad, tüübid ja piirangud. Pärast upload_id loomist saatke failid multipart/form-data kujul ja siduge need tootega. Allalaadimine nõuab Bearer-tokenit ja category õigust; vastus sisaldab faili baite ilma avaliku aadressi ja paroolita. Kui mode=period, valige days (1–3650) või senine months, mitte mõlemad. Tingimused salvestatakse ostul; tagasimakse eemaldab juurdepääsu ainult tagastatud tellimusrealt.
audienceAudienceSelection nullValikuline

Jagatud faili selgesõnaline ligipääsureegel.

Näide: {"mode":"new_purchases"}
expected_versionTäisarvKohustuslik

Enne muutmist loetud versioon; erinevuse korral lükatakse muudatus tagasi.

minimum: 1maximum: 9223372036854775807
Näide: 1
labelStringValikuline

Ressursi nimi vastavas kontekstis.

maxLength: 300
Vaikeväärtus: ""
upload_idStringKohustuslik

Ressursi identifikaator; säilita see tagastatud kujul. · upload_id

format: "uuid"
Näide: "00000000-0000-4000-8000-000000000001"

Lisaväljad: Ei

FileCategory

FileCategory · API vastuvõetavate või tagastatavate andmete väljad, tüübid ja piirangud. Pärast upload_id loomist saatke failid multipart/form-data kujul ja siduge need tootega. Allalaadimine nõuab Bearer-tokenit ja category õigust; vastus sisaldab faili baite ilma avaliku aadressi ja paroolita. Kui mode=period, valige days (1–3650) või senine months, mitte mõlemad. Tingimused salvestatakse ostul; tagasimakse eemaldab juurdepääsu ainult tagastatud tellimusrealt. String
Piirangud
enum
["internal", "customer_document", "digital"]

Lisaväljad: Jah

Hinnateave valitud kontekstis

PriceData · Skeem · Andmeskeemid: Tooted
amountStringKohustuslik

JSON-stringina kodeeritud kümnendsumma; null ainult lubatud juhtudel.

Näide: "0.00"
currencyStringKohustuslik

Summa valuutakood.

Piirangud
pattern
"^[A-Z]{3}$"
Näide: "PLN"
minor_unitsTäisarvKohustuslik

Valuuta kasutatavate kümnendkohtade arv.

minimum: 0maximum: 4
Näide: 2
tax_includedTõeväärtusKohustuslik

Kas esitatud hind sisaldab maksu.

Näide: true

Lisaväljad: Ei

Hinnakirja teave

PriceListData · Skeem · Andmeskeemid: Tooted
currencyStringKohustuslik

Summa valuutakood.

idStringKohustuslik

Ressursi identifikaator; säilita see tagastatud kujul. (PriceListData).

tax_includedTõeväärtusKohustuslik

Kas esitatud hind sisaldab maksu.

versionTäisarvKohustuslik

Ressursi versioon samaaegsuse kontrolliks.

Lisaväljad: Ei

Loo — Tooted — Päringu sisu

ProductCreate · API vastuvõetavate või tagastatavate andmete väljad, tüübid ja piirangud.
brand_idString nullValikuline

Brändi identifikaator.

String:minLength: 1maxLength: 63
conditionStringValikuline

Toote seisukord.

Piirangud
enum
["new", "refurbished", "used", "returned", "display", "damaged"]
Vaikeväärtus: "new"
descriptionString nullValikuline

Kirjeldus valitud keeles.

String:maxLength: 100000
feature_value_idsMassiiv <String> Valikuline

Valitud omaduseväärtuste identifikaatorid.

maxItems: 1000
Massiiv:minLength: 1maxLength: 63
identifiersProductIdentifiers nullValikuline

Toote tuvastuskoodid.

market_idsMassiiv <String> Valikuline

Valitud turgude identifikaatorid.

maxItems: 1000
Massiiv:minLength: 1maxLength: 63
media_idsMassiiv <String> Valikuline

Olemasolevate meediafailide identifikaatorid.

maxItems: 30
Massiiv:minLength: 1maxLength: 63
meta_descriptionString nullValikuline

Otsingumootori kirjeldus valitud keeles.

String:maxLength: 160
meta_keywordsMassiiv <String> nullValikuline

Otsingumootori märksõnad valitud keeles.

Massiiv:maxItems: 20
Massiiv / Massiiv:maxLength: 50
meta_titleString nullValikuline

Otsingumootori pealkiri valitud keeles.

String:maxLength: 70
nameStringKohustuslik

Ressursi nimi vastavas kontekstis.

minLength: 1maxLength: 300
Näide: "Example"
pricingProductPrice Valikuline

Hinnaseadistus ja selle samaaegsuse kontrolli versioonid.

primary_category_idString nullValikuline

Põhikategooria identifikaator.

String:minLength: 1maxLength: 63
publishedTõeväärtusValikuline

Kas ressurss on avaldatud.

Vaikeväärtus: false
skuStringKohustuslik

Laoarvestusühiku kood.

minLength: 1maxLength: 100
Piirangud
pattern
"^\\S+$"
Näide: "example"
slugString nullValikuline

URL-i teesegment valitud keeles.

String:maxLength: 160
tax_category_idString nullValikuline

Maksukategooria identifikaator.

String:minLength: 1maxLength: 63
variant_value_idsMassiiv <String> Valikuline

Valitud variandiväärtuste identifikaatorid.

maxItems: 250
Massiiv:minLength: 1maxLength: 63
variants_enabledTõeväärtusValikuline

Kas toode kasutab variante.

Vaikeväärtus: false

Lisaväljad: Ei

Hangi — Tooted — Vastus

ProductDetailData · API vastuvõetavate või tagastatavate andmete väljad, tüübid ja piirangud.
availabilityAvailabilityData Kohustuslik

Saadavuse teave valitud kontekstis.

Näide: {"available_from":null,"available_until":null,"is_available":true}
brand_idString nullKohustuslik

Brändi identifikaator.

Näide: null
conditionStringKohustuslik

Toote seisukord.

Piirangud
enum
["new", "refurbished", "used", "returned", "display", "damaged"]
Näide: "new"
created_atStringKohustuslik

Loomise aeg.

format: "date-time"
Näide: "2026-01-01T12:00:00Z"
descriptionString nullKohustuslik

Kirjeldus valitud keeles.

Näide: "example"
featuresMassiiv <FeatureSelectionData > Kohustuslik

Toote omadused.

Näide: [{"feature_id":"example","feature_name":"example","value":"example","value_id":"example"}]
idStringKohustuslik

Ressursi identifikaator; säilita see tagastatud kujul. (ProductDetailData).

Näide: "example"
identifiersObjektLisaväljad: StringKohustuslik

Toote tuvastuskoodid.

Näide: {}
mediaMassiiv <ProductMediaData > Kohustuslik

Lisatud meedia teave.

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

Otsingumootori kirjeldus valitud keeles.

Näide: "example"
meta_keywordsMassiiv <String> nullKohustuslik

Otsingumootori märksõnad valitud keeles.

Näide: ["example"]
meta_titleString nullKohustuslik

Otsingumootori pealkiri valitud keeles.

Näide: "example"
nameString nullKohustuslik

Ressursi nimi vastavas kontekstis.

Näide: "Example"
numberStringKohustuslik

Kasutajale mõeldud tellimuse või pöördumise number.

Näide: "example"
pricePriceData nullKohustuslik

Hinnateave valitud kontekstis.

Näide: {"amount":"0.00","currency":"PLN","minor_units":2,"tax_included":true}
price_versionTäisarvKohustuslik

Hinna kehtiv versioon samaaegsuse kontrolliks.

Näide: 1
primary_category_idString nullKohustuslik

Põhikategooria identifikaator.

Näide: "example"
primary_media_idString nullKohustuslik

Peamise meediafaili identifikaator.

Näide: "example"
publishedTõeväärtusKohustuslik

Kas ressurss on avaldatud.

Näide: false
skuStringKohustuslik

Laoarvestusühiku kood.

Näide: "example"
slugString nullKohustuslik

URL-i teesegment valitud keeles.

Näide: "example"
tax_category_idStringKohustuslik

Maksukategooria identifikaator.

Näide: "example"
updated_atStringKohustuslik

Viimase uuendamise aeg.

format: "date-time"
Näide: "2026-01-01T12:00:00Z"
variants_enabledTõeväärtusKohustuslik

Kas toode kasutab variante.

Näide: false
versionTäisarvKohustuslik

Ressursi versioon samaaegsuse kontrolliks.

Näide: 1

Lisaväljad: Ei

ProductFileData

ProductFileData · API vastuvõetavate või tagastatavate andmete väljad, tüübid ja piirangud. Pärast upload_id loomist saatke failid multipart/form-data kujul ja siduge need tootega. Allalaadimine nõuab Bearer-tokenit ja category õigust; vastus sisaldab faili baite ilma avaliku aadressi ja paroolita. Kui mode=period, valige days (1–3650) või senine months, mitte mõlemad. Tingimused salvestatakse ostul; tagasimakse eemaldab juurdepääsu ainult tagastatud tellimusrealt.
categoryFileCategory Kohustuslik

Faili kategooria: internal / customer_document / digital

Näide: "digital"
created_atStringKohustuslik

Loomise aeg.

format: "date-time"
Näide: "2026-01-01T12:00:00Z"
current_version_idStringKohustuslik

Ressursi identifikaator; säilita see tagastatud kujul. · current_version_id

format: "uuid"
Näide: "00000000-0000-4000-8000-000000000001"
file_idStringKohustuslik

Ressursi identifikaator; säilita see tagastatud kujul. · file_id

format: "uuid"
Näide: "00000000-0000-4000-8000-000000000001"
filenameStringKohustuslik

Fail

Näide: "manual.pdf"
idStringKohustuslik

Ressursi identifikaator; säilita see tagastatud kujul.

format: "uuid"
Näide: "00000000-0000-4000-8000-000000000001"
labelStringKohustuslik

Ressursi nimi vastavas kontekstis.

Näide: "Manual"
mime_typeStringKohustuslik

Meedia sisutüüp.

Näide: "application/pdf"
sha256StringKohustuslik

SHA-256 (hex, 64)

Näide: "5cd2f1cb0e5532b397e7ab1887baf6000c49450fd80ae279eb047c06e4545ecd"
size_bytesTäisarvKohustuslik

Suurus baitides

Näide: 46
stateStringKohustuslik

Olek

Näide: "active"
version_numberTäisarvKohustuslik

Versioon

Näide: 1

Lisaväljad: Ei

ProductFileListData

ProductFileListData · API vastuvõetavate või tagastatavate andmete väljad, tüübid ja piirangud. Pärast upload_id loomist saatke failid multipart/form-data kujul ja siduge need tootega. Allalaadimine nõuab Bearer-tokenit ja category õigust; vastus sisaldab faili baite ilma avaliku aadressi ja paroolita. Kui mode=period, valige days (1–3650) või senine months, mitte mõlemad. Tingimused salvestatakse ostul; tagasimakse eemaldab juurdepääsu ainult tagastatud tellimusrealt.
filesMassiiv <ProductFileData > Kohustuslik

Toote failid

Näide: [{"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_versionTäisarvKohustuslik

Toote kehtiv versioon samaaegsuse kontrolliks.

Näide: 2

Lisaväljad: Ei

Toote tuvastuskoodid

ProductIdentifiers · Skeem · Andmeskeemid: Tooted
eanString nullValikuline

Toote EAN-identifikaator.

String:minLength: 1maxLength: 100
isbnString nullValikuline

ISBN-identifikaator.

String:minLength: 1maxLength: 100
mpnString nullValikuline

Tootja tootekood.

String:minLength: 1maxLength: 100
upcString nullValikuline

Toote UPC-identifikaator.

String:minLength: 1maxLength: 100

Lisaväljad: Ei

Lisatud meedia teave

ProductMediaData · Skeem · Andmeskeemid: Tooted
alt_textString nullKohustuslik

Pildi alternatiivtekst.

Näide: "example"
idStringKohustuslik

Ressursi identifikaator; säilita see tagastatud kujul. (ProductMediaData).

Näide: "example"
is_primaryTõeväärtusKohustuslik

Kas see on põhikirje.

Näide: true
kindStringKohustuslik

Andmestruktuuri variant, mida kirjeldavad lubatud väärtused.

Piirangud
enum
["image", "video", "model_3d"]
Näide: "image"
mime_typeStringKohustuslik

Meedia sisutüüp.

Näide: "image/jpeg"
positionTäisarvKohustuslik

Asukoht järjestatud kogumis.

Näide: 1
urlString nullKohustuslik

Ressursi URL.

Näide: "https://example.invalid/product.jpg"

Lisaväljad: Ei

Hinnaseadistus ja selle samaaegsuse kontrolli versioonid

ProductPrice · Skeem · Andmeskeemid: Tooted
amountString nullKohustuslik

JSON-stringina kodeeritud kümnendsumma; null ainult lubatud juhtudel.

String:maxLength: 19
Piirangud · String 1
pattern
"^(0|[1-9][0-9]{0,13})(\\.[0-9]{1,4})?$"
Näide: "0.00"
currencyStringKohustuslik

Summa valuutakood.

Piirangud
pattern
"^[A-Z]{3}$"
Näide: "PLN"
expected_price_list_versionTäisarvKohustuslik

Selle muudatuse jaoks nõutav varem loetud hinnakirja versioon.

minimum: 1maximum: 9223372036854775807
Näide: 1
expected_versionTäisarvKohustuslik

Enne muutmist loetud versioon; erinevuse korral lükatakse muudatus tagasi.

minimum: 0maximum: 9223372036854775807
Näide: 0
kindStringKohustuslik

Andmestruktuuri variant, mida kirjeldavad lubatud väärtused.

Piirangud
enum
["base", "market_fixed"]
Näide: "base"
price_list_idStringKohustuslik

Hinnakirja identifikaator.

minLength: 1maxLength: 63
Näide: "example"
tax_includedTõeväärtusKohustuslik

Kas esitatud hind sisaldab maksu.

Näide: true

Lisaväljad: Ei

Loend — Tooted — Vastus

ProductSummaryData · API vastuvõetavate või tagastatavate andmete väljad, tüübid ja piirangud.
availabilityAvailabilityData Kohustuslik

Saadavuse teave valitud kontekstis.

Näide: {"available_from":null,"available_until":null,"is_available":true}
brand_idString nullKohustuslik

Brändi identifikaator.

Näide: null
conditionStringKohustuslik

Toote seisukord.

Piirangud
enum
["new", "refurbished", "used", "returned", "display", "damaged"]
Näide: "new"
created_atStringKohustuslik

Loomise aeg.

format: "date-time"
Näide: "2026-01-01T12:00:00Z"
idStringKohustuslik

Ressursi identifikaator; säilita see tagastatud kujul. (ProductSummaryData).

Näide: "example"
nameString nullKohustuslik

Ressursi nimi vastavas kontekstis.

Näide: "Example"
numberStringKohustuslik

Kasutajale mõeldud tellimuse või pöördumise number.

Näide: "example"
pricePriceData nullKohustuslik

Hinnateave valitud kontekstis.

Näide: {"amount":"0.00","currency":"PLN","minor_units":2,"tax_included":true}
price_versionTäisarvKohustuslik

Hinna kehtiv versioon samaaegsuse kontrolliks.

Näide: 1
primary_category_idString nullKohustuslik

Põhikategooria identifikaator.

Näide: "example"
primary_media_idString nullKohustuslik

Peamise meediafaili identifikaator.

Näide: "example"
publishedTõeväärtusKohustuslik

Kas ressurss on avaldatud.

Näide: false
skuStringKohustuslik

Laoarvestusühiku kood.

Näide: "example"
slugString nullKohustuslik

URL-i teesegment valitud keeles.

Näide: "example"
tax_category_idStringKohustuslik

Maksukategooria identifikaator.

Näide: "example"
updated_atStringKohustuslik

Viimase uuendamise aeg.

format: "date-time"
Näide: "2026-01-01T12:00:00Z"
variants_enabledTõeväärtusKohustuslik

Kas toode kasutab variante.

Näide: false
versionTäisarvKohustuslik

Ressursi versioon samaaegsuse kontrolliks.

Näide: 1

Lisaväljad: Ei

Muuda — Tooted — Päringu sisu

ProductUpdate · API vastuvõetavate või tagastatavate andmete väljad, tüübid ja piirangud.
brand_idString nullValikuline

Brändi identifikaator.

String:minLength: 1maxLength: 63
conditionStringValikuline

Toote seisukord.

Piirangud
enum
["new", "refurbished", "used", "returned", "display", "damaged"]
descriptionString nullValikuline

Kirjeldus valitud keeles.

String:maxLength: 100000
Näide: null
expected_variant_price_versionsObjektLisaväljad: Täisarv
minimum: 0maximum: 9223372036854775807
Valikuline

Varem loetud hinnaversioonid variandi identifikaatori järgi.

maxProperties: 250
Piirangud
propertyNames
{"maxLength": 63, "minLength": 1}
expected_versionTäisarvKohustuslik

Enne muutmist loetud versioon; erinevuse korral lükatakse muudatus tagasi.

minimum: 1maximum: 9223372036854775807
Näide: 1
feature_value_idsMassiiv <String> Valikuline

Valitud omaduseväärtuste identifikaatorid.

maxItems: 1000
Massiiv:minLength: 1maxLength: 63
identifiersProductIdentifiers nullValikuline

Toote tuvastuskoodid.

market_idsMassiiv <String> Valikuline

Valitud turgude identifikaatorid.

maxItems: 1000
Massiiv:minLength: 1maxLength: 63
media_idsMassiiv <String> Valikuline

Olemasolevate meediafailide identifikaatorid.

maxItems: 30
Massiiv:minLength: 1maxLength: 63
meta_descriptionString nullValikuline

Otsingumootori kirjeldus valitud keeles.

String:maxLength: 160
meta_keywordsMassiiv <String> nullValikuline

Otsingumootori märksõnad valitud keeles.

Massiiv:maxItems: 20
Massiiv / Massiiv:maxLength: 50
meta_titleString nullValikuline

Otsingumootori pealkiri valitud keeles.

String:maxLength: 70
nameString nullValikuline

Ressursi nimi vastavas kontekstis.

String:maxLength: 300
pricingProductPrice Valikuline

Hinnaseadistus ja selle samaaegsuse kontrolli versioonid.

Näide: {"amount":"0.00","currency":"PLN","expected_price_list_version":1,"expected_version":0,"kind":"base","price_list_id":"example","tax_included":true}
primary_category_idString nullValikuline

Põhikategooria identifikaator.

String:minLength: 1maxLength: 63
publishedTõeväärtusValikuline

Kas ressurss on avaldatud.

skuStringValikuline

Laoarvestusühiku kood.

minLength: 1maxLength: 100
Piirangud
pattern
"^\\S+$"
Näide: "example"
slugString nullValikuline

URL-i teesegment valitud keeles.

String:maxLength: 160
tax_category_idString nullValikuline

Maksukategooria identifikaator.

String:minLength: 1maxLength: 63
variant_value_idsMassiiv <String> Valikuline

Valitud variandiväärtuste identifikaatorid.

maxItems: 250
Massiiv:minLength: 1maxLength: 63
variants_enabledTõeväärtusValikuline

Kas toode kasutab variante.

Lisaväljad: Ei

ProductVersion

ProductVersion · See toiming on lõpetatud ja tagastab 409 andmeid muutmata. Määra iga digifaili ligipääs saajate valimise kaudu.
expected_versionTäisarvKohustuslik

Enne muutmist loetud versioon; erinevuse korral lükatakse muudatus tagasi.

minimum: 1maximum: 9223372036854775807
Näide: 1

Lisaväljad: Ei

ReleaseData

ReleaseData · API vastuvõetavate või tagastatavate andmete väljad, tüübid ja piirangud. Pärast upload_id loomist saatke failid multipart/form-data kujul ja siduge need tootega. Allalaadimine nõuab Bearer-tokenit ja category õigust; vastus sisaldab faili baite ilma avaliku aadressi ja paroolita. Kui mode=period, valige days (1–3650) või senine months, mitte mõlemad. Tingimused salvestatakse ostul; tagasimakse eemaldab juurdepääsu ainult tagastatud tellimusrealt.
changelogStringKohustuslik

Muudatuste kirjeldus

Näide: "Manual update"
filesMassiiv <ReleaseFileData > Kohustuslik

Toote failid

Näide: [{"file_id":"00000000-0000-4000-8000-000000000001","sort_order":0,"version_id":"00000000-0000-4000-8000-000000000001"}]
idStringKohustuslik

Ressursi identifikaator; säilita see tagastatud kujul.

format: "uuid"
Näide: "00000000-0000-4000-8000-000000000001"
manifest_sha256String nullKohustuslik

Digiväljalasked · SHA-256

Näide: "1111111111111111111111111111111111111111111111111111111111111111"
published_atString nullKohustuslik

Avalda väljalase · UTC

String:format: "date-time"
Näide: null
release_sequenceTäisarv nullKohustuslik

Digiväljalasked · Asukoht järjestatud kogumis.

Näide: null
stateStringKohustuslik

Olek

Näide: "active"
version_labelStringKohustuslik

Versioon

Näide: "1.0"
withdrawn_atString nullKohustuslik

Eemalda pakkumine · UTC

String:format: "date-time"
Näide: null

Lisaväljad: Ei

ReleaseDraft

ReleaseDraft · See toiming on lõpetatud ja tagastab 409 andmeid muutmata. Määra iga digifaili ligipääs saajate valimise kaudu.
changelogStringValikuline

Muudatuste kirjeldus

maxLength: 20000
Vaikeväärtus: ""
expected_versionTäisarvKohustuslik

Enne muutmist loetud versioon; erinevuse korral lükatakse muudatus tagasi.

minimum: 1maximum: 9223372036854775807
Näide: 1
version_idsMassiiv <String> Kohustuslik

Versioon · UUID[]

minItems: 1maxItems: 20
Massiiv:format: "uuid"
Näide: ["00000000-0000-4000-8000-000000000001"]
version_labelStringKohustuslik

Versioon

minLength: 1maxLength: 64
Näide: "1.0"

Lisaväljad: Ei

ReleaseFileData

ReleaseFileData · API vastuvõetavate või tagastatavate andmete väljad, tüübid ja piirangud. Pärast upload_id loomist saatke failid multipart/form-data kujul ja siduge need tootega. Allalaadimine nõuab Bearer-tokenit ja category õigust; vastus sisaldab faili baite ilma avaliku aadressi ja paroolita. Kui mode=period, valige days (1–3650) või senine months, mitte mõlemad. Tingimused salvestatakse ostul; tagasimakse eemaldab juurdepääsu ainult tagastatud tellimusrealt.
file_idStringKohustuslik

Ressursi identifikaator; säilita see tagastatud kujul. · file_id

format: "uuid"
Näide: "00000000-0000-4000-8000-000000000001"
sort_orderTäisarvKohustuslik

Asukoht järjestatud kogumis.

Näide: 0
version_idStringKohustuslik

Ressursi identifikaator; säilita see tagastatud kujul. · version_id

format: "uuid"
Näide: "00000000-0000-4000-8000-000000000001"

Lisaväljad: Ei

ReleaseListData

ReleaseListData · API vastuvõetavate või tagastatavate andmete väljad, tüübid ja piirangud. Pärast upload_id loomist saatke failid multipart/form-data kujul ja siduge need tootega. Allalaadimine nõuab Bearer-tokenit ja category õigust; vastus sisaldab faili baite ilma avaliku aadressi ja paroolita. Kui mode=period, valige days (1–3650) või senine months, mitte mõlemad. Tingimused salvestatakse ostul; tagasimakse eemaldab juurdepääsu ainult tagastatud tellimusrealt.
current_release_idString nullKohustuslik

Ressursi identifikaator; säilita see tagastatud kujul. · current_release_id

String:format: "uuid"
Näide: "00000000-0000-4000-8000-000000000001"
product_versionTäisarvKohustuslik

Toote kehtiv versioon samaaegsuse kontrolliks.

Näide: 2
releasesMassiiv <ReleaseData > Kohustuslik

Digiväljalasked

Näide: [{"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_daysTäisarv nullKohustuslik

Päevade arv (days; null)

Näide: 365
update_modeStringKohustuslik

Juurdepääs tulevastele failidele pärast ostu: none / period / unlimited

Näide: "period"
update_monthsTäisarv nullKohustuslik

Kuud (months; null)

Näide: null

Lisaväljad: Ei

UpdatePolicy

UpdatePolicy · See toiming on lõpetatud ja tagastab 409 andmeid muutmata. Määra iga digifaili ligipääs saajate valimise kaudu.
daysTäisarv nullValikuline

Päevade arv (1–3650; mode=period; months=null)

Täisarv:minimum: 1maximum: 3650
Näide: 365
expected_versionTäisarvKohustuslik

Enne muutmist loetud versioon; erinevuse korral lükatakse muudatus tagasi.

minimum: 1maximum: 9223372036854775807
Näide: 1
modeStringKohustuslik

Juurdepääs tulevastele failidele pärast ostu: none / period / unlimited

Piirangud
enum
["none", "period", "unlimited"]
Näide: "period"
monthsTäisarv nullValikuline

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

Täisarv:minimum: 1maximum: 120
Näide: null

Lisaväljad: Ei

UploadCreate

UploadCreate · API vastuvõetavate või tagastatavate andmete väljad, tüübid ja piirangud. Pärast upload_id loomist saatke failid multipart/form-data kujul ja siduge need tootega. Allalaadimine nõuab Bearer-tokenit ja category õigust; vastus sisaldab faili baite ilma avaliku aadressi ja paroolita. Kui mode=period, valige days (1–3650) või senine months, mitte mõlemad. Tingimused salvestatakse ostul; tagasimakse eemaldab juurdepääsu ainult tagastatud tellimusrealt.
filenameStringKohustuslik

Fail

minLength: 1maxLength: 255
Näide: "manual.pdf"
product_idString nullValikuline

Toote identifikaator.

Piirangud · String 1
pattern
"^[a-z0-9][a-z0-9_-]{0,62}$"
Näide: "example"
sha256StringKohustuslik

SHA-256 (hex, 64)

Piirangud
pattern
"^[0-9a-f]{64}$"
Näide: "5cd2f1cb0e5532b397e7ab1887baf6000c49450fd80ae279eb047c06e4545ecd"
size_bytesTäisarvKohustuslik

Suurus baitides

minimum: 1maximum: 262144000
Näide: 46

Lisaväljad: Ei

UploadData

UploadData · API vastuvõetavate või tagastatavate andmete väljad, tüübid ja piirangud. Pärast upload_id loomist saatke failid multipart/form-data kujul ja siduge need tootega. Allalaadimine nõuab Bearer-tokenit ja category õigust; vastus sisaldab faili baite ilma avaliku aadressi ja paroolita. Kui mode=period, valige days (1–3650) või senine months, mitte mõlemad. Tingimused salvestatakse ostul; tagasimakse eemaldab juurdepääsu ainult tagastatud tellimusrealt.
categoryFileCategory Kohustuslik

Faili kategooria: internal / customer_document / digital

Näide: "digital"
expires_atStringKohustuslik

Pääsuandmete aegumise kuupäev ja kellaaeg.

format: "date-time"
Näide: "2026-01-01T12:00:00Z"
filenameStringKohustuslik

Fail

Näide: "manual.pdf"
idStringKohustuslik

Ressursi identifikaator; säilita see tagastatud kujul.

format: "uuid"
Näide: "00000000-0000-4000-8000-000000000001"
product_idString nullKohustuslik

Toote identifikaator.

Näide: "example"
received_bytesTäisarvKohustuslik

Üleslaadimine… · Suurus baitides

Näide: 46
sha256StringKohustuslik

SHA-256 (hex, 64)

Näide: "5cd2f1cb0e5532b397e7ab1887baf6000c49450fd80ae279eb047c06e4545ecd"
size_bytesTäisarvKohustuslik

Suurus baitides

Näide: 46
statusStringKohustuslik

Selle konkreetse toimingu lubatud olek.

Näide: "ready"

Lisaväljad: Ei