Ozon Seller API

根据属性的参考值进行搜索

POST

/v1/description-category/attribute/values/search

CategoryAPI

根据请求中的指定值value返回属性的参考值。

是否存在嵌套参考表，可以通过方法 /v1/description-category/attribute 进行查询。

请求参数

Header 参数

Client-Id

string

用户识别号。

必需

Api-Key

string

API-密钥。

必需

Body 参数application/json

attribute_id

integer <int64>

必需

属性的标识符。可以使用方法 /v1/description-category/attribute获取。

description_category_id

integer <int64>

必需

类目的标识符。可以使用方法 /v1/description-category/tree获取。

limit

integer <int64>

必需

返回结果中的值数量：:

最大值 — 100，

最小值 — 1。

type_id

integer <int64>

必需

商品类型的标识符。可以使用方法 /v1/description-category/tree获取。

value

string

必需

系统将根据此值搜索参考值。最少需要2个字符。

示例

{
    "attribute_id": 0,
    "description_category_id": 0,
    "limit": 0,
    "type_id": 0,
    "value": "string"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api-seller.ozon.ru/v1/description-category/attribute/values/search' \
--header 'Client-Id;' \
--header 'Api-Key;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "attribute_id": 0,
    "description_category_id": 0,
    "limit": 0,
    "type_id": 0,
    "value": "string"
}'

返回响应

🟢200成功

application/json

属性的参考值。

Body

result

array[object (object) {4}]

属性值。

可选

integer <int64>

属性值的标识符。

可选

info

string

额外信息。

可选

picture

string

图片链接。

可选

value

string

可选

示例

{
    "result": [
        {
            "id": 0,
            "info": "string",
            "picture": "string",
            "value": "string"
        }
    ]
}

🔴500服务器错误

修改于 2025-06-10 08:30:31

特征值指南

创建或更新商品