品列表的 - 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 —— 对买家隐藏的商品。

OVERPRICED —— 价格虚高的商品。

CRITICALLY_OVERPRICED —— 商品价格过高。

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

BARCODE_EXISTS —— 有条形码的商品。

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

ARCHIVED —— 归档的商品。

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

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

枚举值:

ALLVISIBLEINVISIBLEEMPTY_STOCKNOT_MODERATEDMODERATEDDISABLEDSTATE_FAILEDREADY_TO_SUPPLYVALIDATION_STATE_PENDINGVALIDATION_STATE_FAILVALIDATION_STATE_SUCCESSTO_SUPPLYIN_SALEREMOVED_FROM_SALEOVERPRICEDCRITICALLY_OVERPRICEDEMPTY_BARCODEBARCODE_EXISTSQUARANTINEARCHIVEDOVERPRICED_WITH_STOCKPARTIAL_APPROVED

默认值:

ALL

last_id

string

可选

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

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

limit

integer <int64>

可选

答复的信息数量。默认设置为1。最大值是1000。

示例

{
    "filter": {
        "offer_id": [
            "136748"
        ],
        "product_id": [
            "223681945"
        ],
        "visibility": "ALL"
    },
    "last_id": "",
    "limit": 100
}

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST 'https://api-seller.ozon.ru/v3/product/list' \
--header 'Client-Id;' \
--header 'Api-Key;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "filter": {
        "offer_id": [
            "136748"
        ],
        "product_id": [
            "223681945"
        ],
        "visibility": "ALL"
    },
    "last_id": "",
    "limit": 100
}'

返回响应

🟢200成功

application/json

品列表的

Body

result

object (object)

结果。

可选

items

array[object (object) {7}]

品列表的。

可选

last_id

string

可选

页面上最后一个值的ID。

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

total

integer <int32>

品牌总数。

可选

示例

{
    "result": {
        "items": [
            {
                "archived": true,
                "has_fbo_stocks": true,
                "has_fbs_stocks": true,
                "is_discounted": true,
                "offer_id": "136748",
                "product_id": 223681945,
                "quants": [
                    {
                        "quant_code": "string",
                        "quant_size": 0
                    }
                ]
            }
        ],
        "total": 1,
        "last_id": "bnVсbA=="
    }
}

🟠400请求有误

🟠403禁止访问

🟠404记录不存在

🟠409409

🔴500服务器错误