Схеми на данните: Продукти

dataProductFileListData Задължително

Данни на успешния отговор.

Пример: {"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 Задължително

Метаданни на отговора.

Пример: {"pagination":{"has_more":false,"limit":50,"next_cursor":null},"request_id":"example"}

Допълнителни полета: Не

dataReleaseListData Задължително

Данни на успешния отговор.

Пример: {"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 Задължително

Метаданни на отговора.

Пример: {"pagination":{"has_more":false,"limit":50,"next_cursor":null},"request_id":"example"}

Допълнителни полета: Не

dataUploadData Задължително

Данни на успешния отговор.

Пример: {"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 Задължително

Метаданни на отговора.

Пример: {"request_id":"example"}

Допълнителни полета: Не

dataAudienceData Задължително

Данни на успешния отговор.

Пример: {"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 Задължително

Метаданни на отговора.

Пример: {"request_id":"example-request"}

Допълнителни полета: Не

dataМасив <ProductSummaryData > Задължително

Примерен отговор · ApiResponse_list_ProductSummaryData__.

Пример: [{"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 Задължително

Метаданни на отговора.

Пример: {"locale":"en","market_code":"PL","market_id":"example","pagination":{"has_more":false,"limit":20,"next_cursor":null},"request_id":"example"}

Допълнителни полета: Не

dataProductDetailData Задължително

Примерен отговор · ProductDetailData.

Пример: {"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 Задължително

Метаданни на отговора.

Пример: {"locale":"en","market_code":"PL","market_id":"example","request_id":"example"}

Допълнителни полета: Не

audienceAudienceSelection Задължително

Изрично правило за достъп до споделения файл.

Пример: {"mode":"all_purchasers"}

expected_versionЦяло числоЗадължително

Версията, прочетена преди записа; несъответствие отхвърля актуализацията.

minimum: 1maximum: 9223372036854775807

Пример: 1

Допълнителни полета: Не

anchor_atНизЗадължително

Първа публикация; промяна на правилото не променя датата.

format: "date-time"

Пример: "2026-11-03T12:00:00Z"

effective_atНизЗадължително

Време на публикуване на това правило за достъп.

format: "date-time"

Пример: "2026-11-03T12:00:00Z"

file_idНизЗадължително

Идентификатор на ресурса; запазете го във върнатия вид. · file_id

Пример: "00000000-0000-4000-8000-000000000007"

file_version_idНизЗадължително

ID на неизменна версия на файла.

Пример: "00000000-0000-4000-8000-000000000010"

historical_access_preservedБулева стойностНезадължително

Предишните права остават при стесняване на правилото.

По подразбиране: trueПример: true

idНизЗадължително

Идентификатор на ресурса; запазете го във върнатия вид.

Пример: "00000000-0000-4000-8000-000000000009"

lookback_daysЦяло число | nullЗадължително

1–3650 дни преди първата публикация; само recent_and_new.

Пример: null

modeНизЗадължително

Изрично правило за достъп до споделения файл. new_purchases / recent_and_new / selected / all_purchasers.

Пример: "all_purchasers"

next_cursorНиз | nullЗадължително

Стойност за продължаване към следващата страница или null.

Пример: null

order_idsМасив <Низ> Задължително

Поръчки с този платен продукт без възстановена сума за него.

Пример: []

product_versionЦяло числоЗадължително

Текуща версия на продукта за контрол на едновременни записи.

Пример: 3

revisionЦяло числоЗадължително

Последователна ревизия на правилото за достъп.

Пример: 1

Допълнителни полета: Не

lookback_daysЦяло число | nullНезадължително

1–3650 дни преди първата публикация; само recent_and_new.

Цяло число:minimum: 1maximum: 3650

modeНизЗадължително

Изрично правило за достъп до споделения файл. new_purchases / recent_and_new / selected / all_purchasers.

Ограничения

enum

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

Пример: "new_purchases"

order_idsМасив <Низ> Незадължително

Поръчки с този платен продукт без възстановена сума за него.

maxItems: 1000

Ограничения · Масив 1

pattern

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

По подразбиране: []

Допълнителни полета: Не

available_fromНиз | nullЗадължително

Начало на наличността.

Низ:format: "date-time"

Пример: null

available_untilНиз | nullЗадължително

Край на наличността.

Низ:format: "date-time"

Пример: null

is_availableБулева стойностЗадължително

Дали артикулът е наличен в този контекст.

Пример: true

Допълнителни полета: Не

audienceAudienceSelection | nullНезадължително

Изрично правило за достъп до споделения файл.

Пример: {"mode":"new_purchases"}

expected_versionЦяло числоЗадължително

Версията, прочетена преди записа; несъответствие отхвърля актуализацията.

minimum: 1maximum: 9223372036854775807

Пример: 1

labelНизНезадължително

Име на ресурса в съответния контекст.

maxLength: 300

По подразбиране: ""

upload_idНизЗадължително

Идентификатор на ресурса; запазете го във върнатия вид. · upload_id

format: "uuid"

Пример: "00000000-0000-4000-8000-000000000001"

Допълнителни полета: Не

Допълнителни полета: Да

amountНизЗадължително

Десетична сума, кодирана като JSON низ; null само когато е позволено.

Пример: "0.00"

currencyНизЗадължително

Валутен код на сумата.

Ограничения

pattern

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

Пример: "PLN"

minor_unitsЦяло числоЗадължително

Брой дробни цифри, използвани от валутата.

minimum: 0maximum: 4

Пример: 2

tax_includedБулева стойностЗадължително

Дали подадената цена включва данък.

Пример: true

Допълнителни полета: Не

currencyНизЗадължително

Валутен код на сумата.

idНизЗадължително

Идентификатор на ресурса; запазете го във върнатия вид. (PriceListData).

tax_includedБулева стойностЗадължително

Дали подадената цена включва данък.

versionЦяло числоЗадължително

Версия на ресурса за контрол на едновременни записи.

Допълнителни полета: Не

brand_idНиз | nullНезадължително

Идентификатор на марката.

Низ:minLength: 1maxLength: 63

conditionНизНезадължително

Състояние на продукта.

Ограничения

enum

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

По подразбиране: "new"

descriptionНиз | nullНезадължително

Описание на избрания език.

Низ:maxLength: 100000

feature_value_idsМасив <Низ> Незадължително

Идентификатори на избрани стойности на характеристиката.

maxItems: 1000

Масив:minLength: 1maxLength: 63

identifiersProductIdentifiers | nullНезадължително

Идентификационни кодове на продукта.

market_idsМасив <Низ> Незадължително

Идентификатори на избраните пазари.

maxItems: 1000

Масив:minLength: 1maxLength: 63

media_idsМасив <Низ> Незадължително

Идентификатори на вече съществуващи медийни файлове.

maxItems: 30

Масив:minLength: 1maxLength: 63

meta_descriptionНиз | nullНезадължително

Описание за търсачки на избрания език.

Низ:maxLength: 160

meta_keywordsМасив <Низ> | nullНезадължително

Ключови думи за търсачки на избрания език.

Масив:maxItems: 20

Масив / Масив:maxLength: 50

meta_titleНиз | nullНезадължително

Заглавие за търсачки на избрания език.

Низ:maxLength: 70

nameНизЗадължително

Име на ресурса в съответния контекст.

minLength: 1maxLength: 300

Пример: "Example"

pricingProductPrice Незадължително

Настройки за ценообразуване и версии за контрол на едновременни записи.

primary_category_idНиз | nullНезадължително

Идентификатор на основната категория.

Низ:minLength: 1maxLength: 63

publishedБулева стойностНезадължително

Дали ресурсът е публикуван.

По подразбиране: false

skuНизЗадължително

Код на складовата единица.

minLength: 1maxLength: 100

Ограничения

pattern

"^\\S+$"

Пример: "example"

slugНиз | nullНезадължително

Сегмент от URL пътя на избрания език.

Низ:maxLength: 160

tax_category_idНиз | nullНезадължително

Идентификатор на данъчната категория.

Низ:minLength: 1maxLength: 63

variant_value_idsМасив <Низ> Незадължително

Идентификатори на избраните стойности за вариант.

maxItems: 250

Масив:minLength: 1maxLength: 63

variants_enabledБулева стойностНезадължително

Дали продуктът използва варианти.

По подразбиране: false

Допълнителни полета: Не

availabilityAvailabilityData Задължително

Информация за наличността в избрания контекст.

Пример: {"available_from":null,"available_until":null,"is_available":true}

brand_idНиз | nullЗадължително

Идентификатор на марката.

Пример: null

conditionНизЗадължително

Състояние на продукта.

Ограничения

enum

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

Пример: "new"

created_atНизЗадължително

Време на създаване.

format: "date-time"

Пример: "2026-01-01T12:00:00Z"

descriptionНиз | nullЗадължително

Описание на избрания език.

Пример: "example"

featuresМасив <FeatureSelectionData > Задължително

Характеристики на продукта.

Пример: [{"feature_id":"example","feature_name":"example","value":"example","value_id":"example"}]

idНизЗадължително

Идентификатор на ресурса; запазете го във върнатия вид. (ProductDetailData).

Пример: "example"

identifiersОбектДопълнителни полета: НизЗадължително

Идентификационни кодове на продукта.

Пример: {}

mediaМасив <ProductMediaData > Задължително

Информация за приложените медийни файлове.

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

meta_descriptionНиз | nullЗадължително

Описание за търсачки на избрания език.

Пример: "example"

meta_keywordsМасив <Низ> | nullЗадължително

Ключови думи за търсачки на избрания език.

Пример: ["example"]

meta_titleНиз | nullЗадължително

Заглавие за търсачки на избрания език.

Пример: "example"

nameНиз | nullЗадължително

Име на ресурса в съответния контекст.

Пример: "Example"

numberНизЗадължително

Номер на поръчката или искането, предназначен за потребителя.

Пример: "example"

pricePriceData | nullЗадължително

Информация за цената в избрания контекст.

Пример: {"amount":"0.00","currency":"PLN","minor_units":2,"tax_included":true}

price_versionЦяло числоЗадължително

Текуща версия на цената за контрол на едновременни записи.

Пример: 1

primary_category_idНиз | nullЗадължително

Идентификатор на основната категория.

Пример: "example"

primary_media_idНиз | nullЗадължително

Идентификатор на основния медиен файл.

Пример: "example"

publishedБулева стойностЗадължително

Дали ресурсът е публикуван.

Пример: false

skuНизЗадължително

Код на складовата единица.

Пример: "example"

slugНиз | nullЗадължително

Сегмент от URL пътя на избрания език.

Пример: "example"

tax_category_idНизЗадължително

Идентификатор на данъчната категория.

Пример: "example"

updated_atНизЗадължително

Време на последната актуализация.

format: "date-time"

Пример: "2026-01-01T12:00:00Z"

variants_enabledБулева стойностЗадължително

Дали продуктът използва варианти.

Пример: false

versionЦяло числоЗадължително

Версия на ресурса за контрол на едновременни записи.

Пример: 1

Допълнителни полета: Не

categoryFileCategory Задължително

Категория на файла: internal / customer_document / digital

Пример: "digital"

created_atНизЗадължително

Време на създаване.

format: "date-time"

Пример: "2026-01-01T12:00:00Z"

current_version_idНизЗадължително

Идентификатор на ресурса; запазете го във върнатия вид. · current_version_id

format: "uuid"

Пример: "00000000-0000-4000-8000-000000000001"

file_idНизЗадължително

Идентификатор на ресурса; запазете го във върнатия вид. · file_id

format: "uuid"

Пример: "00000000-0000-4000-8000-000000000001"

filenameНизЗадължително

Файл

Пример: "manual.pdf"

idНизЗадължително

Идентификатор на ресурса; запазете го във върнатия вид.

format: "uuid"

Пример: "00000000-0000-4000-8000-000000000001"

labelНизЗадължително

Име на ресурса в съответния контекст.

Пример: "Manual"

mime_typeНизЗадължително

Тип на медийното съдържание.

Пример: "application/pdf"

sha256НизЗадължително

SHA-256 (hex, 64)

Пример: "5cd2f1cb0e5532b397e7ab1887baf6000c49450fd80ae279eb047c06e4545ecd"

size_bytesЦяло числоЗадължително

Размер в байтове

Пример: 46

stateНизЗадължително

Статус

Пример: "active"

version_numberЦяло числоЗадължително

Версия

Пример: 1

Допълнителни полета: Не

filesМасив <ProductFileData > Задължително

Файлове на продукта

Пример: [{"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

Допълнителни полета: Не

eanНиз | nullНезадължително

EAN идентификатор на продукта.

Низ:minLength: 1maxLength: 100

isbnНиз | nullНезадължително

ISBN идентификатор.

Низ:minLength: 1maxLength: 100

mpnНиз | nullНезадължително

Каталожен номер на производителя.

Низ:minLength: 1maxLength: 100

upcНиз | nullНезадължително

UPC идентификатор на продукта.

Низ:minLength: 1maxLength: 100

Допълнителни полета: Не

alt_textНиз | nullЗадължително

Алтернативен текст за изображение.

Пример: "example"

idНизЗадължително

Идентификатор на ресурса; запазете го във върнатия вид. (ProductMediaData).

Пример: "example"

is_primaryБулева стойностЗадължително

Дали това е основният елемент.

Пример: true

kindНизЗадължително

Вариант на структурата от данни, определен от допустимите стойности.

Ограничения

enum

["image", "video", "model_3d"]

Пример: "image"

mime_typeНизЗадължително

Тип на медийното съдържание.

Пример: "image/jpeg"

positionЦяло числоЗадължително

Позиция в подредената колекция.

Пример: 1

urlНиз | nullЗадължително

URL на ресурса.

Пример: "https://example.invalid/product.jpg"

Допълнителни полета: Не

amountНиз | nullЗадължително

Десетична сума, кодирана като JSON низ; null само когато е позволено.

Низ:maxLength: 19

Ограничения · Низ 1

pattern

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

Пример: "0.00"

currencyНизЗадължително

Валутен код на сумата.

Ограничения

pattern

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

Пример: "PLN"

expected_price_list_versionЦяло числоЗадължително

Предварително прочетена версия на ценовата листа, необходима за този запис.

minimum: 1maximum: 9223372036854775807

Пример: 1

expected_versionЦяло числоЗадължително

Версията, прочетена преди записа; несъответствие отхвърля актуализацията.

minimum: 0maximum: 9223372036854775807

Пример: 0

kindНизЗадължително

Вариант на структурата от данни, определен от допустимите стойности.

Ограничения

enum

["base", "market_fixed"]

Пример: "base"

price_list_idНизЗадължително

Идентификатор на ценовата листа.

minLength: 1maxLength: 63

Пример: "example"

tax_includedБулева стойностЗадължително

Дали подадената цена включва данък.

Пример: true

Допълнителни полета: Не

availabilityAvailabilityData Задължително

Информация за наличността в избрания контекст.

Пример: {"available_from":null,"available_until":null,"is_available":true}

brand_idНиз | nullЗадължително

Идентификатор на марката.

Пример: null

conditionНизЗадължително

Състояние на продукта.

Ограничения

enum

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

Пример: "new"

created_atНизЗадължително

Време на създаване.

format: "date-time"

Пример: "2026-01-01T12:00:00Z"

idНизЗадължително

Идентификатор на ресурса; запазете го във върнатия вид. (ProductSummaryData).

Пример: "example"

nameНиз | nullЗадължително

Име на ресурса в съответния контекст.

Пример: "Example"

numberНизЗадължително

Номер на поръчката или искането, предназначен за потребителя.

Пример: "example"

pricePriceData | nullЗадължително

Информация за цената в избрания контекст.

Пример: {"amount":"0.00","currency":"PLN","minor_units":2,"tax_included":true}

price_versionЦяло числоЗадължително

Текуща версия на цената за контрол на едновременни записи.

Пример: 1

primary_category_idНиз | nullЗадължително

Идентификатор на основната категория.

Пример: "example"

primary_media_idНиз | nullЗадължително

Идентификатор на основния медиен файл.

Пример: "example"

publishedБулева стойностЗадължително

Дали ресурсът е публикуван.

Пример: false

skuНизЗадължително

Код на складовата единица.

Пример: "example"

slugНиз | nullЗадължително

Сегмент от URL пътя на избрания език.

Пример: "example"

tax_category_idНизЗадължително

Идентификатор на данъчната категория.

Пример: "example"

updated_atНизЗадължително

Време на последната актуализация.

format: "date-time"

Пример: "2026-01-01T12:00:00Z"

variants_enabledБулева стойностЗадължително

Дали продуктът използва варианти.

Пример: false

versionЦяло числоЗадължително

Версия на ресурса за контрол на едновременни записи.

Пример: 1

Допълнителни полета: Не

brand_idНиз | nullНезадължително

Идентификатор на марката.

Низ:minLength: 1maxLength: 63

conditionНизНезадължително

Състояние на продукта.

Ограничения

enum

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

descriptionНиз | nullНезадължително

Описание на избрания език.

Низ:maxLength: 100000

Пример: null

expected_variant_price_versionsОбектДопълнителни полета: Цяло число

minimum: 0maximum: 9223372036854775807

Незадължително

Предварително прочетени версии на цени, с ключ идентификатора на варианта.

maxProperties: 250

Ограничения

propertyNames

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

expected_versionЦяло числоЗадължително

Версията, прочетена преди записа; несъответствие отхвърля актуализацията.

minimum: 1maximum: 9223372036854775807

Пример: 1

feature_value_idsМасив <Низ> Незадължително

Идентификатори на избрани стойности на характеристиката.

maxItems: 1000

Масив:minLength: 1maxLength: 63

identifiersProductIdentifiers | nullНезадължително

Идентификационни кодове на продукта.

market_idsМасив <Низ> Незадължително

Идентификатори на избраните пазари.

maxItems: 1000

Масив:minLength: 1maxLength: 63

media_idsМасив <Низ> Незадължително

Идентификатори на вече съществуващи медийни файлове.

maxItems: 30

Масив:minLength: 1maxLength: 63

meta_descriptionНиз | nullНезадължително

Описание за търсачки на избрания език.

Низ:maxLength: 160

meta_keywordsМасив <Низ> | nullНезадължително

Ключови думи за търсачки на избрания език.

Масив:maxItems: 20

Масив / Масив:maxLength: 50

meta_titleНиз | nullНезадължително

Заглавие за търсачки на избрания език.

Низ:maxLength: 70

nameНиз | nullНезадължително

Име на ресурса в съответния контекст.

Низ:maxLength: 300

pricingProductPrice Незадължително

Настройки за ценообразуване и версии за контрол на едновременни записи.

Пример: {"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Низ | nullНезадължително

Идентификатор на основната категория.

Низ:minLength: 1maxLength: 63

publishedБулева стойностНезадължително

Дали ресурсът е публикуван.

skuНизНезадължително

Код на складовата единица.

minLength: 1maxLength: 100

Ограничения

pattern

"^\\S+$"

Пример: "example"

slugНиз | nullНезадължително

Сегмент от URL пътя на избрания език.

Низ:maxLength: 160

tax_category_idНиз | nullНезадължително

Идентификатор на данъчната категория.

Низ:minLength: 1maxLength: 63

variant_value_idsМасив <Низ> Незадължително

Идентификатори на избраните стойности за вариант.

maxItems: 250

Масив:minLength: 1maxLength: 63

variants_enabledБулева стойностНезадължително

Дали продуктът използва варианти.

Допълнителни полета: Не

expected_versionЦяло числоЗадължително

Версията, прочетена преди записа; несъответствие отхвърля актуализацията.

minimum: 1maximum: 9223372036854775807

Пример: 1

Допълнителни полета: Не

changelogНизЗадължително

Описание на промените

Пример: "Manual update"

filesМасив <ReleaseFileData > Задължително

Файлове на продукта

Пример: [{"file_id":"00000000-0000-4000-8000-000000000001","sort_order":0,"version_id":"00000000-0000-4000-8000-000000000001"}]

idНизЗадължително

Идентификатор на ресурса; запазете го във върнатия вид.

format: "uuid"

Пример: "00000000-0000-4000-8000-000000000001"

manifest_sha256Низ | nullЗадължително

Цифрови издания · SHA-256

Пример: "1111111111111111111111111111111111111111111111111111111111111111"

published_atНиз | nullЗадължително

Публикуване на изданието · UTC

Низ:format: "date-time"

Пример: null

release_sequenceЦяло число | nullЗадължително

Цифрови издания · Позиция в подредената колекция.

Пример: null

stateНизЗадължително

Статус

Пример: "active"

version_labelНизЗадължително

Версия

Пример: "1.0"

withdrawn_atНиз | nullЗадължително

Оттегляне на офертата · UTC

Низ:format: "date-time"

Пример: null

Допълнителни полета: Не

changelogНизНезадължително

Описание на промените

maxLength: 20000

По подразбиране: ""

expected_versionЦяло числоЗадължително

Версията, прочетена преди записа; несъответствие отхвърля актуализацията.

minimum: 1maximum: 9223372036854775807

Пример: 1

version_idsМасив <Низ> Задължително

Версия · UUID[]

minItems: 1maxItems: 20

Масив:format: "uuid"

Пример: ["00000000-0000-4000-8000-000000000001"]

version_labelНизЗадължително

Версия

minLength: 1maxLength: 64

Пример: "1.0"

Допълнителни полета: Не

file_idНизЗадължително

Идентификатор на ресурса; запазете го във върнатия вид. · file_id

format: "uuid"

Пример: "00000000-0000-4000-8000-000000000001"

sort_orderЦяло числоЗадължително

Позиция в подредената колекция.

Пример: 0

version_idНизЗадължително

Идентификатор на ресурса; запазете го във върнатия вид. · version_id

format: "uuid"

Пример: "00000000-0000-4000-8000-000000000001"

Допълнителни полета: Не

current_release_idНиз | nullЗадължително

Идентификатор на ресурса; запазете го във върнатия вид. · current_release_id

Низ:format: "uuid"

Пример: "00000000-0000-4000-8000-000000000001"

product_versionЦяло числоЗадължително

Текуща версия на продукта за контрол на едновременни записи.

Пример: 2

releasesМасив <ReleaseData > Задължително

Цифрови издания

Пример: [{"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Цяло число | nullЗадължително

Брой дни (days; null)

Пример: 365

update_modeНизЗадължително

Достъп до бъдещи файлове след покупка: none / period / unlimited

Пример: "period"

update_monthsЦяло число | nullЗадължително

Месеци (months; null)

Пример: null

Допълнителни полета: Не

daysЦяло число | nullНезадължително

Брой дни (1–3650; mode=period; months=null)

Цяло число:minimum: 1maximum: 3650

Пример: 365

expected_versionЦяло числоЗадължително

Версията, прочетена преди записа; несъответствие отхвърля актуализацията.

minimum: 1maximum: 9223372036854775807

Пример: 1

modeНизЗадължително

Достъп до бъдещи файлове след покупка: none / period / unlimited

Ограничения

enum

["none", "period", "unlimited"]

Пример: "period"

monthsЦяло число | nullНезадължително

Месеци (1–120; mode=period; days=null)

Цяло число:minimum: 1maximum: 120

Пример: null

Допълнителни полета: Не

filenameНизЗадължително

Файл

minLength: 1maxLength: 255

Пример: "manual.pdf"

product_idНиз | nullНезадължително

Идентификатор на продукта.

Ограничения · Низ 1

pattern

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

Пример: "example"

sha256НизЗадължително

SHA-256 (hex, 64)

Ограничения

pattern

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

Пример: "5cd2f1cb0e5532b397e7ab1887baf6000c49450fd80ae279eb047c06e4545ecd"

size_bytesЦяло числоЗадължително

Размер в байтове

minimum: 1maximum: 262144000

Пример: 46

Допълнителни полета: Не

categoryFileCategory Задължително

Категория на файла: internal / customer_document / digital

Пример: "digital"

expires_atНизЗадължително

Дата и час на изтичане на данните за достъп.

format: "date-time"

Пример: "2026-01-01T12:00:00Z"

filenameНизЗадължително

Файл

Пример: "manual.pdf"

idНизЗадължително

Идентификатор на ресурса; запазете го във върнатия вид.

format: "uuid"

Пример: "00000000-0000-4000-8000-000000000001"

product_idНиз | nullЗадължително

Идентификатор на продукта.

Пример: "example"

received_bytesЦяло числоЗадължително

Качване… · Размер в байтове

Пример: 46

sha256НизЗадължително

SHA-256 (hex, 64)

Пример: "5cd2f1cb0e5532b397e7ab1887baf6000c49450fd80ae279eb047c06e4545ecd"

size_bytesЦяло числоЗадължително

Размер в байтове

Пример: 46

statusНизЗадължително

Статус, приеман от тази конкретна операция.

Пример: "ready"

Допълнителни полета: Не