跳至内容
ShopentlyLearn

数据架构: 属性与值

数据架构: 属性与值. API 接收或返回的数据字段、类型和约束。

数据架构

获取 — 属性与值 — 响应

ApiResponse_FeatureData_ · API 接收或返回的数据字段、类型和约束。
dataFeatureData 必填

响应示例 · FeatureData.

示例: {"created_at":"2026-01-01T12:00:00Z","id":"example","name":"Example","number":"example","position":1,"updated_at":"2026-01-01T12:00:00Z","version":1}
metaContextPageMeta ContextMeta PageMeta RequestMeta 必填

响应元数据。

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

附加字段: 否

获取 · 值 — 属性与值 — 响应

ApiResponse_FeatureValueData_ · API 接收或返回的数据字段、类型和约束。
dataFeatureValueData 必填

响应示例 · FeatureValueData.

示例: {"created_at":"2026-01-01T12:00:00Z","feature_id":"example","id":"example","number":"example","position":1,"updated_at":"2026-01-01T12:00:00Z","value":"example","version":1}
metaContextPageMeta ContextMeta PageMeta RequestMeta 必填

响应元数据。

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

附加字段: 否

获取列表 — 属性与值 — 响应

ApiResponse_list_FeatureData__ · API 接收或返回的数据字段、类型和约束。
data数组 <FeatureData > 必填

响应示例 · ApiResponse_list_FeatureData__.

示例: [{"created_at":"2026-01-01T12:00:00Z","id":"example","name":"Example","number":"example","position":1,"updated_at":"2026-01-01T12:00:00Z","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"}

附加字段: 否

获取列表 · 值 — 属性与值 — 响应

ApiResponse_list_FeatureValueData__ · API 接收或返回的数据字段、类型和约束。
data数组 <FeatureValueData > 必填

响应示例 · ApiResponse_list_FeatureValueData__.

示例: [{"created_at":"2026-01-01T12:00:00Z","feature_id":"example","id":"example","number":"example","position":1,"updated_at":"2026-01-01T12:00:00Z","value":"example","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"}

附加字段: 否

创建 — 属性与值 — 请求体

FeatureCreate · API 接收或返回的数据字段、类型和约束。
name字符串必填

对应上下文中的资源名称。

minLength: 1maxLength: 120
约束
pattern
"^[^\\x00]*$"
示例: "Example"
position整数可选

在有序集合中的位置。

minimum: 0maximum: 2147483647

附加字段: 否

获取 — 属性与值 — 响应

FeatureData · API 接收或返回的数据字段、类型和约束。
created_at字符串必填

创建时间。

format: "date-time"
示例: "2026-01-01T12:00:00Z"
id字符串必填

资源标识符;请保留返回的原值。 (FeatureData).

示例: "example"
name字符串 null必填

对应上下文中的资源名称。

示例: "Example"
number字符串必填

面向用户的订单号或申请编号。

示例: "example"
position整数必填

在有序集合中的位置。

示例: 1
updated_at字符串必填

最近更新时间。

format: "date-time"
示例: "2026-01-01T12:00:00Z"
version整数必填

用于并发控制的资源版本。

示例: 1

附加字段: 否

产品属性

FeatureSelectionData · 架构 · 数据架构: 属性与值
feature_id字符串必填

属性标识符。

示例: "example"
feature_name字符串 null必填

属性名称。

示例: "example"
value字符串 null必填

由所在架构描述的值。

示例: "example"
value_id字符串必填

字典值标识符。

示例: "example"

附加字段: 否

更新 — 属性与值 — 请求体

FeatureUpdate · API 接收或返回的数据字段、类型和约束。
expected_version整数必填

写入前读取的版本;不匹配时拒绝更新。

minimum: 1maximum: 9223372036854775807
示例: 1
name字符串 null可选

对应上下文中的资源名称。

字符串:minLength: 1maxLength: 120
约束 · 字符串 1
pattern
"^[^\\x00]*$"
示例: "Example"
position整数可选

在有序集合中的位置。

minimum: 0maximum: 2147483647

附加字段: 否

创建 · 值 — 属性与值 — 请求体

FeatureValueCreate · API 接收或返回的数据字段、类型和约束。
expected_version整数必填

写入前读取的版本;不匹配时拒绝更新。

minimum: 1maximum: 9223372036854775807
示例: 1
position整数可选

在有序集合中的位置。

minimum: 0maximum: 2147483647
value字符串必填

由所在架构描述的值。

minLength: 1maxLength: 180
约束
pattern
"^[^\\x00]*$"
示例: "Example"

附加字段: 否

获取 · 值 — 属性与值 — 响应

FeatureValueData · API 接收或返回的数据字段、类型和约束。
created_at字符串必填

创建时间。

format: "date-time"
示例: "2026-01-01T12:00:00Z"
feature_id字符串必填

属性标识符。

示例: "example"
id字符串必填

资源标识符;请保留返回的原值。 (FeatureValueData).

示例: "example"
number字符串必填

面向用户的订单号或申请编号。

示例: "example"
position整数必填

在有序集合中的位置。

示例: 1
updated_at字符串必填

最近更新时间。

format: "date-time"
示例: "2026-01-01T12:00:00Z"
value字符串 null必填

由所在架构描述的值。

示例: "example"
version整数必填

用于并发控制的资源版本。

示例: 1

附加字段: 否

更新 · 值 — 属性与值 — 请求体

FeatureValueUpdate · API 接收或返回的数据字段、类型和约束。
expected_version整数必填

写入前读取的版本;不匹配时拒绝更新。

minimum: 1maximum: 9223372036854775807
示例: 1
position整数可选

在有序集合中的位置。

minimum: 0maximum: 2147483647
value字符串 null可选

由所在架构描述的值。

字符串:minLength: 1maxLength: 180
约束 · 字符串 1
pattern
"^[^\\x00]*$"
示例: "Example"

附加字段: 否