获取商品特征描述 - Ozon Seller API

请求参数

Header 参数

Client-Id

string

用户识别号。

必需

Api-Key

string

API-密钥。

必需

Body 参数application/json

filter

object (object)

商品过滤。

必需

offer_id

array[string]

可选

基于参数 offer_id的过滤。可以提交数值列表。

product_id

array[string <int64>]

可选

基于参数 product_id的过滤。可以提交数值列表。

visibility

enum<string>

可选

按商品曝光度过滤:

ALL —— 所有的商品，除了已存档的。

VISIBLE —— 买家可见的商品。

INVISIBLE —— 买家看不到的商品。

EMPTY_STOCK—— 没有现货的商品。

NOT_MODERATED —— 未通过审核的商品。

MODERATED —— 通过审核的商品。

DISABLED —— 买家可以看到但不能购买的商品。

STATE_FAILED —— 商品创建失败。

READY_TO_SUPPLY —— 已准备好交货的商品。

VALIDATION_STATE_PENDING —— 正在被验证人预审核的商品。

VALIDATION_STATE_FAIL —— 验证人预审核未通过的商品。

VALIDATION_STATE_SUCCESS —— 验证人预审核通过的商品。

TO_SUPPLY —— 准备出售的商品。

IN_SALE —— 正在销售的商品。

REMOVED_FROM_SALE —— 对买家隐藏的商品。

BANNED —— 商品被封禁。

OVERPRICED —— 价格虚高的商品。

CRITICALLY_OVERPRICED —— 商品价格过高。

EMPTY_BARCODE —— 没有条形码的商品。

BARCODE_EXISTS —— 有条形码的商品。

QUARANTINE —— 价格变化超过50%后商品被隔离。

ARCHIVED —— 归档的商品。

OVERPRICED_WITH_STOCK —— 销售的商品价格高于竞争对手的价格。

PARTIAL_APPROVED —— 销售的商品描述为空或不完整。

IMAGE_ABSENT —— 没有图像的商品。

MODERATION_BLOCK —— 被审核封锁的商品。

枚举值:

ALLVISIBLEINVISIBLEEMPTY_STOCKNOT_MODERATEDMODERATEDDISABLEDSTATE_FAILEDREADY_TO_SUPPLYVALIDATION_STATE_PENDINGVALIDATION_STATE_FAILVALIDATION_STATE_SUCCESSTO_SUPPLYIN_SALEREMOVED_FROM_SALEBANNEDOVERPRICEDCRITICALLY_OVERPRICEDEMPTY_BARCODEBARCODE_EXISTSQUARANTINEARCHIVEDOVERPRICED_WITH_STOCKPARTIAL_APPROVEDIMAGE_ABSENTMODERATION_BLOCK

默认值:

ALL

last_id

string

可选

页面上最后一个值的ID。运行第一个查询时，将此字段留空。

要检索以下数值，请从上一个查询的响应中指定last_id。

limit

integer <int64>

必需

每页的值的数量。最小 —— 1，最大 —— 1000。

sort_by

string

可选

对商品进行分类的参数。

sort_dir

string

分类方向。

可选

示例

