Skemi tad-data: Prodotti

Skemi tad-data: Prodotti. L-oqsma, it-tipi u r-restrizzjonijiet tad-data li l-API taċċetta jew tirritorna.

Skemi tad-data

ApiResponse_ProductFileListData_

ApiResponse_ProductFileListData_ · L-oqsma, it-tipi u r-restrizzjonijiet tad-data li l-API taċċetta jew tirritorna. Wara li toħloq upload_id, ibgħat il-fajls bħala multipart/form-data u għaqqadhom mal-prodott. It-tniżżil jeħtieġ token Bearer u permess għal category; it-tweġiba fiha l-bytes tal-fajl mingħajr indirizz pubbliku jew password. Għal mode=period agħżel days (1–3650) jew il-valur preċedenti months, qatt it-tnejn. Il-kundizzjonijiet jinżammu max-xiri; rifużjoni tneħħi l-aċċess biss mil-linja rifuża.

dataProductFileListData Obbligatorju: Data ta’ tweġiba ta’ suċċess.

Eżempju: {"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 Obbligatorju: Metadata tat-tweġiba.

Eżempju: {"pagination":{"has_more":false,"limit":50,"next_cursor":null},"request_id":"example"}

Oqsma addizzjonali: Le

ApiResponse_ReleaseListData_

ApiResponse_ReleaseListData_ · L-oqsma, it-tipi u r-restrizzjonijiet tad-data li l-API taċċetta jew tirritorna. Wara li toħloq upload_id, ibgħat il-fajls bħala multipart/form-data u għaqqadhom mal-prodott. It-tniżżil jeħtieġ token Bearer u permess għal category; it-tweġiba fiha l-bytes tal-fajl mingħajr indirizz pubbliku jew password. Għal mode=period agħżel days (1–3650) jew il-valur preċedenti months, qatt it-tnejn. Il-kundizzjonijiet jinżammu max-xiri; rifużjoni tneħħi l-aċċess biss mil-linja rifuża.

dataReleaseListData Obbligatorju: Data ta’ tweġiba ta’ suċċess.

Eżempju: {"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 Obbligatorju: Metadata tat-tweġiba.

Eżempju: {"pagination":{"has_more":false,"limit":50,"next_cursor":null},"request_id":"example"}

Oqsma addizzjonali: Le

ApiResponse_UploadData_

ApiResponse_UploadData_ · L-oqsma, it-tipi u r-restrizzjonijiet tad-data li l-API taċċetta jew tirritorna. Wara li toħloq upload_id, ibgħat il-fajls bħala multipart/form-data u għaqqadhom mal-prodott. It-tniżżil jeħtieġ token Bearer u permess għal category; it-tweġiba fiha l-bytes tal-fajl mingħajr indirizz pubbliku jew password. Għal mode=period agħżel days (1–3650) jew il-valur preċedenti months, qatt it-tnejn. Il-kundizzjonijiet jinżammu max-xiri; rifużjoni tneħħi l-aċċess biss mil-linja rifuża.

dataUploadData Obbligatorju: Data ta’ tweġiba ta’ suċċess.

Eżempju: {"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 Obbligatorju: Metadata tat-tweġiba.

Eżempju: {"request_id":"example"}

Oqsma addizzjonali: Le

ApiResponse[AudienceData]

ApiResponse_AudienceData_ · Aqra r-regola tal-aċċess u l-verżjoni tal-prodott. L-ewwel pubblikazzjoni tibqa’ l-punt ta’ referenza fiż-żmien.

dataAudienceData Obbligatorju: Data ta’ tweġiba ta’ suċċess.

Eżempju: {"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 Obbligatorju: Metadata tat-tweġiba.

Eżempju: {"request_id":"example-request"}

Oqsma addizzjonali: Le

Elenka — Prodotti — Risposta

ApiResponse_list_ProductSummaryData__ · L-oqsma, it-tipi u r-restrizzjonijiet tad-data li l-API taċċetta jew tirritorna.

dataArray <ProductSummaryData > Obbligatorju: Eżempju ta’ tweġiba · ApiResponse_list_ProductSummaryData__.

Eżempju: [{"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 Obbligatorju: Metadata tat-tweġiba.

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

Oqsma addizzjonali: Le

Ikseb — Prodotti — Risposta

ApiResponse_ProductDetailData_ · L-oqsma, it-tipi u r-restrizzjonijiet tad-data li l-API taċċetta jew tirritorna.

dataProductDetailData Obbligatorju: Eżempju ta’ tweġiba · ProductDetailData.

Eżempju: {"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 Obbligatorju: Metadata tat-tweġiba.

Eżempju: {"locale":"en","market_code":"PL","market_id":"example","request_id":"example"}

Oqsma addizzjonali: Le

AudienceChange

AudienceChange · Agħżel xiri eliġibbli. L-ordnijiet magħżula għandu jkun fihom dan il-prodott imħallas u mhux rifuż.

audienceAudienceSelection Obbligatorju: Regola espliċita tal-aċċess għall-fajl kondiviż.

Eżempju: {"mode":"all_purchasers"}
expected_versionNumru sħiħObbligatorju: Verżjoni li nqrat qabel il-kitba; nuqqas ta’ qbil jirrifjuta l-aġġornament.

minimum: 1maximum: 9223372036854775807

Eżempju: 1

Oqsma addizzjonali: Le

AudienceData

AudienceData · Aqra r-regola tal-aċċess u l-verżjoni tal-prodott. L-ewwel pubblikazzjoni tibqa’ l-punt ta’ referenza fiż-żmien.

anchor_atStringObbligatorju: L-ewwel pubblikazzjoni; ma tinbidilx meta tinbidel ir-regola.

format: "date-time"

Eżempju: "2026-11-03T12:00:00Z"
effective_atStringObbligatorju: Ħin tal-pubblikazzjoni ta’ din ir-regola tal-aċċess.

format: "date-time"

Eżempju: "2026-11-03T12:00:00Z"
file_idStringObbligatorju: Identifikatur tar-riżorsa; żommu kif mogħti. · file_id

Eżempju: "00000000-0000-4000-8000-000000000007"
file_version_idStringObbligatorju: ID ta’ verżjoni tal-fajl li ma tistax tinbidel.

Eżempju: "00000000-0000-4000-8000-000000000010"
historical_access_preservedBooleanMhux obbligatorju: Drittijiet mogħtija qabel jinżammu meta r-regola ssir aktar restrittiva.

Valur predefinit: trueEżempju: true
idStringObbligatorju: Identifikatur tar-riżorsa; żommu kif mogħti.

Eżempju: "00000000-0000-4000-8000-000000000009"
lookback_daysNumru sħiħ nullObbligatorju: 1–3650 jum qabel l-ewwel pubblikazzjoni; recent_and_new biss.

Eżempju: null
modeStringObbligatorju: Regola espliċita tal-aċċess għall-fajl kondiviż. new_purchases / recent_and_new / selected / all_purchasers.

Eżempju: "all_purchasers"
next_cursorString nullObbligatorju: Valur ta’ kontinwazzjoni għall-paġna li jmiss, jew null.

Eżempju: null
order_idsArray <String> Obbligatorju: Ordnijiet b’dan il-prodott imħallas u mingħajr rifużjoni għalih.

Eżempju: []
product_versionNumru sħiħObbligatorju: Verżjoni attwali tal-prodott għall-kontroll tal-konkorrenza.

Eżempju: 3
revisionNumru sħiħObbligatorju: Reviżjoni sekwenzjali tar-regola tal-aċċess.

Eżempju: 1

Oqsma addizzjonali: Le

AudienceSelection

AudienceSelection · Agħżel xiri eliġibbli. L-ordnijiet magħżula għandu jkun fihom dan il-prodott imħallas u mhux rifuż.

lookback_daysNumru sħiħ nullMhux obbligatorju

1–3650 jum qabel l-ewwel pubblikazzjoni; recent_and_new biss.

Numru sħiħ:minimum: 1maximum: 3650

modeStringObbligatorju

Regola espliċita tal-aċċess għall-fajl kondiviż. new_purchases / recent_and_new / selected / all_purchasers.

Restrizzjonijiet

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

Eżempju: "new_purchases"

order_idsArray <String> Mhux obbligatorju

Ordnijiet b’dan il-prodott imħallas u mingħajr rifużjoni għalih.

maxItems: 1000

Restrizzjonijiet · Array 1

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

Valur predefinit: []

Oqsma addizzjonali: Le

Informazzjoni dwar id-disponibbiltà fil-kuntest magħżul

AvailabilityData · Skema · Skemi tad-data: Prodotti

available_fromString nullObbligatorju: Bidu tad-disponibbiltà.

String:format: "date-time"

Eżempju: null
available_untilString nullObbligatorju: Tmiem tad-disponibbiltà.

String:format: "date-time"

Eżempju: null
is_availableBooleanObbligatorju: Jekk l-oġġett huwiex disponibbli f’dan il-kuntest.

Eżempju: true

Oqsma addizzjonali: Le

FileAssign

FileAssign · L-oqsma, it-tipi u r-restrizzjonijiet tad-data li l-API taċċetta jew tirritorna. Wara li toħloq upload_id, ibgħat il-fajls bħala multipart/form-data u għaqqadhom mal-prodott. It-tniżżil jeħtieġ token Bearer u permess għal category; it-tweġiba fiha l-bytes tal-fajl mingħajr indirizz pubbliku jew password. Għal mode=period agħżel days (1–3650) jew il-valur preċedenti months, qatt it-tnejn. Il-kundizzjonijiet jinżammu max-xiri; rifużjoni tneħħi l-aċċess biss mil-linja rifuża.

audienceAudienceSelection nullMhux obbligatorju: Regola espliċita tal-aċċess għall-fajl kondiviż.

Eżempju: {"mode":"new_purchases"}
expected_versionNumru sħiħObbligatorju: Verżjoni li nqrat qabel il-kitba; nuqqas ta’ qbil jirrifjuta l-aġġornament.

minimum: 1maximum: 9223372036854775807

Eżempju: 1
labelStringMhux obbligatorju: Isem tar-riżorsa fil-kuntest rilevanti.

maxLength: 300

Valur predefinit: ""
upload_idStringObbligatorju: Identifikatur tar-riżorsa; żommu kif mogħti. · upload_id

format: "uuid"

Eżempju: "00000000-0000-4000-8000-000000000001"

Oqsma addizzjonali: Le

FileCategory

FileCategory · L-oqsma, it-tipi u r-restrizzjonijiet tad-data li l-API taċċetta jew tirritorna. Wara li toħloq upload_id, ibgħat il-fajls bħala multipart/form-data u għaqqadhom mal-prodott. It-tniżżil jeħtieġ token Bearer u permess għal category; it-tweġiba fiha l-bytes tal-fajl mingħajr indirizz pubbliku jew password. Għal mode=period agħżel days (1–3650) jew il-valur preċedenti months, qatt it-tnejn. Il-kundizzjonijiet jinżammu max-xiri; rifużjoni tneħħi l-aċċess biss mil-linja rifuża.

String

Restrizzjonijiet

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

Oqsma addizzjonali: Iva

Informazzjoni tal-prezz fil-kuntest magħżul

PriceData · Skema · Skemi tad-data: Prodotti

amountStringObbligatorju

Ammont deċimali kkodifikat bħala string JSON; null biss fejn permess.

Eżempju: "0.00"

currencyStringObbligatorju

Kodiċi tal-munita tal-ammont.

Restrizzjonijiet

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

Eżempju: "PLN"

minor_unitsNumru sħiħObbligatorju

Numru ta’ ċifri deċimali użati mill-munita.

minimum: 0maximum: 4

Eżempju: 2

tax_includedBooleanObbligatorju

Jekk il-prezz sottomess jinkludix it-taxxa.

Eżempju: true

Oqsma addizzjonali: Le

Informazzjoni tal-lista tal-prezzijiet

PriceListData · Skema · Skemi tad-data: Prodotti

currencyStringObbligatorju: Kodiċi tal-munita tal-ammont.
idStringObbligatorju: Identifikatur tar-riżorsa; żommu kif mogħti. (PriceListData).
tax_includedBooleanObbligatorju: Jekk il-prezz sottomess jinkludix it-taxxa.
versionNumru sħiħObbligatorju: Verżjoni tar-riżorsa għall-kontroll tal-konkorrenza.

Oqsma addizzjonali: Le

Oħloq — Prodotti — Kontenut tat-talba

ProductCreate · L-oqsma, it-tipi u r-restrizzjonijiet tad-data li l-API taċċetta jew tirritorna.

brand_idString nullMhux obbligatorju

Identifikatur tal-marka.

String:minLength: 1maxLength: 63

conditionStringMhux obbligatorju

Kundizzjoni tal-prodott.

Restrizzjonijiet

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

Valur predefinit: "new"

descriptionString nullMhux obbligatorju

Deskrizzjoni fil-lingwa magħżula.

String:maxLength: 100000

feature_value_idsArray <String> Mhux obbligatorju

Identifikaturi tal-valuri magħżula tal-karatteristiċi.

maxItems: 1000

Array:minLength: 1maxLength: 63

identifiersProductIdentifiers nullMhux obbligatorju

Kodiċijiet ta’ identifikazzjoni tal-prodott.

market_idsArray <String> Mhux obbligatorju

Identifikaturi tas-swieq magħżula.

maxItems: 1000

Array:minLength: 1maxLength: 63

media_idsArray <String> Mhux obbligatorju

Identifikaturi ta’ assi tal-midja li diġà jeżistu.

maxItems: 30

Array:minLength: 1maxLength: 63

meta_descriptionString nullMhux obbligatorju

Deskrizzjoni għall-magni tat-tiftix fil-lingwa magħżula.

String:maxLength: 160

meta_keywordsArray <String> nullMhux obbligatorju

Kliem ewlieni għall-magni tat-tiftix fil-lingwa magħżula.

Array:maxItems: 20

Array / Array:maxLength: 50

meta_titleString nullMhux obbligatorju

Titlu għall-magni tat-tiftix fil-lingwa magħżula.

String:maxLength: 70

nameStringObbligatorju

Isem tar-riżorsa fil-kuntest rilevanti.

minLength: 1maxLength: 300

Eżempju: "Example"

pricingProductPrice Mhux obbligatorju

Konfigurazzjoni tal-prezzijiet u l-verżjonijiet tal-konkorrenza tagħha.

primary_category_idString nullMhux obbligatorju

Identifikatur tal-kategorija ewlenija.

String:minLength: 1maxLength: 63

publishedBooleanMhux obbligatorju

Jekk ir-riżorsa hijiex ippubblikata.

Valur predefinit: false

skuStringObbligatorju

Kodiċi tal-unità ta’ ġestjoni tal-istokk.

minLength: 1maxLength: 100

Restrizzjonijiet

pattern: "^\\S+$"

Eżempju: "example"

slugString nullMhux obbligatorju

Segment tal-mogħdija URL fil-lingwa magħżula.

String:maxLength: 160

tax_category_idString nullMhux obbligatorju

Identifikatur tal-kategorija tat-taxxa.

String:minLength: 1maxLength: 63

variant_value_idsArray <String> Mhux obbligatorju

Identifikaturi tal-valuri magħżula tal-varjanti.

maxItems: 250

Array:minLength: 1maxLength: 63

variants_enabledBooleanMhux obbligatorju

Jekk il-prodott jużax varjanti.

Valur predefinit: false

Oqsma addizzjonali: Le

Ikseb — Prodotti — Risposta

ProductDetailData · L-oqsma, it-tipi u r-restrizzjonijiet tad-data li l-API taċċetta jew tirritorna.

availabilityAvailabilityData Obbligatorju

Informazzjoni dwar id-disponibbiltà fil-kuntest magħżul.

Eżempju: {"available_from":null,"available_until":null,"is_available":true}

brand_idString nullObbligatorju

Identifikatur tal-marka.

Eżempju: null

conditionStringObbligatorju

Kundizzjoni tal-prodott.

Restrizzjonijiet

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

Eżempju: "new"

created_atStringObbligatorju

Ħin tal-ħolqien.

format: "date-time"

Eżempju: "2026-01-01T12:00:00Z"

descriptionString nullObbligatorju

Deskrizzjoni fil-lingwa magħżula.

Eżempju: "example"

featuresArray <FeatureSelectionData > Obbligatorju

Karatteristiċi tal-prodott.

Eżempju: [{"feature_id":"example","feature_name":"example","value":"example","value_id":"example"}]

idStringObbligatorju

Identifikatur tar-riżorsa; żommu kif mogħti. (ProductDetailData).

Eżempju: "example"

identifiersOġġettOqsma addizzjonali: StringObbligatorju

Kodiċijiet ta’ identifikazzjoni tal-prodott.

Eżempju: {}

mediaArray <ProductMediaData > Obbligatorju

Informazzjoni dwar il-midja mehmuża.

Eżempju:

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

meta_descriptionString nullObbligatorju

Deskrizzjoni għall-magni tat-tiftix fil-lingwa magħżula.

Eżempju: "example"

meta_keywordsArray <String> nullObbligatorju

Kliem ewlieni għall-magni tat-tiftix fil-lingwa magħżula.

Eżempju: ["example"]

meta_titleString nullObbligatorju

Titlu għall-magni tat-tiftix fil-lingwa magħżula.

Eżempju: "example"

nameString nullObbligatorju

Isem tar-riżorsa fil-kuntest rilevanti.

Eżempju: "Example"

numberStringObbligatorju

Numru tal-ordni jew tat-talba muri lill-bniedem.

Eżempju: "example"

pricePriceData nullObbligatorju

Informazzjoni tal-prezz fil-kuntest magħżul.

Eżempju: {"amount":"0.00","currency":"PLN","minor_units":2,"tax_included":true}

price_versionNumru sħiħObbligatorju

Verżjoni attwali tal-prezz għall-kontroll tal-konkorrenza.

Eżempju: 1

primary_category_idString nullObbligatorju

Identifikatur tal-kategorija ewlenija.

Eżempju: "example"

primary_media_idString nullObbligatorju

Identifikatur tal-assi ewlieni tal-midja.

Eżempju: "example"

publishedBooleanObbligatorju

Jekk ir-riżorsa hijiex ippubblikata.

Eżempju: false

skuStringObbligatorju

Kodiċi tal-unità ta’ ġestjoni tal-istokk.

Eżempju: "example"

slugString nullObbligatorju

Segment tal-mogħdija URL fil-lingwa magħżula.

Eżempju: "example"

tax_category_idStringObbligatorju

Identifikatur tal-kategorija tat-taxxa.

Eżempju: "example"

updated_atStringObbligatorju

Ħin tal-aktar aġġornament reċenti.

format: "date-time"

Eżempju: "2026-01-01T12:00:00Z"

variants_enabledBooleanObbligatorju

Jekk il-prodott jużax varjanti.

Eżempju: false

versionNumru sħiħObbligatorju

Verżjoni tar-riżorsa għall-kontroll tal-konkorrenza.

Eżempju: 1

Oqsma addizzjonali: Le

ProductFileData

ProductFileData · L-oqsma, it-tipi u r-restrizzjonijiet tad-data li l-API taċċetta jew tirritorna. Wara li toħloq upload_id, ibgħat il-fajls bħala multipart/form-data u għaqqadhom mal-prodott. It-tniżżil jeħtieġ token Bearer u permess għal category; it-tweġiba fiha l-bytes tal-fajl mingħajr indirizz pubbliku jew password. Għal mode=period agħżel days (1–3650) jew il-valur preċedenti months, qatt it-tnejn. Il-kundizzjonijiet jinżammu max-xiri; rifużjoni tneħħi l-aċċess biss mil-linja rifuża.

categoryFileCategory Obbligatorju: Kategorija tal-fajl: internal / customer_document / digital

Eżempju: "digital"
created_atStringObbligatorju: Ħin tal-ħolqien.

format: "date-time"

Eżempju: "2026-01-01T12:00:00Z"
current_version_idStringObbligatorju: Identifikatur tar-riżorsa; żommu kif mogħti. · current_version_id

format: "uuid"

Eżempju: "00000000-0000-4000-8000-000000000001"
file_idStringObbligatorju: Identifikatur tar-riżorsa; żommu kif mogħti. · file_id

format: "uuid"

Eżempju: "00000000-0000-4000-8000-000000000001"
filenameStringObbligatorju: Fajl

Eżempju: "manual.pdf"
idStringObbligatorju: Identifikatur tar-riżorsa; żommu kif mogħti.

format: "uuid"

Eżempju: "00000000-0000-4000-8000-000000000001"
labelStringObbligatorju: Isem tar-riżorsa fil-kuntest rilevanti.

Eżempju: "Manual"
mime_typeStringObbligatorju: Tip tal-kontenut tal-midja.

Eżempju: "application/pdf"
sha256StringObbligatorju: SHA-256 (hex, 64)

Eżempju: "5cd2f1cb0e5532b397e7ab1887baf6000c49450fd80ae279eb047c06e4545ecd"
size_bytesNumru sħiħObbligatorju: Daqs f’bytes

Eżempju: 46
stateStringObbligatorju: Stat

Eżempju: "active"
version_numberNumru sħiħObbligatorju: Verżjoni

Eżempju: 1

Oqsma addizzjonali: Le

ProductFileListData

ProductFileListData · L-oqsma, it-tipi u r-restrizzjonijiet tad-data li l-API taċċetta jew tirritorna. Wara li toħloq upload_id, ibgħat il-fajls bħala multipart/form-data u għaqqadhom mal-prodott. It-tniżżil jeħtieġ token Bearer u permess għal category; it-tweġiba fiha l-bytes tal-fajl mingħajr indirizz pubbliku jew password. Għal mode=period agħżel days (1–3650) jew il-valur preċedenti months, qatt it-tnejn. Il-kundizzjonijiet jinżammu max-xiri; rifużjoni tneħħi l-aċċess biss mil-linja rifuża.

filesArray <ProductFileData > Obbligatorju: Fajls tal-prodott

Eżempju: [{"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_versionNumru sħiħObbligatorju: Verżjoni attwali tal-prodott għall-kontroll tal-konkorrenza.

Eżempju: 2

Oqsma addizzjonali: Le

Kodiċijiet ta’ identifikazzjoni tal-prodott

ProductIdentifiers · Skema · Skemi tad-data: Prodotti

eanString nullMhux obbligatorju: Identifikatur EAN tal-prodott.

String:minLength: 1maxLength: 100
isbnString nullMhux obbligatorju: Identifikatur ISBN.

String:minLength: 1maxLength: 100
mpnString nullMhux obbligatorju: Numru tal-parti tal-manifattur.

String:minLength: 1maxLength: 100
upcString nullMhux obbligatorju: Identifikatur UPC tal-prodott.

String:minLength: 1maxLength: 100

Oqsma addizzjonali: Le

Informazzjoni dwar il-midja mehmuża

ProductMediaData · Skema · Skemi tad-data: Prodotti

alt_textString nullObbligatorju

Test alternattiv għal stampa.

Eżempju: "example"

idStringObbligatorju

Identifikatur tar-riżorsa; żommu kif mogħti. (ProductMediaData).

Eżempju: "example"

is_primaryBooleanObbligatorju

Jekk dan huwiex l-oġġett ewlieni.

Eżempju: true

kindStringObbligatorju

Varjant tal-istruttura tad-data deskritt mill-valuri permessi tiegħu.

Restrizzjonijiet

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

Eżempju: "image"

mime_typeStringObbligatorju

Tip tal-kontenut tal-midja.

Eżempju: "image/jpeg"

positionNumru sħiħObbligatorju

Pożizzjoni fil-kollezzjoni ordnata.

Eżempju: 1

urlString nullObbligatorju

URL tar-riżorsa.

Eżempju: "https://example.invalid/product.jpg"

Oqsma addizzjonali: Le

Konfigurazzjoni tal-prezzijiet u l-verżjonijiet tal-konkorrenza tagħha

ProductPrice · Skema · Skemi tad-data: Prodotti

amountString nullObbligatorju

Ammont deċimali kkodifikat bħala string JSON; null biss fejn permess.

String:maxLength: 19

Restrizzjonijiet · String 1

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

Eżempju: "0.00"

currencyStringObbligatorju

Kodiċi tal-munita tal-ammont.

Restrizzjonijiet

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

Eżempju: "PLN"

expected_price_list_versionNumru sħiħObbligatorju

Verżjoni tal-lista tal-prezzijiet li nqrat qabel u hija meħtieġa għal din il-kitba.

minimum: 1maximum: 9223372036854775807

Eżempju: 1

expected_versionNumru sħiħObbligatorju

Verżjoni li nqrat qabel il-kitba; nuqqas ta’ qbil jirrifjuta l-aġġornament.

minimum: 0maximum: 9223372036854775807

Eżempju: 0

kindStringObbligatorju

Varjant tal-istruttura tad-data deskritt mill-valuri permessi tiegħu.

Restrizzjonijiet

enum: ["base", "market_fixed"]

Eżempju: "base"

price_list_idStringObbligatorju

Identifikatur tal-lista tal-prezzijiet.

minLength: 1maxLength: 63

Eżempju: "example"

tax_includedBooleanObbligatorju

Jekk il-prezz sottomess jinkludix it-taxxa.

Eżempju: true

Oqsma addizzjonali: Le

Elenka — Prodotti — Risposta

ProductSummaryData · L-oqsma, it-tipi u r-restrizzjonijiet tad-data li l-API taċċetta jew tirritorna.

availabilityAvailabilityData Obbligatorju

Informazzjoni dwar id-disponibbiltà fil-kuntest magħżul.

Eżempju: {"available_from":null,"available_until":null,"is_available":true}

brand_idString nullObbligatorju

Identifikatur tal-marka.

Eżempju: null

conditionStringObbligatorju

Kundizzjoni tal-prodott.

Restrizzjonijiet

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

Eżempju: "new"

created_atStringObbligatorju

Ħin tal-ħolqien.

format: "date-time"

Eżempju: "2026-01-01T12:00:00Z"

idStringObbligatorju

Identifikatur tar-riżorsa; żommu kif mogħti. (ProductSummaryData).

Eżempju: "example"

nameString nullObbligatorju

Isem tar-riżorsa fil-kuntest rilevanti.

Eżempju: "Example"

numberStringObbligatorju

Numru tal-ordni jew tat-talba muri lill-bniedem.

Eżempju: "example"

pricePriceData nullObbligatorju

Informazzjoni tal-prezz fil-kuntest magħżul.

Eżempju: {"amount":"0.00","currency":"PLN","minor_units":2,"tax_included":true}

price_versionNumru sħiħObbligatorju

Verżjoni attwali tal-prezz għall-kontroll tal-konkorrenza.

Eżempju: 1

primary_category_idString nullObbligatorju

Identifikatur tal-kategorija ewlenija.

Eżempju: "example"

primary_media_idString nullObbligatorju

Identifikatur tal-assi ewlieni tal-midja.

Eżempju: "example"

publishedBooleanObbligatorju

Jekk ir-riżorsa hijiex ippubblikata.

Eżempju: false

skuStringObbligatorju

Kodiċi tal-unità ta’ ġestjoni tal-istokk.

Eżempju: "example"

slugString nullObbligatorju

Segment tal-mogħdija URL fil-lingwa magħżula.

Eżempju: "example"

tax_category_idStringObbligatorju

Identifikatur tal-kategorija tat-taxxa.

Eżempju: "example"

updated_atStringObbligatorju

Ħin tal-aktar aġġornament reċenti.

format: "date-time"

Eżempju: "2026-01-01T12:00:00Z"

variants_enabledBooleanObbligatorju

Jekk il-prodott jużax varjanti.

Eżempju: false

versionNumru sħiħObbligatorju

Verżjoni tar-riżorsa għall-kontroll tal-konkorrenza.

Eżempju: 1

Oqsma addizzjonali: Le

Aġġorna — Prodotti — Kontenut tat-talba

ProductUpdate · L-oqsma, it-tipi u r-restrizzjonijiet tad-data li l-API taċċetta jew tirritorna.

brand_idString nullMhux obbligatorju

Identifikatur tal-marka.

String:minLength: 1maxLength: 63

conditionStringMhux obbligatorju

Kundizzjoni tal-prodott.

Restrizzjonijiet

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

descriptionString nullMhux obbligatorju

Deskrizzjoni fil-lingwa magħżula.

String:maxLength: 100000

Eżempju: null

expected_variant_price_versionsOġġettOqsma addizzjonali: Numru sħiħ

minimum: 0maximum: 9223372036854775807

Mhux obbligatorju

Verżjonijiet tal-prezzijiet li nqraw qabel, bl-identifikatur tal-varjant bħala ċavetta.

maxProperties: 250

Restrizzjonijiet

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

expected_versionNumru sħiħObbligatorju

Verżjoni li nqrat qabel il-kitba; nuqqas ta’ qbil jirrifjuta l-aġġornament.

minimum: 1maximum: 9223372036854775807

Eżempju: 1

feature_value_idsArray <String> Mhux obbligatorju

Identifikaturi tal-valuri magħżula tal-karatteristiċi.

maxItems: 1000

Array:minLength: 1maxLength: 63

identifiersProductIdentifiers nullMhux obbligatorju

Kodiċijiet ta’ identifikazzjoni tal-prodott.

market_idsArray <String> Mhux obbligatorju

Identifikaturi tas-swieq magħżula.

maxItems: 1000

Array:minLength: 1maxLength: 63

media_idsArray <String> Mhux obbligatorju

Identifikaturi ta’ assi tal-midja li diġà jeżistu.

maxItems: 30

Array:minLength: 1maxLength: 63

meta_descriptionString nullMhux obbligatorju

Deskrizzjoni għall-magni tat-tiftix fil-lingwa magħżula.

String:maxLength: 160

meta_keywordsArray <String> nullMhux obbligatorju

Kliem ewlieni għall-magni tat-tiftix fil-lingwa magħżula.

Array:maxItems: 20

Array / Array:maxLength: 50

meta_titleString nullMhux obbligatorju

Titlu għall-magni tat-tiftix fil-lingwa magħżula.

String:maxLength: 70

nameString nullMhux obbligatorju

Isem tar-riżorsa fil-kuntest rilevanti.

String:maxLength: 300

pricingProductPrice Mhux obbligatorju

Konfigurazzjoni tal-prezzijiet u l-verżjonijiet tal-konkorrenza tagħha.

Eżempju:

{"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 nullMhux obbligatorju

Identifikatur tal-kategorija ewlenija.

String:minLength: 1maxLength: 63

publishedBooleanMhux obbligatorju

Jekk ir-riżorsa hijiex ippubblikata.

skuStringMhux obbligatorju

Kodiċi tal-unità ta’ ġestjoni tal-istokk.

minLength: 1maxLength: 100

Restrizzjonijiet

pattern: "^\\S+$"

Eżempju: "example"

slugString nullMhux obbligatorju

Segment tal-mogħdija URL fil-lingwa magħżula.

String:maxLength: 160

tax_category_idString nullMhux obbligatorju

Identifikatur tal-kategorija tat-taxxa.

String:minLength: 1maxLength: 63

variant_value_idsArray <String> Mhux obbligatorju

Identifikaturi tal-valuri magħżula tal-varjanti.

maxItems: 250

Array:minLength: 1maxLength: 63

variants_enabledBooleanMhux obbligatorju

Jekk il-prodott jużax varjanti.

Oqsma addizzjonali: Le

ProductVersion

ProductVersion · Din l-operazzjoni twaqqfet u tirritorna 409 mingħajr ma tbiddel id-dejta. Issettja l-aċċess għal kull fajl diġitali billi tagħżel ir-riċevituri.

expected_versionNumru sħiħObbligatorju: Verżjoni li nqrat qabel il-kitba; nuqqas ta’ qbil jirrifjuta l-aġġornament.

minimum: 1maximum: 9223372036854775807

Eżempju: 1

Oqsma addizzjonali: Le

ReleaseData

ReleaseData · L-oqsma, it-tipi u r-restrizzjonijiet tad-data li l-API taċċetta jew tirritorna. Wara li toħloq upload_id, ibgħat il-fajls bħala multipart/form-data u għaqqadhom mal-prodott. It-tniżżil jeħtieġ token Bearer u permess għal category; it-tweġiba fiha l-bytes tal-fajl mingħajr indirizz pubbliku jew password. Għal mode=period agħżel days (1–3650) jew il-valur preċedenti months, qatt it-tnejn. Il-kundizzjonijiet jinżammu max-xiri; rifużjoni tneħħi l-aċċess biss mil-linja rifuża.

changelogStringObbligatorju: Deskrizzjoni tal-bidliet

Eżempju: "Manual update"
filesArray <ReleaseFileData > Obbligatorju: Fajls tal-prodott

Eżempju: [{"file_id":"00000000-0000-4000-8000-000000000001","sort_order":0,"version_id":"00000000-0000-4000-8000-000000000001"}]
idStringObbligatorju: Identifikatur tar-riżorsa; żommu kif mogħti.

format: "uuid"

Eżempju: "00000000-0000-4000-8000-000000000001"
manifest_sha256String nullObbligatorju: Ħarġiet diġitali · SHA-256

Eżempju: "1111111111111111111111111111111111111111111111111111111111111111"
published_atString nullObbligatorju: Ippubblika l-ħarġa · UTC

String:format: "date-time"

Eżempju: null
release_sequenceNumru sħiħ nullObbligatorju: Ħarġiet diġitali · Pożizzjoni fil-kollezzjoni ordnata.

Eżempju: null
stateStringObbligatorju: Stat

Eżempju: "active"
version_labelStringObbligatorju: Verżjoni

Eżempju: "1.0"
withdrawn_atString nullObbligatorju: Irtira l-offerta · UTC

String:format: "date-time"

Eżempju: null

Oqsma addizzjonali: Le

ReleaseDraft

ReleaseDraft · Din l-operazzjoni twaqqfet u tirritorna 409 mingħajr ma tbiddel id-dejta. Issettja l-aċċess għal kull fajl diġitali billi tagħżel ir-riċevituri.

changelogStringMhux obbligatorju: Deskrizzjoni tal-bidliet

maxLength: 20000

Valur predefinit: ""
expected_versionNumru sħiħObbligatorju: Verżjoni li nqrat qabel il-kitba; nuqqas ta’ qbil jirrifjuta l-aġġornament.

minimum: 1maximum: 9223372036854775807

Eżempju: 1
version_idsArray <String> Obbligatorju: Verżjoni · UUID[]

minItems: 1maxItems: 20
Array:format: "uuid"

Eżempju: ["00000000-0000-4000-8000-000000000001"]
version_labelStringObbligatorju: Verżjoni

minLength: 1maxLength: 64

Eżempju: "1.0"

Oqsma addizzjonali: Le

ReleaseFileData

ReleaseFileData · L-oqsma, it-tipi u r-restrizzjonijiet tad-data li l-API taċċetta jew tirritorna. Wara li toħloq upload_id, ibgħat il-fajls bħala multipart/form-data u għaqqadhom mal-prodott. It-tniżżil jeħtieġ token Bearer u permess għal category; it-tweġiba fiha l-bytes tal-fajl mingħajr indirizz pubbliku jew password. Għal mode=period agħżel days (1–3650) jew il-valur preċedenti months, qatt it-tnejn. Il-kundizzjonijiet jinżammu max-xiri; rifużjoni tneħħi l-aċċess biss mil-linja rifuża.

file_idStringObbligatorju: Identifikatur tar-riżorsa; żommu kif mogħti. · file_id

format: "uuid"

Eżempju: "00000000-0000-4000-8000-000000000001"
sort_orderNumru sħiħObbligatorju: Pożizzjoni fil-kollezzjoni ordnata.

Eżempju: 0
version_idStringObbligatorju: Identifikatur tar-riżorsa; żommu kif mogħti. · version_id

format: "uuid"

Eżempju: "00000000-0000-4000-8000-000000000001"

Oqsma addizzjonali: Le

ReleaseListData

ReleaseListData · L-oqsma, it-tipi u r-restrizzjonijiet tad-data li l-API taċċetta jew tirritorna. Wara li toħloq upload_id, ibgħat il-fajls bħala multipart/form-data u għaqqadhom mal-prodott. It-tniżżil jeħtieġ token Bearer u permess għal category; it-tweġiba fiha l-bytes tal-fajl mingħajr indirizz pubbliku jew password. Għal mode=period agħżel days (1–3650) jew il-valur preċedenti months, qatt it-tnejn. Il-kundizzjonijiet jinżammu max-xiri; rifużjoni tneħħi l-aċċess biss mil-linja rifuża.

current_release_idString nullObbligatorju: Identifikatur tar-riżorsa; żommu kif mogħti. · current_release_id

String:format: "uuid"

Eżempju: "00000000-0000-4000-8000-000000000001"
product_versionNumru sħiħObbligatorju: Verżjoni attwali tal-prodott għall-kontroll tal-konkorrenza.

Eżempju: 2
releasesArray <ReleaseData > Obbligatorju: Ħarġiet diġitali

Eżempju: [{"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_daysNumru sħiħ nullObbligatorju: Numru ta’ jiem (days; null)

Eżempju: 365
update_modeStringObbligatorju: Aċċess għal fajls futuri wara x-xiri: none / period / unlimited

Eżempju: "period"
update_monthsNumru sħiħ nullObbligatorju: Xhur (months; null)

Eżempju: null

Oqsma addizzjonali: Le

UpdatePolicy

UpdatePolicy · Din l-operazzjoni twaqqfet u tirritorna 409 mingħajr ma tbiddel id-dejta. Issettja l-aċċess għal kull fajl diġitali billi tagħżel ir-riċevituri.

daysNumru sħiħ nullMhux obbligatorju

Numru ta’ jiem (1–3650; mode=period; months=null)

Numru sħiħ:minimum: 1maximum: 3650

Eżempju: 365

expected_versionNumru sħiħObbligatorju

Verżjoni li nqrat qabel il-kitba; nuqqas ta’ qbil jirrifjuta l-aġġornament.

minimum: 1maximum: 9223372036854775807

Eżempju: 1

modeStringObbligatorju

Aċċess għal fajls futuri wara x-xiri: none / period / unlimited

Restrizzjonijiet

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

Eżempju: "period"

monthsNumru sħiħ nullMhux obbligatorju

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

Numru sħiħ:minimum: 1maximum: 120

Eżempju: null

Oqsma addizzjonali: Le

UploadCreate

UploadCreate · L-oqsma, it-tipi u r-restrizzjonijiet tad-data li l-API taċċetta jew tirritorna. Wara li toħloq upload_id, ibgħat il-fajls bħala multipart/form-data u għaqqadhom mal-prodott. It-tniżżil jeħtieġ token Bearer u permess għal category; it-tweġiba fiha l-bytes tal-fajl mingħajr indirizz pubbliku jew password. Għal mode=period agħżel days (1–3650) jew il-valur preċedenti months, qatt it-tnejn. Il-kundizzjonijiet jinżammu max-xiri; rifużjoni tneħħi l-aċċess biss mil-linja rifuża.

filenameStringObbligatorju

Fajl

minLength: 1maxLength: 255

Eżempju: "manual.pdf"

product_idString nullMhux obbligatorju

Identifikatur tal-prodott.

Restrizzjonijiet · String 1

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

Eżempju: "example"

sha256StringObbligatorju

SHA-256 (hex, 64)

Restrizzjonijiet

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

Eżempju: "5cd2f1cb0e5532b397e7ab1887baf6000c49450fd80ae279eb047c06e4545ecd"

size_bytesNumru sħiħObbligatorju

Daqs f’bytes

minimum: 1maximum: 262144000

Eżempju: 46

Oqsma addizzjonali: Le

UploadData

UploadData · L-oqsma, it-tipi u r-restrizzjonijiet tad-data li l-API taċċetta jew tirritorna. Wara li toħloq upload_id, ibgħat il-fajls bħala multipart/form-data u għaqqadhom mal-prodott. It-tniżżil jeħtieġ token Bearer u permess għal category; it-tweġiba fiha l-bytes tal-fajl mingħajr indirizz pubbliku jew password. Għal mode=period agħżel days (1–3650) jew il-valur preċedenti months, qatt it-tnejn. Il-kundizzjonijiet jinżammu max-xiri; rifużjoni tneħħi l-aċċess biss mil-linja rifuża.

categoryFileCategory Obbligatorju: Kategorija tal-fajl: internal / customer_document / digital

Eżempju: "digital"
expires_atStringObbligatorju: Data u ħin tal-iskadenza tal-kredenzjal.

format: "date-time"

Eżempju: "2026-01-01T12:00:00Z"
filenameStringObbligatorju: Fajl

Eżempju: "manual.pdf"
idStringObbligatorju: Identifikatur tar-riżorsa; żommu kif mogħti.

format: "uuid"

Eżempju: "00000000-0000-4000-8000-000000000001"
product_idString nullObbligatorju: Identifikatur tal-prodott.

Eżempju: "example"
received_bytesNumru sħiħObbligatorju: Qed jittellgħu… · Daqs f’bytes

Eżempju: 46
sha256StringObbligatorju: SHA-256 (hex, 64)

Eżempju: "5cd2f1cb0e5532b397e7ab1887baf6000c49450fd80ae279eb047c06e4545ecd"
size_bytesNumru sħiħObbligatorju: Daqs f’bytes

Eżempju: 46
statusStringObbligatorju: Status aċċettat minn din l-operazzjoni speċifika.

Eżempju: "ready"

Oqsma addizzjonali: Le