Lingxing
切换旧版

查询OTTO在线商品

POST/basicOpen/multiplatform/otto/list

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

接口信息

API Path请求协议请求方式令牌桶容量
/basicOpen/multiplatform/otto/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=spuId(商品ID)
3=moin
4=sku
5=品名
6=标题
sortTypestring
排序方式：asc/desc
sortFieldstring
排序字段
categoryIdsarray<any>
分类ID列表
brandIdsarray<any>
品牌ID列表
platformStatusarray<any>
平台状态：active/inactive

请求cURL示例

curl --location 'https://openapi.lingxing.com/basicOpen/multiplatform/otto/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",
    "platformStatus": ["active"]
}'

返回结果

Json Object

codeinteger必填
状态码，0：成功
示例 0
messagestring必填
消息提示
示例 success
error_detailsarray<any>必填
数据校验失败时的错误详情
request_idstring必填
请求链路id
示例 a0d54debf93140f3b58d1ed81e8e3583
response_timestring必填
响应时间
示例 2026-07-14 12:00:00
dataobject必填
响应数据
隐藏子属性
countinteger必填
总数
示例 20
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
platformStatusstring必填
平台状态
示例 active
platformStatusDisplaystring必填
平台状态显示名称
示例 在售
spuIdstring必填
SPU ID
示例 SPU001
moinstring必填
MOIN
示例 MOIN001
eanstring必填
EAN
示例 1234567890123
standardPricenumber必填
标准价格
示例 59.99
salePricenumber必填
售价
示例 49.99
currencystring必填
货币
示例 EUR
currencyIconstring必填
货币符号
示例 €
usableInventoryinteger必填
可用库存
示例 100
saleDateStartstring必填
售卖开始时间
示例 2026-01-01
saleDateEndstring必填
售卖结束时间
示例 2026-12-31
storeIdinteger必填
店铺ID
示例 1
storeNamestring必填
店铺名称
示例 我的店铺
pnamestring必填
品名
示例 商品A
skustring必填
SKU
示例 SKU001
pidinteger必填
本地商品ID
示例 1001
totalinteger必填
总数
示例 20

返回成功示例

{
    "code": 0,
    "message": "success",
    "error_details": [],
    "request_id": "a0d54debf93140f3b58d1ed81e8e3583",
    "response_time": "2026-07-14 12:00:00",
    "data": {
        "count": 20,
        "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",
                "platformStatus": "active",
                "platformStatusDisplay": "在售",
                "spuId": "SPU001",
                "moin": "MOIN001",
                "ean": "1234567890123",
                "standardPrice": 59.99,
                "salePrice": 49.99,
                "currency": "EUR",
                "currencyIcon": "€",
                "usableInventory": 100,
                "saleDateStart": "2026-01-01",
                "saleDateEnd": "2026-12-31",
                "storeId": 1,
                "storeName": "我的店铺",
                "pname": "商品A",
                "sku": "SKU001",
                "pid": 1001
            }
        ]
    },
    "total": 20
}