{
    "filter": {
        "product_id": [
            "213761435"
        ],
        "visibility": "ALL"
    },
    "limit": 100,
    "last_id": "okVsfA==«",
    "sort_dir": "ASC"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

商品特征描述

Body

result

array[object (object) {20}]

查询结果。

可选

attributes

array[object (object) {3}]

商品特性的数组。

可选

barcode

string

条形码。

可选

category_id

integer <int64>

已废弃

类别ID。
请将其与以下方法结合使用：/v1/description-category/tree, /v1/description-category/attribute, /v1/description-category/attribute/values.

当上述方法被禁用时，此参数也将被禁用。

description_category_id

integer <int64>

可选

类别ID。
请将其与以下方法结合使用：/v1/description-category/attribute и /v1/description-category/attribute/values。

color_image

string

市场营销色彩。

可选

complex_attributes

array[object (object) {1}]

可选

已录入的特性的数组。

depth

integer <int32>

深度。

可选

dimension_unit

string

可选

尺寸的测量单位。

mm —— 毫米，

cm —— 厘米，

in —— 英寸。

height

integer <int32>

包装高度。

可选

integer <int64>

商品特性的识别码。

可选

image_group_id

string

已废弃

用于后续批量下载图像的识别码。

images

array[object (object) {3}]

可选

产品图片链接的数组。

images360

array[object (object) {2}]

图像数组360。

可选

name

string

可选

商品名称。最多500个字符。

offer_id

string

可选

卖家系统中的商品识别码是卖家系统中的商品标识符是商品货号。

pdf_list

array[object (object) {3}]

PDF文件的阵列。

可选

weight

integer <int32>

可选

商品在包装中的重量。

weight_unit

string

重量测量单位。

可选

type_id

integer <int64>

商品类型的标识符。

可选

width

integer <int32>

包装宽度。

可选

last_id

string

可选

页面上最后一个值的ID。运行第一个查询时，将此字段留空。

要检索以下数值，请从上一个查询的响应中指定last_id。

total

string <int32>

列表中的商品数量。

可选

示例

{
    "result": [
        {
            "id": 213761435,
            "barcode": "",
            "category_id": 17038062,
            "name": "Пленка защитная для Xiaomi Redmi Note 10 Pro 5G",
            "offer_id": "21470",
            "height": 10,
            "depth": 210,
            "width": 140,
            "dimension_unit": "mm",
            "weight": 50,
            "weight_unit": "g",
            "images": [
                {
                    "file_name": "https://cdn1.ozone.ru/s3/multimedia-f/6190456071.jpg",
                    "default": true,
                    "index": 0
                },
                {
                    "file_name": "https://cdn1.ozone.ru/s3/multimedia-7/6190456099.jpg",
                    "default": false,
                    "index": 1
                },
                {
                    "file_name": "https://cdn1.ozone.ru/s3/multimedia-9/6190456065.jpg",
                    "default": false,
                    "index": 2
                }
            ],
            "images360": [],
            "pdf_list": [],
            "attributes": [
                {
                    "attribute_id": 5219,
                    "complex_id": 0,
                    "values": [
                        {
                            "dictionary_value_id": 970718176,
                            "value": "универсальный"
                        }
                    ]
                },
                {
                    "attribute_id": 11051,
                    "complex_id": 0,
                    "values": [
                        {
                            "dictionary_value_id": 970736931,
                            "value": "Прозрачный"
                        }
                    ]
                },
                {
                    "attribute_id": 10100,
                    "complex_id": 0,
                    "values": [
                        {
                            "dictionary_value_id": 0,
                            "value": "false"
                        }
                    ]
                },
                {
                    "attribute_id": 11794,
                    "complex_id": 0,
                    "values": [
                        {
                            "dictionary_value_id": 970860783,
                            "value": "safe"
                        }
                    ]
                },
                {
                    "attribute_id": 9048,
                    "complex_id": 0,
                    "values": [
                        {
                            "dictionary_value_id": 0,
                            "value": "Пленка защитная для Xiaomi Redmi Note 10 Pro 5G"
                        }
                    ]
                },
                {
                    "attribute_id": 5076,
                    "complex_id": 0,
                    "values": [
                        {
                            "dictionary_value_id": 39638,
                            "value": "Xiaomi"
                        }
                    ]
                },
                {
                    "attribute_id": 9024,
                    "complex_id": 0,
                    "values": [
                        {
                            "dictionary_value_id": 0,
                            "value": "21470"
                        }
                    ]
                },
                {
                    "attribute_id": 10015,
                    "complex_id": 0,
                    "values": [
                        {
                            "dictionary_value_id": 0,
                            "value": "false"
                        }
                    ]
                },
                {
                    "attribute_id": 85,
                    "complex_id": 0,
                    "values": [
                        {
                            "dictionary_value_id": 971034861,
                            "value": "Brand"
                        }
                    ]
                },
                {
                    "attribute_id": 9461,
                    "complex_id": 0,
                    "values": [
                        {
                            "dictionary_value_id": 349824787,
                            "value": "Защитная пленка для смартфона"
                        }
                    ]
                },
                {
                    "attribute_id": 4180,
                    "complex_id": 0,
                    "values": [
                        {
                            "dictionary_value_id": 0,
                            "value": "Пленка защитная для Xiaomi Redmi Note 10 Pro 5G"
                        }
                    ]
                },
                {
                    "attribute_id": 4191,
                    "complex_id": 0,
                    "values": [
                        {
                            "dictionary_value_id": 0,
                            "value": "Пленка предназначена для модели Xiaomi Redmi Note 10 Pro 5G. Защитная гидрогелевая пленка обеспечит защиту вашего смартфона от царапин, пыли, сколов и потертостей."
                        }
                    ]
                },
                {
                    "attribute_id": 8229,
                    "complex_id": 0,
                    "values": [
                        {
                            "dictionary_value_id": 91521,
                            "value": "Защитная пленка"
                        }
                    ]
                }
            ],
            "complex_attributes": [],
            "color_image": "",
            "last_id": ""
        }
    ],
    "total": 1,
    "last_id": "onVsfA=="
}

🟠400请求有误

🟠403禁止访问

🟠404记录不存在

🟠409409

🔴500服务器错误