Lingxing
切换旧版

查询Rakuten在线商品

POST/basicOpen/multiplatform/rakuten/list

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

接口信息

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

请求参数

principalUidsarray<any>
负责人用户ID列表；传[-1]表示仅查询未分配负责人，-1不能与其他UID混传
offsetinteger
偏移量，默认0
lengthinteger
每页数量，默认20，最大1000
storeIdsarray<any>
店铺ID列表
pairingStatusinteger
配对状态：
0=未配对
1=已配对
searchSingleValuestring
搜索值（单个）
searchValuesarray<any>
搜索值列表（精确搜索）
searchFieldinteger
搜索字段：
1=变体ID
2=标题
3=父体/manageNumber
4=商品番号
5=MSKU
6=SKU
7=品名
sortTypestring
排序方式：asc/desc
sortFieldstring
排序字段
categoryIdsarray<any>
分类ID列表
brandIdsarray<any>
品牌ID列表
siteCodestring
站点代码：JP=日本站
statusListarray<any>
状态：
1=在售
2=仓库
0=已删除
timeFieldinteger
时间字段
startTimestring
开始时间
endTimestring
结束时间
priceValuenumber
价格值
priceOpstring
价格比较操作符
referencePriceValuenumber
参考价格值
referencePriceOpstring
参考价格比较操作符
inventoryValueinteger
库存值
inventoryOpstring
库存比较操作符

请求cURL示例

curl --location 'https://openapi.lingxing.com/basicOpen/multiplatform/rakuten/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": 5,
    "searchSingleValue": "商品A",
    "siteCode": "JP",
    "statusList": [1]
}'

返回结果

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
rowTypestring必填
行类型
示例 parent
manageNumberstring必填
管理番号
示例 MNG001
itemNumberstring必填
商品番号
示例 ITEM001
mskuIdstring必填
MSKU ID
示例 MSKU001
mskustring必填
MSKU
示例 msku-test
titlestring必填
标题
示例 示例商品标题
imgUrlstring必填
图片链接
示例 https://img.example.com/1.jpg
statusstring必填
状态
示例 1
statusNamestring必填
状态名称
示例 在售
siteCodestring必填
站点代码
示例 JP
pricenumber必填
价格
示例 5980
referencePricenumber必填
参考价格
示例 7980
currencystring必填
货币
示例 JPY
currencyIconstring必填
货币符号
示例 ¥
inventoryinteger必填
库存
示例 50
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
childrenarray<any>必填
子体列表
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,
                "rowType": "parent",
                "manageNumber": "MNG001",
                "itemNumber": "ITEM001",
                "mskuId": "MSKU001",
                "msku": "msku-test",
                "title": "示例商品标题",
                "imgUrl": "https://img.example.com/1.jpg",
                "status": "1",
                "statusName": "在售",
                "siteCode": "JP",
                "price": 5980,
                "referencePrice": 7980,
                "currency": "JPY",
                "currencyIcon": "¥",
                "inventory": 50,
                "createTime": "2026-01-01 10:00:00",
                "updateTime": "2026-01-05 10:00:00",
                "storeId": 1,
                "storeName": "我的店铺",
                "pname": "商品A",
                "sku": "SKU001",
                "pid": 1001,
                "children": []
            }
        ]
    },
    "total": 20
}