Qeasy Cloud
Get Started

领星ERP 查询Rakuten在线商品 API

Platform
领星ERP
Type
WebAPI
Effect
QUERY
API Version
1.0
Adapter
\Adapter\LingXing\LXQueryAdapter
Auth Mode
OTHER
Description
多平台 · POST · 请求参数 23 个(必填 0) · 响应参数 39 个 · 限流令牌桶容量 1
Updated At
2026-11-21

查询Rakuten在线商品

POST/basicOpen/multiplatform/rakuten/list
Factory
{
  "operation": {
    "method": "POST",
    "path": "/basicOpen/multiplatform/rakuten/list"
  },
  "protocol": "HTTPS",
  "host": "https://openapi.lingxing.com",
  "rateLimit": {
    "tokenBucketCapacity": 1,
    "text": ""
  },
  "requestExample": "curl --location 'https://openapi.lingxing.com/basicOpen/multiplatform/rakuten/list?access_token=value&timestamp=value&sign=value&app_key=value' \\\n--header 'Content-Type: application/json' \\\n--data '{\n    \"offset\": 0,\n    \"length\": 20,\n    \"principalUids\": [10001],\n    \"storeIds\": [1, 2],\n    \"searchField\": 5,\n    \"searchSingleValue\": \"商品A\",\n    \"siteCode\": \"JP\",\n    \"statusList\": [1]\n}'",
  "responseExample": {
    "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
  }
}

Request Parameters

No.FieldNameTypeDefaultRequiredDescription
1principalUids负责人用户ID列表array<any>—Optional负责人用户ID列表;传[-1]表示仅查询未分配负责人,-1不能与其他UID混传
2offset偏移量integer—Optional偏移量,默认0
3length每页数量integer—Optional每页数量,默认20,最大1000
4storeIds店铺ID列表array<any>—Optional店铺ID列表
5pairingStatus配对状态integer—Optional配对状态: 0=未配对 1=已配对
6searchSingleValue搜索值(单个)string—Optional搜索值(单个)
7searchValues搜索值列表(精确搜索)array<any>—Optional搜索值列表(精确搜索)
8searchField搜索字段integer—Optional搜索字段: 1=变体ID 2=标题 3=父体/manageNumber 4=商品番号 5=MSKU 6=SKU 7=品名
9sortType排序方式string—Optional排序方式:asc/desc
10sortField排序字段string—Optional排序字段
11categoryIds分类ID列表array<any>—Optional分类ID列表
12brandIds品牌ID列表array<any>—Optional品牌ID列表
13siteCode站点代码string—Optional站点代码:JP=日本站
14statusList状态array<any>—Optional状态: 1=在售 2=仓库 0=已删除
15timeField时间字段integer—Optional时间字段
16startTime开始时间string—Optional开始时间
17endTime结束时间string—Optional结束时间
18priceValue价格值number—Optional价格值
19priceOp价格比较操作符string—Optional价格比较操作符
20referencePriceValue参考价格值number—Optional参考价格值
21referencePriceOp参考价格比较操作符string—Optional参考价格比较操作符
22inventoryValue库存值integer—Optional库存值
23inventoryOp库存比较操作符string—Optional库存比较操作符

Response Parameters

No.FieldNameTypeDefaultRequiredDescription
1code状态码integer0Required状态码,0:成功
2message消息提示stringsuccessRequired消息提示
3error_details数据校验失败时的错误详情array<any>—Required数据校验失败时的错误详情
4request_id请求链路idstringa0d54debf93140f3b58d1ed81e8e3583Required请求链路id
5response_time响应时间string2026-07-14 12:00:00Required响应时间
6data响应数据object—Required响应数据
6.1count总数integer20Required总数
6.2list列表数据array<object>—Required列表数据
6.2.1principalUids负责人用户ID列表array<any>[10001]Optional负责人用户ID列表
6.2.2principalName负责人名称string张三Optional负责人名称
6.2.3performanceUid业绩归属人用户IDinteger10002Optional业绩归属人用户ID
6.2.4performanceName业绩归属人名称string李四Optional业绩归属人名称
6.2.5ididinteger1RequiredID
6.2.6productUniqueId商品唯一IDinteger10001Required商品唯一ID
6.2.7variantUniqueId变体唯一IDinteger20001Required变体唯一ID
6.2.8rowType行类型stringparentRequired行类型
6.2.9manageNumber管理番号stringMNG001Required管理番号
6.2.10itemNumber商品番号stringITEM001Required商品番号
6.2.11mskuIdMSKU IDstringMSKU001RequiredMSKU ID
6.2.12mskumskustringmsku-testRequiredMSKU
6.2.13title标题string示例商品标题Required标题
6.2.14imgUrl图片链接stringhttps://img.example.com/1.jpgRequired图片链接
6.2.15status状态string1Required状态
6.2.16statusName状态名称string在售Required状态名称
6.2.17siteCode站点代码stringJPRequired站点代码
6.2.18price价格number5980Required价格
6.2.19referencePrice参考价格number7980Required参考价格
6.2.20currency货币stringJPYRequired货币
6.2.21currencyIcon货币符号string¥Required货币符号
6.2.22inventory库存integer50Required库存
6.2.23createTime创建时间string2026-01-01 10:00:00Required创建时间
6.2.24updateTime更新时间string2026-01-05 10:00:00Required更新时间
6.2.25storeId店铺IDinteger1Required店铺ID
6.2.26storeName店铺名称string我的店铺Required店铺名称
6.2.27pname品名string商品ARequired品名
6.2.28skuskustringSKU001RequiredSKU
6.2.29pid本地商品IDinteger1001Required本地商品ID
6.2.30children子体列表array<any>—Required子体列表
7total总数integer20Required总数

The 查询Rakuten在线商品 API (/basicOpen/multiplatform/rakuten/list) of 领星ERP is curated by the API asset management module of the Qeasy Cloud data integration platform and kept in sync with 领星ERP version updates.

Need to integrate this API?

Qeasy ships with prebuilt adaptation for this API — contact us to start configuring data integration.