Duomenų schemos: Produktai

Duomenų schemos: Produktai. API priimamų arba grąžinamų duomenų laukai, tipai ir apribojimai.

Duomenų schemos

ApiResponse_ProductFileListData_

ApiResponse_ProductFileListData_ · API priimamų arba grąžinamų duomenų laukai, tipai ir apribojimai. Sukūrę upload_id siųskite failus kaip multipart/form-data ir susiekite juos su produktu. Atsisiuntimui reikia Bearer žetono ir category leidimo; atsakyme pateikiami failo baitai be viešo adreso ar slaptažodžio. Kai mode=period, rinkitės days (1–3650) arba ankstesnį months, bet ne abu. Sąlygos išsaugomos perkant; grąžinus pinigus panaikinama prieiga tik prie grąžintos eilutės.

dataProductFileListData Privalomas: Sėkmingo atsakymo duomenys.

Pavyzdys: {"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 Privalomas: Atsakymo metaduomenys.

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

Papildomi laukai: Ne

ApiResponse_ReleaseListData_

ApiResponse_ReleaseListData_ · API priimamų arba grąžinamų duomenų laukai, tipai ir apribojimai. Sukūrę upload_id siųskite failus kaip multipart/form-data ir susiekite juos su produktu. Atsisiuntimui reikia Bearer žetono ir category leidimo; atsakyme pateikiami failo baitai be viešo adreso ar slaptažodžio. Kai mode=period, rinkitės days (1–3650) arba ankstesnį months, bet ne abu. Sąlygos išsaugomos perkant; grąžinus pinigus panaikinama prieiga tik prie grąžintos eilutės.

dataReleaseListData Privalomas: Sėkmingo atsakymo duomenys.

Pavyzdys: {"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 Privalomas: Atsakymo metaduomenys.

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

Papildomi laukai: Ne

ApiResponse_UploadData_

ApiResponse_UploadData_ · API priimamų arba grąžinamų duomenų laukai, tipai ir apribojimai. Sukūrę upload_id siųskite failus kaip multipart/form-data ir susiekite juos su produktu. Atsisiuntimui reikia Bearer žetono ir category leidimo; atsakyme pateikiami failo baitai be viešo adreso ar slaptažodžio. Kai mode=period, rinkitės days (1–3650) arba ankstesnį months, bet ne abu. Sąlygos išsaugomos perkant; grąžinus pinigus panaikinama prieiga tik prie grąžintos eilutės.

dataUploadData Privalomas: Sėkmingo atsakymo duomenys.

Pavyzdys: {"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 Privalomas: Atsakymo metaduomenys.

Pavyzdys: {"request_id":"example"}

Papildomi laukai: Ne

ApiResponse[AudienceData]

ApiResponse_AudienceData_ · Skaitykite prieigos taisyklę ir produkto versiją. Pirmasis paskelbimas lieka laiko atskaitos taškas.

dataAudienceData Privalomas: Sėkmingo atsakymo duomenys.

Pavyzdys: {"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 Privalomas: Atsakymo metaduomenys.

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

Papildomi laukai: Ne

Sąrašas — Produktai — Atsakymas

ApiResponse_list_ProductSummaryData__ · API priimamų arba grąžinamų duomenų laukai, tipai ir apribojimai.

dataMasyvas <ProductSummaryData > Privalomas: Atsakymo pavyzdys · ApiResponse_list_ProductSummaryData__.

Pavyzdys: [{"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 Privalomas: Atsakymo metaduomenys.

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

Papildomi laukai: Ne

Gauti — Produktai — Atsakymas

ApiResponse_ProductDetailData_ · API priimamų arba grąžinamų duomenų laukai, tipai ir apribojimai.

dataProductDetailData Privalomas: Atsakymo pavyzdys · ProductDetailData.

Pavyzdys: {"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 Privalomas: Atsakymo metaduomenys.

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

Papildomi laukai: Ne

AudienceChange

AudienceChange · Pasirinkite tinkamus pirkimus. Atrinktuose užsakymuose šis produktas turi būti apmokėtas ir negrąžintas.

audienceAudienceSelection Privalomas: Aiški bendro failo prieigos taisyklė.

Pavyzdys: {"mode":"all_purchasers"}
expected_versionSveikasis skaičiusPrivalomas: Prieš įrašant perskaityta versija; neatitikimas atmeta pakeitimą.

minimum: 1maximum: 9223372036854775807

Pavyzdys: 1

Papildomi laukai: Ne

AudienceData

AudienceData · Skaitykite prieigos taisyklę ir produkto versiją. Pirmasis paskelbimas lieka laiko atskaitos taškas.

anchor_atEilutėPrivalomas: Pirmasis paskelbimas; taisyklės keitimas datos nekeičia.

format: "date-time"

Pavyzdys: "2026-11-03T12:00:00Z"
effective_atEilutėPrivalomas: Šios prieigos taisyklės paskelbimo laikas.

format: "date-time"

Pavyzdys: "2026-11-03T12:00:00Z"
file_idEilutėPrivalomas: Ištekliaus identifikatorius; išsaugokite grąžintą išraišką. · file_id

Pavyzdys: "00000000-0000-4000-8000-000000000007"
file_version_idEilutėPrivalomas: Nekintamos failo versijos ID.

Pavyzdys: "00000000-0000-4000-8000-000000000010"
historical_access_preservedLoginė reikšmėNeprivalomas: Anksčiau suteiktos teisės išlieka susiaurinus taisyklę.

Numatytoji reikšmė: truePavyzdys: true
idEilutėPrivalomas: Ištekliaus identifikatorius; išsaugokite grąžintą išraišką.

Pavyzdys: "00000000-0000-4000-8000-000000000009"
lookback_daysSveikasis skaičius nullPrivalomas: 1–3650 dienų iki pirmojo paskelbimo; tik recent_and_new.

Pavyzdys: null
modeEilutėPrivalomas: Aiški bendro failo prieigos taisyklė. new_purchases / recent_and_new / selected / all_purchasers.

Pavyzdys: "all_purchasers"
next_cursorEilutė nullPrivalomas: Kito puslapio tęsimo reikšmė arba null.

Pavyzdys: null
order_idsMasyvas <Eilutė> Privalomas: Užsakymai su šiuo apmokėtu produktu, už kurį pinigai negrąžinti.

Pavyzdys: []
product_versionSveikasis skaičiusPrivalomas: Dabartinė produkto versija lygiagrečių pakeitimų kontrolei.

Pavyzdys: 3
revisionSveikasis skaičiusPrivalomas: Nuosekli prieigos taisyklės redakcija.

Pavyzdys: 1

Papildomi laukai: Ne

AudienceSelection

AudienceSelection · Pasirinkite tinkamus pirkimus. Atrinktuose užsakymuose šis produktas turi būti apmokėtas ir negrąžintas.

lookback_daysSveikasis skaičius nullNeprivalomas

1–3650 dienų iki pirmojo paskelbimo; tik recent_and_new.

Sveikasis skaičius:minimum: 1maximum: 3650

modeEilutėPrivalomas

Aiški bendro failo prieigos taisyklė. new_purchases / recent_and_new / selected / all_purchasers.

Apribojimai

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

Pavyzdys: "new_purchases"

order_idsMasyvas <Eilutė> Neprivalomas

Užsakymai su šiuo apmokėtu produktu, už kurį pinigai negrąžinti.

maxItems: 1000

Apribojimai · Masyvas 1

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

Numatytoji reikšmė: []

Papildomi laukai: Ne

Prieinamumo informacija pasirinktame kontekste

AvailabilityData · Schema · Duomenų schemos: Produktai

available_fromEilutė nullPrivalomas: Prieinamumo pradžia.

Eilutė:format: "date-time"

Pavyzdys: null
available_untilEilutė nullPrivalomas: Prieinamumo pabaiga.

Eilutė:format: "date-time"

Pavyzdys: null
is_availableLoginė reikšmėPrivalomas: Ar elementas prieinamas šiame kontekste.

Pavyzdys: true

Papildomi laukai: Ne

FileAssign

FileAssign · API priimamų arba grąžinamų duomenų laukai, tipai ir apribojimai. Sukūrę upload_id siųskite failus kaip multipart/form-data ir susiekite juos su produktu. Atsisiuntimui reikia Bearer žetono ir category leidimo; atsakyme pateikiami failo baitai be viešo adreso ar slaptažodžio. Kai mode=period, rinkitės days (1–3650) arba ankstesnį months, bet ne abu. Sąlygos išsaugomos perkant; grąžinus pinigus panaikinama prieiga tik prie grąžintos eilutės.

audienceAudienceSelection nullNeprivalomas: Aiški bendro failo prieigos taisyklė.

Pavyzdys: {"mode":"new_purchases"}
expected_versionSveikasis skaičiusPrivalomas: Prieš įrašant perskaityta versija; neatitikimas atmeta pakeitimą.

minimum: 1maximum: 9223372036854775807

Pavyzdys: 1
labelEilutėNeprivalomas: Ištekliaus pavadinimas atitinkamame kontekste.

maxLength: 300

Numatytoji reikšmė: ""
upload_idEilutėPrivalomas: Ištekliaus identifikatorius; išsaugokite grąžintą išraišką. · upload_id

format: "uuid"

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

Papildomi laukai: Ne

FileCategory

FileCategory · API priimamų arba grąžinamų duomenų laukai, tipai ir apribojimai. Sukūrę upload_id siųskite failus kaip multipart/form-data ir susiekite juos su produktu. Atsisiuntimui reikia Bearer žetono ir category leidimo; atsakyme pateikiami failo baitai be viešo adreso ar slaptažodžio. Kai mode=period, rinkitės days (1–3650) arba ankstesnį months, bet ne abu. Sąlygos išsaugomos perkant; grąžinus pinigus panaikinama prieiga tik prie grąžintos eilutės.

Eilutė

Apribojimai

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

Papildomi laukai: Taip

Kainos informacija pasirinktame kontekste

PriceData · Schema · Duomenų schemos: Produktai

amountEilutėPrivalomas

Dešimtainė suma, užkoduota JSON eilute; null tik ten, kur leidžiama.

Pavyzdys: "0.00"

currencyEilutėPrivalomas

Sumos valiutos kodas.

Apribojimai

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

Pavyzdys: "PLN"

minor_unitsSveikasis skaičiusPrivalomas

Valiutos naudojamų skaitmenų po kablelio skaičius.

minimum: 0maximum: 4

Pavyzdys: 2

tax_includedLoginė reikšmėPrivalomas

Ar pateikta kaina apima mokesčius.

Pavyzdys: true

Papildomi laukai: Ne

Kainoraščio informacija

PriceListData · Schema · Duomenų schemos: Produktai

currencyEilutėPrivalomas: Sumos valiutos kodas.
idEilutėPrivalomas: Ištekliaus identifikatorius; išsaugokite grąžintą išraišką. (PriceListData).
tax_includedLoginė reikšmėPrivalomas: Ar pateikta kaina apima mokesčius.
versionSveikasis skaičiusPrivalomas: Ištekliaus versija lygiagrečių pakeitimų kontrolei.

Papildomi laukai: Ne

Sukurti — Produktai — Užklausos turinys

ProductCreate · API priimamų arba grąžinamų duomenų laukai, tipai ir apribojimai.

brand_idEilutė nullNeprivalomas

Prekės ženklo identifikatorius.

Eilutė:minLength: 1maxLength: 63

conditionEilutėNeprivalomas

Produkto būklė.

Apribojimai

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

Numatytoji reikšmė: "new"

descriptionEilutė nullNeprivalomas

Aprašymas pasirinkta kalba.

Eilutė:maxLength: 100000

feature_value_idsMasyvas <Eilutė> Neprivalomas

Pasirinktų savybės reikšmių identifikatoriai.

maxItems: 1000

Masyvas:minLength: 1maxLength: 63

identifiersProductIdentifiers nullNeprivalomas

Produkto identifikavimo kodai.

market_idsMasyvas <Eilutė> Neprivalomas

Pasirinktų rinkų identifikatoriai.

maxItems: 1000

Masyvas:minLength: 1maxLength: 63

media_idsMasyvas <Eilutė> Neprivalomas

Jau esamų medijos failų identifikatoriai.

maxItems: 30

Masyvas:minLength: 1maxLength: 63

meta_descriptionEilutė nullNeprivalomas

Aprašymas paieškos sistemoms pasirinkta kalba.

Eilutė:maxLength: 160

meta_keywordsMasyvas <Eilutė> nullNeprivalomas

Raktažodžiai paieškos sistemoms pasirinkta kalba.

Masyvas:maxItems: 20

Masyvas / Masyvas:maxLength: 50

meta_titleEilutė nullNeprivalomas

Antraštė paieškos sistemoms pasirinkta kalba.

Eilutė:maxLength: 70

nameEilutėPrivalomas

Ištekliaus pavadinimas atitinkamame kontekste.

minLength: 1maxLength: 300

Pavyzdys: "Example"

pricingProductPrice Neprivalomas

Kainodaros konfigūracija ir lygiagrečių pakeitimų kontrolės versijos.

primary_category_idEilutė nullNeprivalomas

Pagrindinės kategorijos identifikatorius.

Eilutė:minLength: 1maxLength: 63

publishedLoginė reikšmėNeprivalomas

Ar išteklius paskelbtas.

Numatytoji reikšmė: false

skuEilutėPrivalomas

Atsargų apskaitos vieneto kodas.

minLength: 1maxLength: 100

Apribojimai

pattern: "^\\S+$"

Pavyzdys: "example"

slugEilutė nullNeprivalomas

URL kelio segmentas pasirinkta kalba.

Eilutė:maxLength: 160

tax_category_idEilutė nullNeprivalomas

Mokesčių kategorijos identifikatorius.

Eilutė:minLength: 1maxLength: 63

variant_value_idsMasyvas <Eilutė> Neprivalomas

Pasirinktų varianto reikšmių identifikatoriai.

maxItems: 250

Masyvas:minLength: 1maxLength: 63

variants_enabledLoginė reikšmėNeprivalomas

Ar produktas naudoja variantus.

Numatytoji reikšmė: false

Papildomi laukai: Ne

Gauti — Produktai — Atsakymas

ProductDetailData · API priimamų arba grąžinamų duomenų laukai, tipai ir apribojimai.

availabilityAvailabilityData Privalomas

Prieinamumo informacija pasirinktame kontekste.

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

brand_idEilutė nullPrivalomas

Prekės ženklo identifikatorius.

Pavyzdys: null

conditionEilutėPrivalomas

Produkto būklė.

Apribojimai

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

Pavyzdys: "new"

created_atEilutėPrivalomas

Sukūrimo laikas.

format: "date-time"

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

descriptionEilutė nullPrivalomas

Aprašymas pasirinkta kalba.

Pavyzdys: "example"

featuresMasyvas <FeatureSelectionData > Privalomas

Produkto savybės.

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

idEilutėPrivalomas

Ištekliaus identifikatorius; išsaugokite grąžintą išraišką. (ProductDetailData).

Pavyzdys: "example"

identifiersObjektasPapildomi laukai: EilutėPrivalomas

Produkto identifikavimo kodai.

Pavyzdys: {}

mediaMasyvas <ProductMediaData > Privalomas

Pridėtos medijos informacija.

Pavyzdys:

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

meta_descriptionEilutė nullPrivalomas

Aprašymas paieškos sistemoms pasirinkta kalba.

Pavyzdys: "example"

meta_keywordsMasyvas <Eilutė> nullPrivalomas

Raktažodžiai paieškos sistemoms pasirinkta kalba.

Pavyzdys: ["example"]

meta_titleEilutė nullPrivalomas

Antraštė paieškos sistemoms pasirinkta kalba.

Pavyzdys: "example"

nameEilutė nullPrivalomas

Ištekliaus pavadinimas atitinkamame kontekste.

Pavyzdys: "Example"

numberEilutėPrivalomas

Žmogui rodomas užsakymo arba prašymo numeris.

Pavyzdys: "example"

pricePriceData nullPrivalomas

Kainos informacija pasirinktame kontekste.

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

price_versionSveikasis skaičiusPrivalomas

Dabartinė kainos versija lygiagrečių pakeitimų kontrolei.

Pavyzdys: 1

primary_category_idEilutė nullPrivalomas

Pagrindinės kategorijos identifikatorius.

Pavyzdys: "example"

primary_media_idEilutė nullPrivalomas

Pagrindinio medijos failo identifikatorius.

Pavyzdys: "example"

publishedLoginė reikšmėPrivalomas

Ar išteklius paskelbtas.

Pavyzdys: false

skuEilutėPrivalomas

Atsargų apskaitos vieneto kodas.

Pavyzdys: "example"

slugEilutė nullPrivalomas

URL kelio segmentas pasirinkta kalba.

Pavyzdys: "example"

tax_category_idEilutėPrivalomas

Mokesčių kategorijos identifikatorius.

Pavyzdys: "example"

updated_atEilutėPrivalomas

Paskutinio atnaujinimo laikas.

format: "date-time"

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

variants_enabledLoginė reikšmėPrivalomas

Ar produktas naudoja variantus.

Pavyzdys: false

versionSveikasis skaičiusPrivalomas

Ištekliaus versija lygiagrečių pakeitimų kontrolei.

Pavyzdys: 1

Papildomi laukai: Ne

ProductFileData

ProductFileData · API priimamų arba grąžinamų duomenų laukai, tipai ir apribojimai. Sukūrę upload_id siųskite failus kaip multipart/form-data ir susiekite juos su produktu. Atsisiuntimui reikia Bearer žetono ir category leidimo; atsakyme pateikiami failo baitai be viešo adreso ar slaptažodžio. Kai mode=period, rinkitės days (1–3650) arba ankstesnį months, bet ne abu. Sąlygos išsaugomos perkant; grąžinus pinigus panaikinama prieiga tik prie grąžintos eilutės.

categoryFileCategory Privalomas: Failo kategorija: internal / customer_document / digital

Pavyzdys: "digital"
created_atEilutėPrivalomas: Sukūrimo laikas.

format: "date-time"

Pavyzdys: "2026-01-01T12:00:00Z"
current_version_idEilutėPrivalomas: Ištekliaus identifikatorius; išsaugokite grąžintą išraišką. · current_version_id

format: "uuid"

Pavyzdys: "00000000-0000-4000-8000-000000000001"
file_idEilutėPrivalomas: Ištekliaus identifikatorius; išsaugokite grąžintą išraišką. · file_id

format: "uuid"

Pavyzdys: "00000000-0000-4000-8000-000000000001"
filenameEilutėPrivalomas: Failas

Pavyzdys: "manual.pdf"
idEilutėPrivalomas: Ištekliaus identifikatorius; išsaugokite grąžintą išraišką.

format: "uuid"

Pavyzdys: "00000000-0000-4000-8000-000000000001"
labelEilutėPrivalomas: Ištekliaus pavadinimas atitinkamame kontekste.

Pavyzdys: "Manual"
mime_typeEilutėPrivalomas: Medijos turinio tipas.

Pavyzdys: "application/pdf"
sha256EilutėPrivalomas: SHA-256 (hex, 64)

Pavyzdys: "5cd2f1cb0e5532b397e7ab1887baf6000c49450fd80ae279eb047c06e4545ecd"
size_bytesSveikasis skaičiusPrivalomas: Dydis baitais

Pavyzdys: 46
stateEilutėPrivalomas: Būsena

Pavyzdys: "active"
version_numberSveikasis skaičiusPrivalomas: Versija

Pavyzdys: 1

Papildomi laukai: Ne

ProductFileListData

ProductFileListData · API priimamų arba grąžinamų duomenų laukai, tipai ir apribojimai. Sukūrę upload_id siųskite failus kaip multipart/form-data ir susiekite juos su produktu. Atsisiuntimui reikia Bearer žetono ir category leidimo; atsakyme pateikiami failo baitai be viešo adreso ar slaptažodžio. Kai mode=period, rinkitės days (1–3650) arba ankstesnį months, bet ne abu. Sąlygos išsaugomos perkant; grąžinus pinigus panaikinama prieiga tik prie grąžintos eilutės.

filesMasyvas <ProductFileData > Privalomas: Produkto failai

Pavyzdys: [{"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_versionSveikasis skaičiusPrivalomas: Dabartinė produkto versija lygiagrečių pakeitimų kontrolei.

Pavyzdys: 2

Papildomi laukai: Ne

Produkto identifikavimo kodai

ProductIdentifiers · Schema · Duomenų schemos: Produktai

eanEilutė nullNeprivalomas: Produkto EAN identifikatorius.

Eilutė:minLength: 1maxLength: 100
isbnEilutė nullNeprivalomas: ISBN identifikatorius.

Eilutė:minLength: 1maxLength: 100
mpnEilutė nullNeprivalomas: Gamintojo dalies numeris.

Eilutė:minLength: 1maxLength: 100
upcEilutė nullNeprivalomas: Produkto UPC identifikatorius.

Eilutė:minLength: 1maxLength: 100

Papildomi laukai: Ne

Pridėtos medijos informacija

ProductMediaData · Schema · Duomenų schemos: Produktai

alt_textEilutė nullPrivalomas

Alternatyvus paveikslėlio tekstas.

Pavyzdys: "example"

idEilutėPrivalomas

Ištekliaus identifikatorius; išsaugokite grąžintą išraišką. (ProductMediaData).

Pavyzdys: "example"

is_primaryLoginė reikšmėPrivalomas

Ar tai pagrindinis elementas.

Pavyzdys: true

kindEilutėPrivalomas

Duomenų struktūros atmaina, apibrėžta leidžiamomis reikšmėmis.

Apribojimai

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

Pavyzdys: "image"

mime_typeEilutėPrivalomas

Medijos turinio tipas.

Pavyzdys: "image/jpeg"

positionSveikasis skaičiusPrivalomas

Pozicija surikiuotame rinkinyje.

Pavyzdys: 1

urlEilutė nullPrivalomas

Ištekliaus URL.

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

Papildomi laukai: Ne

Kainodaros konfigūracija ir lygiagrečių pakeitimų kontrolės versijos

ProductPrice · Schema · Duomenų schemos: Produktai

amountEilutė nullPrivalomas

Dešimtainė suma, užkoduota JSON eilute; null tik ten, kur leidžiama.

Eilutė:maxLength: 19

Apribojimai · Eilutė 1

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

Pavyzdys: "0.00"

currencyEilutėPrivalomas

Sumos valiutos kodas.

Apribojimai

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

Pavyzdys: "PLN"

expected_price_list_versionSveikasis skaičiusPrivalomas

Anksčiau perskaityta kainoraščio versija, būtina šiam įrašymui.

minimum: 1maximum: 9223372036854775807

Pavyzdys: 1

expected_versionSveikasis skaičiusPrivalomas

Prieš įrašant perskaityta versija; neatitikimas atmeta pakeitimą.

minimum: 0maximum: 9223372036854775807

Pavyzdys: 0

kindEilutėPrivalomas

Duomenų struktūros atmaina, apibrėžta leidžiamomis reikšmėmis.

Apribojimai

enum: ["base", "market_fixed"]

Pavyzdys: "base"

price_list_idEilutėPrivalomas

Kainoraščio identifikatorius.

minLength: 1maxLength: 63

Pavyzdys: "example"

tax_includedLoginė reikšmėPrivalomas

Ar pateikta kaina apima mokesčius.

Pavyzdys: true

Papildomi laukai: Ne

Sąrašas — Produktai — Atsakymas

ProductSummaryData · API priimamų arba grąžinamų duomenų laukai, tipai ir apribojimai.

availabilityAvailabilityData Privalomas

Prieinamumo informacija pasirinktame kontekste.

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

brand_idEilutė nullPrivalomas

Prekės ženklo identifikatorius.

Pavyzdys: null

conditionEilutėPrivalomas

Produkto būklė.

Apribojimai

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

Pavyzdys: "new"

created_atEilutėPrivalomas

Sukūrimo laikas.

format: "date-time"

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

idEilutėPrivalomas

Ištekliaus identifikatorius; išsaugokite grąžintą išraišką. (ProductSummaryData).

Pavyzdys: "example"

nameEilutė nullPrivalomas

Ištekliaus pavadinimas atitinkamame kontekste.

Pavyzdys: "Example"

numberEilutėPrivalomas

Žmogui rodomas užsakymo arba prašymo numeris.

Pavyzdys: "example"

pricePriceData nullPrivalomas

Kainos informacija pasirinktame kontekste.

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

price_versionSveikasis skaičiusPrivalomas

Dabartinė kainos versija lygiagrečių pakeitimų kontrolei.

Pavyzdys: 1

primary_category_idEilutė nullPrivalomas

Pagrindinės kategorijos identifikatorius.

Pavyzdys: "example"

primary_media_idEilutė nullPrivalomas

Pagrindinio medijos failo identifikatorius.

Pavyzdys: "example"

publishedLoginė reikšmėPrivalomas

Ar išteklius paskelbtas.

Pavyzdys: false

skuEilutėPrivalomas

Atsargų apskaitos vieneto kodas.

Pavyzdys: "example"

slugEilutė nullPrivalomas

URL kelio segmentas pasirinkta kalba.

Pavyzdys: "example"

tax_category_idEilutėPrivalomas

Mokesčių kategorijos identifikatorius.

Pavyzdys: "example"

updated_atEilutėPrivalomas

Paskutinio atnaujinimo laikas.

format: "date-time"

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

variants_enabledLoginė reikšmėPrivalomas

Ar produktas naudoja variantus.

Pavyzdys: false

versionSveikasis skaičiusPrivalomas

Ištekliaus versija lygiagrečių pakeitimų kontrolei.

Pavyzdys: 1

Papildomi laukai: Ne

Atnaujinti — Produktai — Užklausos turinys

ProductUpdate · API priimamų arba grąžinamų duomenų laukai, tipai ir apribojimai.

brand_idEilutė nullNeprivalomas

Prekės ženklo identifikatorius.

Eilutė:minLength: 1maxLength: 63

conditionEilutėNeprivalomas

Produkto būklė.

Apribojimai

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

descriptionEilutė nullNeprivalomas

Aprašymas pasirinkta kalba.

Eilutė:maxLength: 100000

Pavyzdys: null

expected_variant_price_versionsObjektasPapildomi laukai: Sveikasis skaičius

minimum: 0maximum: 9223372036854775807

Neprivalomas

Anksčiau perskaitytos kainų versijos, susietos su variantų identifikatoriais.

maxProperties: 250

Apribojimai

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

expected_versionSveikasis skaičiusPrivalomas

Prieš įrašant perskaityta versija; neatitikimas atmeta pakeitimą.

minimum: 1maximum: 9223372036854775807

Pavyzdys: 1

feature_value_idsMasyvas <Eilutė> Neprivalomas

Pasirinktų savybės reikšmių identifikatoriai.

maxItems: 1000

Masyvas:minLength: 1maxLength: 63

identifiersProductIdentifiers nullNeprivalomas

Produkto identifikavimo kodai.

market_idsMasyvas <Eilutė> Neprivalomas

Pasirinktų rinkų identifikatoriai.

maxItems: 1000

Masyvas:minLength: 1maxLength: 63

media_idsMasyvas <Eilutė> Neprivalomas

Jau esamų medijos failų identifikatoriai.

maxItems: 30

Masyvas:minLength: 1maxLength: 63

meta_descriptionEilutė nullNeprivalomas

Aprašymas paieškos sistemoms pasirinkta kalba.

Eilutė:maxLength: 160

meta_keywordsMasyvas <Eilutė> nullNeprivalomas

Raktažodžiai paieškos sistemoms pasirinkta kalba.

Masyvas:maxItems: 20

Masyvas / Masyvas:maxLength: 50

meta_titleEilutė nullNeprivalomas

Antraštė paieškos sistemoms pasirinkta kalba.

Eilutė:maxLength: 70

nameEilutė nullNeprivalomas

Ištekliaus pavadinimas atitinkamame kontekste.

Eilutė:maxLength: 300

pricingProductPrice Neprivalomas

Kainodaros konfigūracija ir lygiagrečių pakeitimų kontrolės versijos.

Pavyzdys:

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

primary_category_idEilutė nullNeprivalomas

Pagrindinės kategorijos identifikatorius.

Eilutė:minLength: 1maxLength: 63

publishedLoginė reikšmėNeprivalomas

Ar išteklius paskelbtas.

skuEilutėNeprivalomas

Atsargų apskaitos vieneto kodas.

minLength: 1maxLength: 100

Apribojimai

pattern: "^\\S+$"

Pavyzdys: "example"

slugEilutė nullNeprivalomas

URL kelio segmentas pasirinkta kalba.

Eilutė:maxLength: 160

tax_category_idEilutė nullNeprivalomas

Mokesčių kategorijos identifikatorius.

Eilutė:minLength: 1maxLength: 63

variant_value_idsMasyvas <Eilutė> Neprivalomas

Pasirinktų varianto reikšmių identifikatoriai.

maxItems: 250

Masyvas:minLength: 1maxLength: 63

variants_enabledLoginė reikšmėNeprivalomas

Ar produktas naudoja variantus.

Papildomi laukai: Ne

ProductVersion

ProductVersion · Ši operacija nebevykdoma ir grąžina 409 nekeisdama duomenų. Kiekvieno skaitmeninio failo prieigą nustatykite pasirinkdami gavėjus.

expected_versionSveikasis skaičiusPrivalomas: Prieš įrašant perskaityta versija; neatitikimas atmeta pakeitimą.

minimum: 1maximum: 9223372036854775807

Pavyzdys: 1

Papildomi laukai: Ne

ReleaseData

ReleaseData · API priimamų arba grąžinamų duomenų laukai, tipai ir apribojimai. Sukūrę upload_id siųskite failus kaip multipart/form-data ir susiekite juos su produktu. Atsisiuntimui reikia Bearer žetono ir category leidimo; atsakyme pateikiami failo baitai be viešo adreso ar slaptažodžio. Kai mode=period, rinkitės days (1–3650) arba ankstesnį months, bet ne abu. Sąlygos išsaugomos perkant; grąžinus pinigus panaikinama prieiga tik prie grąžintos eilutės.

changelogEilutėPrivalomas: Pakeitimų aprašymas

Pavyzdys: "Manual update"
filesMasyvas <ReleaseFileData > Privalomas: Produkto failai

Pavyzdys: [{"file_id":"00000000-0000-4000-8000-000000000001","sort_order":0,"version_id":"00000000-0000-4000-8000-000000000001"}]
idEilutėPrivalomas: Ištekliaus identifikatorius; išsaugokite grąžintą išraišką.

format: "uuid"

Pavyzdys: "00000000-0000-4000-8000-000000000001"
manifest_sha256Eilutė nullPrivalomas: Skaitmeniniai leidimai · SHA-256

Pavyzdys: "1111111111111111111111111111111111111111111111111111111111111111"
published_atEilutė nullPrivalomas: Paskelbti leidimą · UTC

Eilutė:format: "date-time"

Pavyzdys: null
release_sequenceSveikasis skaičius nullPrivalomas: Skaitmeniniai leidimai · Pozicija surikiuotame rinkinyje.

Pavyzdys: null
stateEilutėPrivalomas: Būsena

Pavyzdys: "active"
version_labelEilutėPrivalomas: Versija

Pavyzdys: "1.0"
withdrawn_atEilutė nullPrivalomas: Atšaukti pasiūlymą · UTC

Eilutė:format: "date-time"

Pavyzdys: null

Papildomi laukai: Ne

ReleaseDraft

ReleaseDraft · Ši operacija nebevykdoma ir grąžina 409 nekeisdama duomenų. Kiekvieno skaitmeninio failo prieigą nustatykite pasirinkdami gavėjus.

changelogEilutėNeprivalomas: Pakeitimų aprašymas

maxLength: 20000

Numatytoji reikšmė: ""
expected_versionSveikasis skaičiusPrivalomas: Prieš įrašant perskaityta versija; neatitikimas atmeta pakeitimą.

minimum: 1maximum: 9223372036854775807

Pavyzdys: 1
version_idsMasyvas <Eilutė> Privalomas: Versija · UUID[]

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

Pavyzdys: ["00000000-0000-4000-8000-000000000001"]
version_labelEilutėPrivalomas: Versija

minLength: 1maxLength: 64

Pavyzdys: "1.0"

Papildomi laukai: Ne

ReleaseFileData

ReleaseFileData · API priimamų arba grąžinamų duomenų laukai, tipai ir apribojimai. Sukūrę upload_id siųskite failus kaip multipart/form-data ir susiekite juos su produktu. Atsisiuntimui reikia Bearer žetono ir category leidimo; atsakyme pateikiami failo baitai be viešo adreso ar slaptažodžio. Kai mode=period, rinkitės days (1–3650) arba ankstesnį months, bet ne abu. Sąlygos išsaugomos perkant; grąžinus pinigus panaikinama prieiga tik prie grąžintos eilutės.

file_idEilutėPrivalomas: Ištekliaus identifikatorius; išsaugokite grąžintą išraišką. · file_id

format: "uuid"

Pavyzdys: "00000000-0000-4000-8000-000000000001"
sort_orderSveikasis skaičiusPrivalomas: Pozicija surikiuotame rinkinyje.

Pavyzdys: 0
version_idEilutėPrivalomas: Ištekliaus identifikatorius; išsaugokite grąžintą išraišką. · version_id

format: "uuid"

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

Papildomi laukai: Ne

ReleaseListData

ReleaseListData · API priimamų arba grąžinamų duomenų laukai, tipai ir apribojimai. Sukūrę upload_id siųskite failus kaip multipart/form-data ir susiekite juos su produktu. Atsisiuntimui reikia Bearer žetono ir category leidimo; atsakyme pateikiami failo baitai be viešo adreso ar slaptažodžio. Kai mode=period, rinkitės days (1–3650) arba ankstesnį months, bet ne abu. Sąlygos išsaugomos perkant; grąžinus pinigus panaikinama prieiga tik prie grąžintos eilutės.

current_release_idEilutė nullPrivalomas: Ištekliaus identifikatorius; išsaugokite grąžintą išraišką. · current_release_id

Eilutė:format: "uuid"

Pavyzdys: "00000000-0000-4000-8000-000000000001"
product_versionSveikasis skaičiusPrivalomas: Dabartinė produkto versija lygiagrečių pakeitimų kontrolei.

Pavyzdys: 2
releasesMasyvas <ReleaseData > Privalomas: Skaitmeniniai leidimai

Pavyzdys: [{"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_daysSveikasis skaičius nullPrivalomas: Dienų skaičius (days; null)

Pavyzdys: 365
update_modeEilutėPrivalomas: Prieiga prie būsimų failų po pirkimo: none / period / unlimited

Pavyzdys: "period"
update_monthsSveikasis skaičius nullPrivalomas: Mėnesiai (months; null)

Pavyzdys: null

Papildomi laukai: Ne

UpdatePolicy

UpdatePolicy · Ši operacija nebevykdoma ir grąžina 409 nekeisdama duomenų. Kiekvieno skaitmeninio failo prieigą nustatykite pasirinkdami gavėjus.

daysSveikasis skaičius nullNeprivalomas

Dienų skaičius (1–3650; mode=period; months=null)

Sveikasis skaičius:minimum: 1maximum: 3650

Pavyzdys: 365

expected_versionSveikasis skaičiusPrivalomas

Prieš įrašant perskaityta versija; neatitikimas atmeta pakeitimą.

minimum: 1maximum: 9223372036854775807

Pavyzdys: 1

modeEilutėPrivalomas

Prieiga prie būsimų failų po pirkimo: none / period / unlimited

Apribojimai

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

Pavyzdys: "period"

monthsSveikasis skaičius nullNeprivalomas

Mėnesiai (1–120; mode=period; days=null)

Sveikasis skaičius:minimum: 1maximum: 120

Pavyzdys: null

Papildomi laukai: Ne

UploadCreate

UploadCreate · API priimamų arba grąžinamų duomenų laukai, tipai ir apribojimai. Sukūrę upload_id siųskite failus kaip multipart/form-data ir susiekite juos su produktu. Atsisiuntimui reikia Bearer žetono ir category leidimo; atsakyme pateikiami failo baitai be viešo adreso ar slaptažodžio. Kai mode=period, rinkitės days (1–3650) arba ankstesnį months, bet ne abu. Sąlygos išsaugomos perkant; grąžinus pinigus panaikinama prieiga tik prie grąžintos eilutės.

filenameEilutėPrivalomas

Failas

minLength: 1maxLength: 255

Pavyzdys: "manual.pdf"

product_idEilutė nullNeprivalomas

Produkto identifikatorius.

Apribojimai · Eilutė 1

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

Pavyzdys: "example"

sha256EilutėPrivalomas

SHA-256 (hex, 64)

Apribojimai

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

Pavyzdys: "5cd2f1cb0e5532b397e7ab1887baf6000c49450fd80ae279eb047c06e4545ecd"

size_bytesSveikasis skaičiusPrivalomas

Dydis baitais

minimum: 1maximum: 262144000

Pavyzdys: 46

Papildomi laukai: Ne

UploadData

UploadData · API priimamų arba grąžinamų duomenų laukai, tipai ir apribojimai. Sukūrę upload_id siųskite failus kaip multipart/form-data ir susiekite juos su produktu. Atsisiuntimui reikia Bearer žetono ir category leidimo; atsakyme pateikiami failo baitai be viešo adreso ar slaptažodžio. Kai mode=period, rinkitės days (1–3650) arba ankstesnį months, bet ne abu. Sąlygos išsaugomos perkant; grąžinus pinigus panaikinama prieiga tik prie grąžintos eilutės.

categoryFileCategory Privalomas: Failo kategorija: internal / customer_document / digital

Pavyzdys: "digital"
expires_atEilutėPrivalomas: Prieigos duomenų galiojimo pabaigos data ir laikas.

format: "date-time"

Pavyzdys: "2026-01-01T12:00:00Z"
filenameEilutėPrivalomas: Failas

Pavyzdys: "manual.pdf"
idEilutėPrivalomas: Ištekliaus identifikatorius; išsaugokite grąžintą išraišką.

format: "uuid"

Pavyzdys: "00000000-0000-4000-8000-000000000001"
product_idEilutė nullPrivalomas: Produkto identifikatorius.

Pavyzdys: "example"
received_bytesSveikasis skaičiusPrivalomas: Įkeliama… · Dydis baitais

Pavyzdys: 46
sha256EilutėPrivalomas: SHA-256 (hex, 64)

Pavyzdys: "5cd2f1cb0e5532b397e7ab1887baf6000c49450fd80ae279eb047c06e4545ecd"
size_bytesSveikasis skaičiusPrivalomas: Dydis baitais

Pavyzdys: 46
statusEilutėPrivalomas: Šios konkrečios operacijos priimama būsena.

Pavyzdys: "ready"

Papildomi laukai: Ne