Scheme de date: Produse

Scheme de date: Produse. Câmpurile, tipurile și restricțiile datelor acceptate sau returnate de API.

Scheme de date

ApiResponse_ProductFileListData_

ApiResponse_ProductFileListData_ · Câmpurile, tipurile și restricțiile datelor acceptate sau returnate de API. Trimite fișierele ca multipart/form-data după crearea upload_id, apoi asociază-le produsului. Descărcarea necesită un token Bearer și permisiunea pentru category; răspunsul conține octeții fișierului, fără adresă publică sau parolă. Pentru mode=period alege days (1–3650) sau vechiul months, niciodată ambele. Condițiile se păstrează la cumpărare; rambursarea retrage accesul doar pentru poziția rambursată.

dataProductFileListData Obligatoriu: Datele unui răspuns reușit.

Exemplu: {"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 Obligatoriu: Metadatele răspunsului.

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

Câmpuri suplimentare: Nu

ApiResponse_ReleaseListData_

ApiResponse_ReleaseListData_ · Câmpurile, tipurile și restricțiile datelor acceptate sau returnate de API. Trimite fișierele ca multipart/form-data după crearea upload_id, apoi asociază-le produsului. Descărcarea necesită un token Bearer și permisiunea pentru category; răspunsul conține octeții fișierului, fără adresă publică sau parolă. Pentru mode=period alege days (1–3650) sau vechiul months, niciodată ambele. Condițiile se păstrează la cumpărare; rambursarea retrage accesul doar pentru poziția rambursată.

dataReleaseListData Obligatoriu: Datele unui răspuns reușit.

Exemplu: {"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 Obligatoriu: Metadatele răspunsului.

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

Câmpuri suplimentare: Nu

ApiResponse_UploadData_

ApiResponse_UploadData_ · Câmpurile, tipurile și restricțiile datelor acceptate sau returnate de API. Trimite fișierele ca multipart/form-data după crearea upload_id, apoi asociază-le produsului. Descărcarea necesită un token Bearer și permisiunea pentru category; răspunsul conține octeții fișierului, fără adresă publică sau parolă. Pentru mode=period alege days (1–3650) sau vechiul months, niciodată ambele. Condițiile se păstrează la cumpărare; rambursarea retrage accesul doar pentru poziția rambursată.

dataUploadData Obligatoriu: Datele unui răspuns reușit.

Exemplu: {"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 Obligatoriu: Metadatele răspunsului.

Exemplu: {"request_id":"example"}

Câmpuri suplimentare: Nu

ApiResponse[AudienceData]

ApiResponse_AudienceData_ · Citește regula de acces și versiunea produsului. Prima publicare rămâne reperul temporal.

dataAudienceData Obligatoriu: Datele unui răspuns reușit.

Exemplu: {"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 Obligatoriu: Metadatele răspunsului.

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

Câmpuri suplimentare: Nu

Listează — Produse — Răspuns

ApiResponse_list_ProductSummaryData__ · Câmpurile, tipurile și restricțiile datelor acceptate sau returnate de API.

dataTablou <ProductSummaryData > Obligatoriu: Exemplu de răspuns · ApiResponse_list_ProductSummaryData__.

Exemplu: [{"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 Obligatoriu: Metadatele răspunsului.

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

Câmpuri suplimentare: Nu

Obține — Produse — Răspuns

ApiResponse_ProductDetailData_ · Câmpurile, tipurile și restricțiile datelor acceptate sau returnate de API.

dataProductDetailData Obligatoriu: Exemplu de răspuns · ProductDetailData.

Exemplu: {"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 Obligatoriu: Metadatele răspunsului.

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

Câmpuri suplimentare: Nu

AudienceChange

AudienceChange · Alege achizițiile eligibile. Comenzile selectate trebuie să conțină acest produs plătit și nerambursat.

audienceAudienceSelection Obligatoriu: Regulă explicită de acces la fișierul comun.

Exemplu: {"mode":"all_purchasers"}
expected_versionNumăr întregObligatoriu: Versiunea citită înainte de scriere; o neconcordanță respinge actualizarea.

minimum: 1maximum: 9223372036854775807

Exemplu: 1

Câmpuri suplimentare: Nu

AudienceData

AudienceData · Citește regula de acces și versiunea produsului. Prima publicare rămâne reperul temporal.

anchor_atȘir de caractereObligatoriu: Prima publicare; modificarea regulii nu schimbă data.

format: "date-time"

Exemplu: "2026-11-03T12:00:00Z"
effective_atȘir de caractereObligatoriu: Momentul publicării acestei reguli de acces.

format: "date-time"

Exemplu: "2026-11-03T12:00:00Z"
file_idȘir de caractereObligatoriu: Identificatorul resursei; păstrați-l în forma returnată. · file_id

Exemplu: "00000000-0000-4000-8000-000000000007"
file_version_idȘir de caractereObligatoriu: ID-ul unei versiuni de fișier imuabile.

Exemplu: "00000000-0000-4000-8000-000000000010"
historical_access_preservedValoare booleanăOpțional: Drepturile acordate anterior rămân când regula se restrânge.

Valoare implicită: trueExemplu: true
idȘir de caractereObligatoriu: Identificatorul resursei; păstrați-l în forma returnată.

Exemplu: "00000000-0000-4000-8000-000000000009"
lookback_daysNumăr întreg nullObligatoriu: 1–3650 de zile înainte de prima publicare; doar recent_and_new.

Exemplu: null
modeȘir de caractereObligatoriu: Regulă explicită de acces la fișierul comun. new_purchases / recent_and_new / selected / all_purchasers.

Exemplu: "all_purchasers"
next_cursorȘir de caractere nullObligatoriu: Valoare de continuare pentru pagina următoare sau null.

Exemplu: null
order_idsTablou <Șir de caractere> Obligatoriu: Comenzi cu acest produs plătit și fără rambursare pentru el.

Exemplu: []
product_versionNumăr întregObligatoriu: Versiunea curentă a produsului, pentru controlul concurenței.

Exemplu: 3
revisionNumăr întregObligatoriu: Revizie succesivă a regulii de acces.

Exemplu: 1

Câmpuri suplimentare: Nu

AudienceSelection

AudienceSelection · Alege achizițiile eligibile. Comenzile selectate trebuie să conțină acest produs plătit și nerambursat.

lookback_daysNumăr întreg nullOpțional

1–3650 de zile înainte de prima publicare; doar recent_and_new.

Număr întreg:minimum: 1maximum: 3650

modeȘir de caractereObligatoriu

Regulă explicită de acces la fișierul comun. new_purchases / recent_and_new / selected / all_purchasers.

Restricții

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

Exemplu: "new_purchases"

order_idsTablou <Șir de caractere> Opțional

Comenzi cu acest produs plătit și fără rambursare pentru el.

maxItems: 1000

Restricții · Tablou 1

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

Valoare implicită: []

Câmpuri suplimentare: Nu

Informații despre disponibilitate în contextul selectat

AvailabilityData · Schemă · Scheme de date: Produse

available_fromȘir de caractere nullObligatoriu: Începutul disponibilității.

Șir de caractere:format: "date-time"

Exemplu: null
available_untilȘir de caractere nullObligatoriu: Sfârșitul disponibilității.

Șir de caractere:format: "date-time"

Exemplu: null
is_availableValoare booleanăObligatoriu: Indică dacă articolul este disponibil în acest context.

Exemplu: true

Câmpuri suplimentare: Nu

FileAssign

FileAssign · Câmpurile, tipurile și restricțiile datelor acceptate sau returnate de API. Trimite fișierele ca multipart/form-data după crearea upload_id, apoi asociază-le produsului. Descărcarea necesită un token Bearer și permisiunea pentru category; răspunsul conține octeții fișierului, fără adresă publică sau parolă. Pentru mode=period alege days (1–3650) sau vechiul months, niciodată ambele. Condițiile se păstrează la cumpărare; rambursarea retrage accesul doar pentru poziția rambursată.

audienceAudienceSelection nullOpțional: Regulă explicită de acces la fișierul comun.

Exemplu: {"mode":"new_purchases"}
expected_versionNumăr întregObligatoriu: Versiunea citită înainte de scriere; o neconcordanță respinge actualizarea.

minimum: 1maximum: 9223372036854775807

Exemplu: 1
labelȘir de caractereOpțional: Numele resursei în contextul relevant.

maxLength: 300

Valoare implicită: ""
upload_idȘir de caractereObligatoriu: Identificatorul resursei; păstrați-l în forma returnată. · upload_id

format: "uuid"

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

Câmpuri suplimentare: Nu

FileCategory

FileCategory · Câmpurile, tipurile și restricțiile datelor acceptate sau returnate de API. Trimite fișierele ca multipart/form-data după crearea upload_id, apoi asociază-le produsului. Descărcarea necesită un token Bearer și permisiunea pentru category; răspunsul conține octeții fișierului, fără adresă publică sau parolă. Pentru mode=period alege days (1–3650) sau vechiul months, niciodată ambele. Condițiile se păstrează la cumpărare; rambursarea retrage accesul doar pentru poziția rambursată.

Șir de caractere

Restricții

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

Câmpuri suplimentare: Da

Informații despre preț în contextul selectat

PriceData · Schemă · Scheme de date: Produse

amountȘir de caractereObligatoriu

Sumă zecimală codificată ca șir JSON; null numai unde este permis.

Exemplu: "0.00"

currencyȘir de caractereObligatoriu

Codul monedei în care este exprimată suma.

Restricții

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

Exemplu: "PLN"

minor_unitsNumăr întregObligatoriu

Numărul de zecimale folosite de monedă.

minimum: 0maximum: 4

Exemplu: 2

tax_includedValoare booleanăObligatoriu

Indică dacă prețul trimis include taxele.

Exemplu: true

Câmpuri suplimentare: Nu

Informații despre lista de prețuri

PriceListData · Schemă · Scheme de date: Produse

currencyȘir de caractereObligatoriu: Codul monedei în care este exprimată suma.
idȘir de caractereObligatoriu: Identificatorul resursei; păstrați-l în forma returnată. (PriceListData).
tax_includedValoare booleanăObligatoriu: Indică dacă prețul trimis include taxele.
versionNumăr întregObligatoriu: Versiunea resursei folosită pentru controlul concurenței.

Câmpuri suplimentare: Nu

Creează — Produse — Corpul cererii

ProductCreate · Câmpurile, tipurile și restricțiile datelor acceptate sau returnate de API.

brand_idȘir de caractere nullOpțional

Identificatorul mărcii.

Șir de caractere:minLength: 1maxLength: 63

conditionȘir de caractereOpțional

Starea produsului.

Restricții

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

Valoare implicită: "new"

descriptionȘir de caractere nullOpțional

Descriere în limba selectată.

Șir de caractere:maxLength: 100000

feature_value_idsTablou <Șir de caractere> Opțional

Identificatorii valorilor selectate ale caracteristicilor.

maxItems: 1000

Tablou:minLength: 1maxLength: 63

identifiersProductIdentifiers nullOpțional

Codurile de identificare ale produsului.

market_idsTablou <Șir de caractere> Opțional

Identificatorii piețelor selectate.

maxItems: 1000

Tablou:minLength: 1maxLength: 63

media_idsTablou <Șir de caractere> Opțional

Identificatorii fișierelor media deja existente.

maxItems: 30

Tablou:minLength: 1maxLength: 63

meta_descriptionȘir de caractere nullOpțional

Descriere pentru motoarele de căutare, în limba selectată.

Șir de caractere:maxLength: 160

meta_keywordsTablou <Șir de caractere> nullOpțional

Cuvinte-cheie pentru motoarele de căutare, în limba selectată.

Tablou:maxItems: 20

Tablou / Tablou:maxLength: 50

meta_titleȘir de caractere nullOpțional

Titlu pentru motoarele de căutare, în limba selectată.

Șir de caractere:maxLength: 70

nameȘir de caractereObligatoriu

Numele resursei în contextul relevant.

minLength: 1maxLength: 300

Exemplu: "Example"

pricingProductPrice Opțional

Configurația prețurilor și versiunile pentru controlul concurenței.

primary_category_idȘir de caractere nullOpțional

Identificatorul categoriei principale.

Șir de caractere:minLength: 1maxLength: 63

publishedValoare booleanăOpțional

Indică dacă resursa este publicată.

Valoare implicită: false

skuȘir de caractereObligatoriu

Codul unității de stoc.

minLength: 1maxLength: 100

Restricții

pattern: "^\\S+$"

Exemplu: "example"

slugȘir de caractere nullOpțional

Segmentul căii URL în limba selectată.

Șir de caractere:maxLength: 160

tax_category_idȘir de caractere nullOpțional

Identificatorul categoriei fiscale.

Șir de caractere:minLength: 1maxLength: 63

variant_value_idsTablou <Șir de caractere> Opțional

Identificatorii valorilor selectate ale variantelor.

maxItems: 250

Tablou:minLength: 1maxLength: 63

variants_enabledValoare booleanăOpțional

Indică dacă produsul folosește variante.

Valoare implicită: false

Câmpuri suplimentare: Nu

Obține — Produse — Răspuns

ProductDetailData · Câmpurile, tipurile și restricțiile datelor acceptate sau returnate de API.

availabilityAvailabilityData Obligatoriu

Informații despre disponibilitate în contextul selectat.

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

brand_idȘir de caractere nullObligatoriu

Identificatorul mărcii.

Exemplu: null

conditionȘir de caractereObligatoriu

Starea produsului.

Restricții

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

Exemplu: "new"

created_atȘir de caractereObligatoriu

Momentul creării.

format: "date-time"

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

descriptionȘir de caractere nullObligatoriu

Descriere în limba selectată.

Exemplu: "example"

featuresTablou <FeatureSelectionData > Obligatoriu

Caracteristicile produsului.

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

idȘir de caractereObligatoriu

Identificatorul resursei; păstrați-l în forma returnată. (ProductDetailData).

Exemplu: "example"

identifiersObiectCâmpuri suplimentare: Șir de caractereObligatoriu

Codurile de identificare ale produsului.

Exemplu: {}

mediaTablou <ProductMediaData > Obligatoriu

Informații despre fișierele media atașate.

Exemplu:

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

meta_descriptionȘir de caractere nullObligatoriu

Descriere pentru motoarele de căutare, în limba selectată.

Exemplu: "example"

meta_keywordsTablou <Șir de caractere> nullObligatoriu

Cuvinte-cheie pentru motoarele de căutare, în limba selectată.

Exemplu: ["example"]

meta_titleȘir de caractere nullObligatoriu

Titlu pentru motoarele de căutare, în limba selectată.

Exemplu: "example"

nameȘir de caractere nullObligatoriu

Numele resursei în contextul relevant.

Exemplu: "Example"

numberȘir de caractereObligatoriu

Numărul comenzii sau al solicitării, destinat utilizatorilor.

Exemplu: "example"

pricePriceData nullObligatoriu

Informații despre preț în contextul selectat.

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

price_versionNumăr întregObligatoriu

Versiunea curentă a prețului, pentru controlul concurenței.

Exemplu: 1

primary_category_idȘir de caractere nullObligatoriu

Identificatorul categoriei principale.

Exemplu: "example"

primary_media_idȘir de caractere nullObligatoriu

Identificatorul fișierului media principal.

Exemplu: "example"

publishedValoare booleanăObligatoriu

Indică dacă resursa este publicată.

Exemplu: false

skuȘir de caractereObligatoriu

Codul unității de stoc.

Exemplu: "example"

slugȘir de caractere nullObligatoriu

Segmentul căii URL în limba selectată.

Exemplu: "example"

tax_category_idȘir de caractereObligatoriu

Identificatorul categoriei fiscale.

Exemplu: "example"

updated_atȘir de caractereObligatoriu

Momentul celei mai recente actualizări.

format: "date-time"

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

variants_enabledValoare booleanăObligatoriu

Indică dacă produsul folosește variante.

Exemplu: false

versionNumăr întregObligatoriu

Versiunea resursei folosită pentru controlul concurenței.

Exemplu: 1

Câmpuri suplimentare: Nu

ProductFileData

ProductFileData · Câmpurile, tipurile și restricțiile datelor acceptate sau returnate de API. Trimite fișierele ca multipart/form-data după crearea upload_id, apoi asociază-le produsului. Descărcarea necesită un token Bearer și permisiunea pentru category; răspunsul conține octeții fișierului, fără adresă publică sau parolă. Pentru mode=period alege days (1–3650) sau vechiul months, niciodată ambele. Condițiile se păstrează la cumpărare; rambursarea retrage accesul doar pentru poziția rambursată.

categoryFileCategory Obligatoriu: Categoria fișierului: internal / customer_document / digital

Exemplu: "digital"
created_atȘir de caractereObligatoriu: Momentul creării.

format: "date-time"

Exemplu: "2026-01-01T12:00:00Z"
current_version_idȘir de caractereObligatoriu: Identificatorul resursei; păstrați-l în forma returnată. · current_version_id

format: "uuid"

Exemplu: "00000000-0000-4000-8000-000000000001"
file_idȘir de caractereObligatoriu: Identificatorul resursei; păstrați-l în forma returnată. · file_id

format: "uuid"

Exemplu: "00000000-0000-4000-8000-000000000001"
filenameȘir de caractereObligatoriu: Fișier

Exemplu: "manual.pdf"
idȘir de caractereObligatoriu: Identificatorul resursei; păstrați-l în forma returnată.

format: "uuid"

Exemplu: "00000000-0000-4000-8000-000000000001"
labelȘir de caractereObligatoriu: Numele resursei în contextul relevant.

Exemplu: "Manual"
mime_typeȘir de caractereObligatoriu: Tipul conținutului media.

Exemplu: "application/pdf"
sha256Șir de caractereObligatoriu: SHA-256 (hex, 64)

Exemplu: "5cd2f1cb0e5532b397e7ab1887baf6000c49450fd80ae279eb047c06e4545ecd"
size_bytesNumăr întregObligatoriu: Dimensiune în octeți

Exemplu: 46
stateȘir de caractereObligatoriu: Stare

Exemplu: "active"
version_numberNumăr întregObligatoriu: Versiune

Exemplu: 1

Câmpuri suplimentare: Nu

ProductFileListData

ProductFileListData · Câmpurile, tipurile și restricțiile datelor acceptate sau returnate de API. Trimite fișierele ca multipart/form-data după crearea upload_id, apoi asociază-le produsului. Descărcarea necesită un token Bearer și permisiunea pentru category; răspunsul conține octeții fișierului, fără adresă publică sau parolă. Pentru mode=period alege days (1–3650) sau vechiul months, niciodată ambele. Condițiile se păstrează la cumpărare; rambursarea retrage accesul doar pentru poziția rambursată.

filesTablou <ProductFileData > Obligatoriu: Fișierele produsului

Exemplu: [{"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_versionNumăr întregObligatoriu: Versiunea curentă a produsului, pentru controlul concurenței.

Exemplu: 2

Câmpuri suplimentare: Nu

Codurile de identificare ale produsului

ProductIdentifiers · Schemă · Scheme de date: Produse

eanȘir de caractere nullOpțional: Identificatorul EAN al produsului.

Șir de caractere:minLength: 1maxLength: 100
isbnȘir de caractere nullOpțional: Identificatorul ISBN.

Șir de caractere:minLength: 1maxLength: 100
mpnȘir de caractere nullOpțional: Codul de produs al producătorului.

Șir de caractere:minLength: 1maxLength: 100
upcȘir de caractere nullOpțional: Identificatorul UPC al produsului.

Șir de caractere:minLength: 1maxLength: 100

Câmpuri suplimentare: Nu

Informații despre fișierele media atașate

ProductMediaData · Schemă · Scheme de date: Produse

alt_textȘir de caractere nullObligatoriu

Text alternativ pentru o imagine.

Exemplu: "example"

idȘir de caractereObligatoriu

Identificatorul resursei; păstrați-l în forma returnată. (ProductMediaData).

Exemplu: "example"

is_primaryValoare booleanăObligatoriu

Indică dacă acesta este elementul principal.

Exemplu: true

kindȘir de caractereObligatoriu

Varianta structurii de date, descrisă prin valorile permise.

Restricții

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

Exemplu: "image"

mime_typeȘir de caractereObligatoriu

Tipul conținutului media.

Exemplu: "image/jpeg"

positionNumăr întregObligatoriu

Poziția în colecția ordonată.

Exemplu: 1

urlȘir de caractere nullObligatoriu

URL-ul resursei.

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

Câmpuri suplimentare: Nu

Configurația prețurilor și versiunile pentru controlul concurenței

ProductPrice · Schemă · Scheme de date: Produse

amountȘir de caractere nullObligatoriu

Sumă zecimală codificată ca șir JSON; null numai unde este permis.

Șir de caractere:maxLength: 19

Restricții · Șir de caractere 1

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

Exemplu: "0.00"

currencyȘir de caractereObligatoriu

Codul monedei în care este exprimată suma.

Restricții

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

Exemplu: "PLN"

expected_price_list_versionNumăr întregObligatoriu

Versiunea listei de prețuri citită anterior, necesară pentru această scriere.

minimum: 1maximum: 9223372036854775807

Exemplu: 1

expected_versionNumăr întregObligatoriu

Versiunea citită înainte de scriere; o neconcordanță respinge actualizarea.

minimum: 0maximum: 9223372036854775807

Exemplu: 0

kindȘir de caractereObligatoriu

Varianta structurii de date, descrisă prin valorile permise.

Restricții

enum: ["base", "market_fixed"]

Exemplu: "base"

price_list_idȘir de caractereObligatoriu

Identificatorul listei de prețuri.

minLength: 1maxLength: 63

Exemplu: "example"

tax_includedValoare booleanăObligatoriu

Indică dacă prețul trimis include taxele.

Exemplu: true

Câmpuri suplimentare: Nu

Listează — Produse — Răspuns

ProductSummaryData · Câmpurile, tipurile și restricțiile datelor acceptate sau returnate de API.

availabilityAvailabilityData Obligatoriu

Informații despre disponibilitate în contextul selectat.

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

brand_idȘir de caractere nullObligatoriu

Identificatorul mărcii.

Exemplu: null

conditionȘir de caractereObligatoriu

Starea produsului.

Restricții

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

Exemplu: "new"

created_atȘir de caractereObligatoriu

Momentul creării.

format: "date-time"

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

idȘir de caractereObligatoriu

Identificatorul resursei; păstrați-l în forma returnată. (ProductSummaryData).

Exemplu: "example"

nameȘir de caractere nullObligatoriu

Numele resursei în contextul relevant.

Exemplu: "Example"

numberȘir de caractereObligatoriu

Numărul comenzii sau al solicitării, destinat utilizatorilor.

Exemplu: "example"

pricePriceData nullObligatoriu

Informații despre preț în contextul selectat.

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

price_versionNumăr întregObligatoriu

Versiunea curentă a prețului, pentru controlul concurenței.

Exemplu: 1

primary_category_idȘir de caractere nullObligatoriu

Identificatorul categoriei principale.

Exemplu: "example"

primary_media_idȘir de caractere nullObligatoriu

Identificatorul fișierului media principal.

Exemplu: "example"

publishedValoare booleanăObligatoriu

Indică dacă resursa este publicată.

Exemplu: false

skuȘir de caractereObligatoriu

Codul unității de stoc.

Exemplu: "example"

slugȘir de caractere nullObligatoriu

Segmentul căii URL în limba selectată.

Exemplu: "example"

tax_category_idȘir de caractereObligatoriu

Identificatorul categoriei fiscale.

Exemplu: "example"

updated_atȘir de caractereObligatoriu

Momentul celei mai recente actualizări.

format: "date-time"

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

variants_enabledValoare booleanăObligatoriu

Indică dacă produsul folosește variante.

Exemplu: false

versionNumăr întregObligatoriu

Versiunea resursei folosită pentru controlul concurenței.

Exemplu: 1

Câmpuri suplimentare: Nu

Actualizează — Produse — Corpul cererii

ProductUpdate · Câmpurile, tipurile și restricțiile datelor acceptate sau returnate de API.

brand_idȘir de caractere nullOpțional

Identificatorul mărcii.

Șir de caractere:minLength: 1maxLength: 63

conditionȘir de caractereOpțional

Starea produsului.

Restricții

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

descriptionȘir de caractere nullOpțional

Descriere în limba selectată.

Șir de caractere:maxLength: 100000

Exemplu: null

expected_variant_price_versionsObiectCâmpuri suplimentare: Număr întreg

minimum: 0maximum: 9223372036854775807

Opțional

Versiunile prețurilor citite anterior, indexate după identificatorul variantei.

maxProperties: 250

Restricții

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

expected_versionNumăr întregObligatoriu

Versiunea citită înainte de scriere; o neconcordanță respinge actualizarea.

minimum: 1maximum: 9223372036854775807

Exemplu: 1

feature_value_idsTablou <Șir de caractere> Opțional

Identificatorii valorilor selectate ale caracteristicilor.

maxItems: 1000

Tablou:minLength: 1maxLength: 63

identifiersProductIdentifiers nullOpțional

Codurile de identificare ale produsului.

market_idsTablou <Șir de caractere> Opțional

Identificatorii piețelor selectate.

maxItems: 1000

Tablou:minLength: 1maxLength: 63

media_idsTablou <Șir de caractere> Opțional

Identificatorii fișierelor media deja existente.

maxItems: 30

Tablou:minLength: 1maxLength: 63

meta_descriptionȘir de caractere nullOpțional

Descriere pentru motoarele de căutare, în limba selectată.

Șir de caractere:maxLength: 160

meta_keywordsTablou <Șir de caractere> nullOpțional

Cuvinte-cheie pentru motoarele de căutare, în limba selectată.

Tablou:maxItems: 20

Tablou / Tablou:maxLength: 50

meta_titleȘir de caractere nullOpțional

Titlu pentru motoarele de căutare, în limba selectată.

Șir de caractere:maxLength: 70

nameȘir de caractere nullOpțional

Numele resursei în contextul relevant.

Șir de caractere:maxLength: 300

pricingProductPrice Opțional

Configurația prețurilor și versiunile pentru controlul concurenței.

Exemplu:

{"amount":"0.00","currency":"PLN","expected_price_list_version":1,"expected_version":0,"kind":"base","price_list_id":"example","tax_included":true}

primary_category_idȘir de caractere nullOpțional

Identificatorul categoriei principale.

Șir de caractere:minLength: 1maxLength: 63

publishedValoare booleanăOpțional

Indică dacă resursa este publicată.

skuȘir de caractereOpțional

Codul unității de stoc.

minLength: 1maxLength: 100

Restricții

pattern: "^\\S+$"

Exemplu: "example"

slugȘir de caractere nullOpțional

Segmentul căii URL în limba selectată.

Șir de caractere:maxLength: 160

tax_category_idȘir de caractere nullOpțional

Identificatorul categoriei fiscale.

Șir de caractere:minLength: 1maxLength: 63

variant_value_idsTablou <Șir de caractere> Opțional

Identificatorii valorilor selectate ale variantelor.

maxItems: 250

Tablou:minLength: 1maxLength: 63

variants_enabledValoare booleanăOpțional

Indică dacă produsul folosește variante.

Câmpuri suplimentare: Nu

ProductVersion

ProductVersion · Această operație a fost retrasă și returnează 409 fără să schimbe date. Configurează accesul fiecărui fișier digital alegând destinatarii.

expected_versionNumăr întregObligatoriu: Versiunea citită înainte de scriere; o neconcordanță respinge actualizarea.

minimum: 1maximum: 9223372036854775807

Exemplu: 1

Câmpuri suplimentare: Nu

ReleaseData

ReleaseData · Câmpurile, tipurile și restricțiile datelor acceptate sau returnate de API. Trimite fișierele ca multipart/form-data după crearea upload_id, apoi asociază-le produsului. Descărcarea necesită un token Bearer și permisiunea pentru category; răspunsul conține octeții fișierului, fără adresă publică sau parolă. Pentru mode=period alege days (1–3650) sau vechiul months, niciodată ambele. Condițiile se păstrează la cumpărare; rambursarea retrage accesul doar pentru poziția rambursată.

changelogȘir de caractereObligatoriu: Descrierea modificărilor

Exemplu: "Manual update"
filesTablou <ReleaseFileData > Obligatoriu: Fișierele produsului

Exemplu: [{"file_id":"00000000-0000-4000-8000-000000000001","sort_order":0,"version_id":"00000000-0000-4000-8000-000000000001"}]
idȘir de caractereObligatoriu: Identificatorul resursei; păstrați-l în forma returnată.

format: "uuid"

Exemplu: "00000000-0000-4000-8000-000000000001"
manifest_sha256Șir de caractere nullObligatoriu: Ediții digitale · SHA-256

Exemplu: "1111111111111111111111111111111111111111111111111111111111111111"
published_atȘir de caractere nullObligatoriu: Publică ediția · UTC

Șir de caractere:format: "date-time"

Exemplu: null
release_sequenceNumăr întreg nullObligatoriu: Ediții digitale · Poziția în colecția ordonată.

Exemplu: null
stateȘir de caractereObligatoriu: Stare

Exemplu: "active"
version_labelȘir de caractereObligatoriu: Versiune

Exemplu: "1.0"
withdrawn_atȘir de caractere nullObligatoriu: Retrage oferta · UTC

Șir de caractere:format: "date-time"

Exemplu: null

Câmpuri suplimentare: Nu

ReleaseDraft

ReleaseDraft · Această operație a fost retrasă și returnează 409 fără să schimbe date. Configurează accesul fiecărui fișier digital alegând destinatarii.

changelogȘir de caractereOpțional: Descrierea modificărilor

maxLength: 20000

Valoare implicită: ""
expected_versionNumăr întregObligatoriu: Versiunea citită înainte de scriere; o neconcordanță respinge actualizarea.

minimum: 1maximum: 9223372036854775807

Exemplu: 1
version_idsTablou <Șir de caractere> Obligatoriu: Versiune · UUID[]

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

Exemplu: ["00000000-0000-4000-8000-000000000001"]
version_labelȘir de caractereObligatoriu: Versiune

minLength: 1maxLength: 64

Exemplu: "1.0"

Câmpuri suplimentare: Nu

ReleaseFileData

ReleaseFileData · Câmpurile, tipurile și restricțiile datelor acceptate sau returnate de API. Trimite fișierele ca multipart/form-data după crearea upload_id, apoi asociază-le produsului. Descărcarea necesită un token Bearer și permisiunea pentru category; răspunsul conține octeții fișierului, fără adresă publică sau parolă. Pentru mode=period alege days (1–3650) sau vechiul months, niciodată ambele. Condițiile se păstrează la cumpărare; rambursarea retrage accesul doar pentru poziția rambursată.

file_idȘir de caractereObligatoriu: Identificatorul resursei; păstrați-l în forma returnată. · file_id

format: "uuid"

Exemplu: "00000000-0000-4000-8000-000000000001"
sort_orderNumăr întregObligatoriu: Poziția în colecția ordonată.

Exemplu: 0
version_idȘir de caractereObligatoriu: Identificatorul resursei; păstrați-l în forma returnată. · version_id

format: "uuid"

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

Câmpuri suplimentare: Nu

ReleaseListData

ReleaseListData · Câmpurile, tipurile și restricțiile datelor acceptate sau returnate de API. Trimite fișierele ca multipart/form-data după crearea upload_id, apoi asociază-le produsului. Descărcarea necesită un token Bearer și permisiunea pentru category; răspunsul conține octeții fișierului, fără adresă publică sau parolă. Pentru mode=period alege days (1–3650) sau vechiul months, niciodată ambele. Condițiile se păstrează la cumpărare; rambursarea retrage accesul doar pentru poziția rambursată.

current_release_idȘir de caractere nullObligatoriu: Identificatorul resursei; păstrați-l în forma returnată. · current_release_id

Șir de caractere:format: "uuid"

Exemplu: "00000000-0000-4000-8000-000000000001"
product_versionNumăr întregObligatoriu: Versiunea curentă a produsului, pentru controlul concurenței.

Exemplu: 2
releasesTablou <ReleaseData > Obligatoriu: Ediții digitale

Exemplu: [{"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_daysNumăr întreg nullObligatoriu: Număr de zile (days; null)

Exemplu: 365
update_modeȘir de caractereObligatoriu: Acces la fișiere viitoare după cumpărare: none / period / unlimited

Exemplu: "period"
update_monthsNumăr întreg nullObligatoriu: Luni (months; null)

Exemplu: null

Câmpuri suplimentare: Nu

UpdatePolicy

UpdatePolicy · Această operație a fost retrasă și returnează 409 fără să schimbe date. Configurează accesul fiecărui fișier digital alegând destinatarii.

daysNumăr întreg nullOpțional

Număr de zile (1–3650; mode=period; months=null)

Număr întreg:minimum: 1maximum: 3650

Exemplu: 365

expected_versionNumăr întregObligatoriu

Versiunea citită înainte de scriere; o neconcordanță respinge actualizarea.

minimum: 1maximum: 9223372036854775807

Exemplu: 1

modeȘir de caractereObligatoriu

Acces la fișiere viitoare după cumpărare: none / period / unlimited

Restricții

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

Exemplu: "period"

monthsNumăr întreg nullOpțional

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

Număr întreg:minimum: 1maximum: 120

Exemplu: null

Câmpuri suplimentare: Nu

UploadCreate

UploadCreate · Câmpurile, tipurile și restricțiile datelor acceptate sau returnate de API. Trimite fișierele ca multipart/form-data după crearea upload_id, apoi asociază-le produsului. Descărcarea necesită un token Bearer și permisiunea pentru category; răspunsul conține octeții fișierului, fără adresă publică sau parolă. Pentru mode=period alege days (1–3650) sau vechiul months, niciodată ambele. Condițiile se păstrează la cumpărare; rambursarea retrage accesul doar pentru poziția rambursată.

filenameȘir de caractereObligatoriu

Fișier

minLength: 1maxLength: 255

Exemplu: "manual.pdf"

product_idȘir de caractere nullOpțional

Identificatorul produsului.

Restricții · Șir de caractere 1

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

Exemplu: "example"

sha256Șir de caractereObligatoriu

SHA-256 (hex, 64)

Restricții

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

Exemplu: "5cd2f1cb0e5532b397e7ab1887baf6000c49450fd80ae279eb047c06e4545ecd"

size_bytesNumăr întregObligatoriu

Dimensiune în octeți

minimum: 1maximum: 262144000

Exemplu: 46

Câmpuri suplimentare: Nu

UploadData

UploadData · Câmpurile, tipurile și restricțiile datelor acceptate sau returnate de API. Trimite fișierele ca multipart/form-data după crearea upload_id, apoi asociază-le produsului. Descărcarea necesită un token Bearer și permisiunea pentru category; răspunsul conține octeții fișierului, fără adresă publică sau parolă. Pentru mode=period alege days (1–3650) sau vechiul months, niciodată ambele. Condițiile se păstrează la cumpărare; rambursarea retrage accesul doar pentru poziția rambursată.

categoryFileCategory Obligatoriu: Categoria fișierului: internal / customer_document / digital

Exemplu: "digital"
expires_atȘir de caractereObligatoriu: Data și ora expirării credențialului.

format: "date-time"

Exemplu: "2026-01-01T12:00:00Z"
filenameȘir de caractereObligatoriu: Fișier

Exemplu: "manual.pdf"
idȘir de caractereObligatoriu: Identificatorul resursei; păstrați-l în forma returnată.

format: "uuid"

Exemplu: "00000000-0000-4000-8000-000000000001"
product_idȘir de caractere nullObligatoriu: Identificatorul produsului.

Exemplu: "example"
received_bytesNumăr întregObligatoriu: Se încarcă… · Dimensiune în octeți

Exemplu: 46
sha256Șir de caractereObligatoriu: SHA-256 (hex, 64)

Exemplu: "5cd2f1cb0e5532b397e7ab1887baf6000c49450fd80ae279eb047c06e4545ecd"
size_bytesNumăr întregObligatoriu: Dimensiune în octeți

Exemplu: 46
statusȘir de caractereObligatoriu: Starea acceptată de această operație specifică.

Exemplu: "ready"

Câmpuri suplimentare: Nu