Lingxing
切换旧版

查询Ozon在线商品

POST/basicOpen/multiplatform/ozon/list

查询Ozon在线商品列表，对应系统【在线商品】>【多平台】>【Ozon】数据

接口信息

API Path请求协议请求方式令牌桶容量
/basicOpen/multiplatform/ozon/listHTTPSPOST1

请求参数

principalUidsarray<any>
负责人用户ID列表；传[-1]表示仅查询未分配负责人，-1不能与其他UID混传
offsetinteger
偏移量，默认0
lengthinteger
每页数量，默认20，最大1000
storeIdsarray<any>
店铺ID列表
pairingStatusinteger
配对状态：
0=未配对
1=已配对
searchSingleValuestring
搜索值（单个）
searchValuesarray<any>
搜索值列表（精确搜索）
searchFieldinteger
搜索字段：
1=MSKU
2=MSKU ID
3=本地SKU
4=品名
5=标题
sortTypestring
排序方式：asc/desc
sortFieldstring
排序字段
categoryIdsarray<any>
分类ID列表
brandIdsarray<any>
品牌ID列表
statusListarray<any>
商品状态：
ON_SALE
READY_TO_SELL
DECLINED
ARCHIVED
timeFieldinteger
时间字段
startTimestring
开始时间
endTimestring
结束时间

请求cURL示例

curl --location 'https://openapi.lingxing.com/basicOpen/multiplatform/ozon/list?access_token=value&timestamp=value&sign=value&app_key=value' \
--header 'Content-Type: application/json' \
--data '{
    "offset": 0,
    "length": 20,
    "principalUids": [10001],
    "storeIds": [1, 2],
    "searchField": 1,
    "searchSingleValue": "商品A",
    "statusList": ["ON_SALE"]
}'

返回结果

Json Object

codeinteger必填
状态码，0：成功
示例 0
messagestring必填
消息提示
示例 success
error_detailsarray<any>必填
数据校验失败时的错误详情
request_idstring必填
请求链路id
示例 a0d54debf93140f3b58d1ed81e8e3583
response_timestring必填
响应时间
示例 2026-07-14 12:00:00
dataobject必填
响应数据
隐藏子属性
countinteger必填
总数
示例 30
listarray<object>必填
列表数据
隐藏子属性
principalUidsarray<any>
负责人用户ID列表
示例 [10001]
principalNamestring
负责人名称
示例 张三
performanceUidinteger
业绩归属人用户ID
示例 10002
performanceNamestring
业绩归属人名称
示例 李四
idinteger必填
ID
示例 1
productUniqueIdinteger必填
商品唯一ID
示例 10001
variantUniqueIdinteger必填
变体唯一ID
示例 20001
mskuIdstring必填
MSKU ID
示例 MSKU001
mskustring必填
MSKU
示例 msku-test
titlestring必填
标题
示例 示例商品标题
imgUrlstring必填
图片链接
示例 https://img.example.com/1.jpg
statusstring必填
状态
示例 ON_SALE
statusNamestring必填
状态名称
示例 在售
pricenumber必填
价格
示例 1500
currencystring必填
货币
示例 RUB
currencyIconstring必填
货币符号
示例 ₽
inventoryinteger必填
库存
示例 100
createTimestring必填
创建时间
示例 2026-01-01 10:00:00
updateTimestring必填
更新时间
示例 2026-01-05 10:00:00
storeIdinteger必填
店铺ID
示例 1
storeNamestring必填
店铺名称
示例 我的店铺
pnamestring必填
品名
示例 商品A
skustring必填
SKU
示例 SKU001
pidinteger必填
本地商品ID
示例 1001
totalinteger必填
总数
示例 30

返回成功示例

{
    "code": 0,
    "message": "success",
    "error_details": [],
    "request_id": "a0d54debf93140f3b58d1ed81e8e3583",
    "response_time": "2026-07-14 12:00:00",
    "data": {
        "count": 30,
        "list": [
            {
                "id": 1,
                "productUniqueId": 10001,
                "principalUids": [10001],
                "principalName": "张三",
                "performanceUid": 10002,
                "performanceName": "李四",
                "variantUniqueId": 20001,
                "mskuId": "MSKU001",
                "msku": "msku-test",
                "title": "示例商品标题",
                "imgUrl": "https://img.example.com/1.jpg",
                "status": "ON_SALE",
                "statusName": "在售",
                "price": 1500.00,
                "currency": "RUB",
                "currencyIcon": "₽",
                "inventory": 100,
                "createTime": "2026-01-01 10:00:00",
                "updateTime": "2026-01-05 10:00:00",
                "storeId": 1,
                "storeName": "我的店铺",
                "pname": "商品A",
                "sku": "SKU001",
                "pid": 1001
            }
        ]
    },
    "total": 30
}