轻易云
注册体验

领星ERP查询AliExpress在线商品 - 托管模式接口

所属平台
领星ERP
类型
WebAPI
作用
QUERY
接口版本
1.0
适配器
\Adapter\LingXing\LXQueryAdapter
授权方式
OTHER
描述
多平台 · POST · 请求参数 25 个(必填 0) · 响应参数 77 个 · 限流令牌桶容量 1
更新日期
2026-11-21

查询AliExpress在线商品 - 托管模式

POST/basicOpen/multiplatform/aliexpress/list/v2
加工厂
{
  "operation": {
    "method": "POST",
    "path": "/basicOpen/multiplatform/aliexpress/list/v2"
  },
  "protocol": "HTTPS",
  "host": "https://openapi.lingxing.com",
  "rateLimit": {
    "tokenBucketCapacity": 1,
    "text": ""
  },
  "requestExample": "curl --location 'https://openapi.lingxing.com/basicOpen/multiplatform/aliexpress/list/v2?access_token=value&timestamp=value&sign=value&app_key=value' \\\n--header 'Content-Type: application/json' \\\n--data '{\n    \"isParent\": 1,\n    \"length\": 20,\n    \"brandIds\": [1001,1002],\n    \"categoryIds\": [2001,2002],\n    \"end\": \"2024-12-31\",\n    \"offset\": 0,\n    \"pairingStatus\": 1,\n    \"platformCodeList\": [\"aliexpress\"],\n    \"price\": 100,\n    \"priceCondition\": 1,\n    \"principalUids\": [3001,3002],\n    \"productTypeList\": [0,1],\n    \"productUniqueId\": 1234567890,\n    \"productUniqueIdList\": [9876543210],\n    \"quantity\": 100,\n    \"quantityCondition\": 1,\n    \"searchField\": 1,\n    \"searchSingleValue\": \"MSKU001\",\n    \"searchValues\": [\"SKU001\",\"SKU002\"],\n    \"sortField\": \"createTime\",\n    \"sortType\": \"desc\",\n    \"start\": \"2024-01-01\",\n    \"statusList\": [\"S1\",\"S2\"],\n    \"storeIds\": [1234567890],\n    \"storeType\": 全托管\n}'",
  "responseExample": {
    "code": 0,
    "data": {
      "count": 100,
      "list": [
        {
          "attributeName": "颜色;尺寸",
          "attributeValue": "红色;L码",
          "attributes": "{\"color\":\"red\",\"size\":\"L\"}",
          "autoRestock": "1",
          "bid": 6666666666,
          "bname": "自有品牌",
          "cid": 5555555555,
          "cname": "电子产品",
          "companyId": 7777777777,
          "createTime": "2024-01-15 10:30:00",
          "currencyCode": "USD",
          "day30SaleCnt": 150,
          "day7SaleCnt": 35,
          "effectiveSupplyPrice": "59.99",
          "extJson": "{\"warehouse1\":100}",
          "hasList": 1,
          "id": 100001,
          "imageUrls": "",
          "inventoryQuantity": 500,
          "isDelete": "value",
          "itemId": "ITEM123456",
          "mode": "仓发",
          "model": "MODEL-2024",
          "msku": "MSKU-001",
          "mskuId": "9876543210",
          "notes": "热销商品",
          "pid": 1234567890,
          "platformCode": "aliexpress",
          "platformName": "速卖通",
          "pname": "蓝牙耳机",
          "price": 99990000,
          "principalName": "张三",
          "principalUids": "[3001,3002]",
          "productId": "32987654321",
          "productType": 0,
          "productTypeName": "仓发",
          "productUniqueId": 1234567890,
          "quantitySyn": {
            "after": "500",
            "before": "450",
            "quantitySynWareHouses": [
              {
                "after": "200",
                "before": "180",
                "uid": 9002,
                "userName": "王五",
                "wareHouseName": "广州仓"
              }
            ],
            "type": 1,
            "uid": 9001,
            "userName": "李四"
          },
          "sku": "SKU-AE-001",
          "skuImage": "",
          "status": 2,
          "statusName": "可售",
          "storeId": 8888888888,
          "storeName": "我的速卖通店铺",
          "supplyPriceList": [
            {
              "beginStr": "2024-01-01",
              "currency": "USD",
              "endStr": "2024-12-31",
              "price": 49.99
            }
          ],
          "title": "Wireless Bluetooth Headphones",
          "uniqueId": "UNI123456",
          "variantUniqueId": "VAR123456",
          "wareHouseDataList": [
            {
              "quantity": 200,
              "warehouseId": "WH001",
              "warehouseName": "深圳仓"
            }
          ],
          "warehouseStock": "450"
        }
      ]
    },
    "error_details": [],
    "message": "value",
    "request_id": "value",
    "response_time": "value",
    "total": 1
  }
}

接口请求参数

序号字段名称类型默认值必填描述
1isParent是否父体integer—可选是否父体,必填,枚举值:1-父体, 0-子体
2length分页长度integer—可选分页长度,必填,每页条数
3brandIds品牌ID列表array<any>—可选品牌ID列表
4categoryIds分类ID列表array<any>—可选分类ID列表,如果选了父分类,要把父分类以及其下所有子分类传进来
5end结束时间string—可选结束时间,格式:yyyy-MM-dd
6offset分页偏移量integer—可选分页偏移量,必填,从0开始
7pairingStatus配对状态integer—可选配对状态,枚举值:0-未配对, 1-配对, null-全部
8platformCodeList平台编码列表array<any>—可选平台编码列表
9price供货价金额integer—可选供货价金额
10priceCondition供货价金额筛选条件integer—可选供货价金额筛选条件,枚举值:1-大于, 2-小于
11principalUids商品负责人UID列表array<any>—可选商品负责人UID列表
12productTypeList发货模式列表array<any>—可选发货模式列表,枚举值:0-仓发, 1-JIT, 2-海外备仓
13productUniqueId商品全局唯一IDinteger—可选商品全局唯一ID
14productUniqueIdList父体唯一ID列表array<any>—可选父体唯一ID列表
15quantity库存数integer—可选库存数
16quantityCondition库存筛选条件integer—可选库存筛选条件,枚举值:1-大于, 2-小于
17searchField搜索类型integer—可选搜索类型,枚举值:1-msku, 2-商品ID, 3-SKU, 4-品名, 5-SKU, 6-品名, 7-标题
18searchSingleValue搜索值string—可选搜索值,单个模糊搜索
19searchValues搜索值array<any>—可选搜索值,数组,多个精确搜索
20sortField排序字段string—可选排序字段,直接传返参的字段名
21sortType排序类型string—可选排序类型,枚举值:asc-升序, desc-降序
22start开始时间string—可选开始时间,格式:yyyy-MM-dd
23statusList状态列表array<any>—可选状态列表,枚举值:S1-待售, S2-可售
24storeIds店铺ID列表array<any>—可选店铺ID列表
25storeType店铺类型integer—可选店铺类型,枚举值:半托管, 全托管, 海外托管

接口响应参数

序号字段名称类型默认值必填描述
1code响应码integer—必填响应码
2data返回数据object—必填返回数据
2.1count总条数integer100必填总条数
2.2list商品详细信息列表array<object>—必填商品详细信息列表
2.2.1attributeName变体属性名string颜色;尺寸可选变体属性名
2.2.2attributeValue变体属性值string红色;L码可选变体属性值
2.2.3attributes变体属性JSONstring{"color":"red","size":"L"}可选变体属性JSON
2.2.4autoRestock是否自动补货boolean1可选是否自动补货,枚举值:0-无补货规则, 1-启用, 2-停用
2.2.5bid品牌IDinteger6666666666可选品牌ID
2.2.6bname品牌名称string自有品牌可选品牌名称
2.2.7cid分类IDinteger5555555555可选分类ID,0代表没分类
2.2.8cname分类名称string电子产品可选分类名称
2.2.9companyId企业IDinteger7777777777可选企业ID
2.2.10createTimelisting创建时间string2024-01-15 10:30:00可选listing创建时间,北京时间
2.2.11currencyCode子体货币代码stringUSD可选子体货币代码
2.2.12day30SaleCnt30天销量integer150可选30天销量
2.2.13day7SaleCnt7天销量integer35可选7天销量
2.2.14effectiveSupplyPrice子体有效供货价string59.99可选子体有效供货价
2.2.15extJson仓库详情JSON字符串string{"warehouse1":100}可选仓库详情JSON字符串
2.2.16hasList是否多子体integer1可选是否多子体,枚举值:1-多子体, 2-单子体
2.2.17id记录IDinteger100001可选记录ID
2.2.18imageUrls父体图片URLstring—可选父体图片URL
2.2.19inventoryQuantity仓库总库存数integer500可选仓库总库存数
2.2.20isDelete是否删除boolean—可选是否删除,枚举值:0-否, 1-是
2.2.21itemId货品IDstringITEM123456可选货品ID
2.2.22mode发货模式string仓发可选发货模式
2.2.23model本地SKU型号stringMODEL-2024可选本地SKU型号
2.2.24msku变体MSKUstringMSKU-001可选变体MSKU
2.2.25mskuId变体MSKU IDstring9876543210可选变体MSKU ID
2.2.26notes备注string热销商品可选备注
2.2.27pid本地产品IDinteger1234567890可选本地产品ID
2.2.28platformCode平台编号stringaliexpress可选平台编号
2.2.29platformName平台名称string速卖通可选平台名称
2.2.30pname品名string蓝牙耳机可选品名
2.2.31price价格integer99990000可选价格,单位分,需除以100万
2.2.32principalName商品负责人名称string张三可选商品负责人名称
2.2.33principalUids商品负责人UID列表array<any>[3001,3002]可选商品负责人UID列表
2.2.34productId平台商品IDstring32987654321可选平台商品ID
2.2.35productType发货模式integer0可选发货模式,枚举值:0-仓发, 1-JIT, 2-海外备仓
2.2.36productTypeName发货模式名称string仓发可选发货模式名称
2.2.37productUniqueId平台商品在listing的唯一IDinteger1234567890可选平台商品在listing的唯一ID
2.2.38quantitySyn库存同步中信息object—可选库存同步中信息,null代表不在同步中
2.2.38.1after调整后的值string500可选调整后的值
2.2.38.2before调整前的值string450可选调整前的值
2.2.38.3quantitySynWareHouses仓库同步详情array<object>—可选仓库同步详情,当type=2时取该列表
2.2.38.3.1after调整后的值string200可选调整后的值
2.2.38.3.2before调整前的值string180可选调整前的值
2.2.38.3.3uid操作人IDinteger9002可选操作人ID
2.2.38.3.4userName操作人名称string王五可选操作人名称
2.2.38.3.5wareHouseName仓库名称string广州仓可选仓库名称
2.2.38.4type库存队列类型integer1可选库存队列类型,枚举值:1-单条库存(取同级字段), 2-仓库列表(取quantitySynWareHouses)
2.2.38.5uid操作人IDinteger9001可选操作人ID
2.2.38.6userName操作人名称string李四可选操作人名称
2.2.39skuSKU编码stringSKU-AE-001可选SKU编码
2.2.40skuImage变体图片地址string—可选变体图片地址
2.2.41status状态integer2可选状态
2.2.42statusName状态名称string可售可选状态名称
2.2.43storeId店铺IDinteger8888888888可选店铺ID
2.2.44storeName店铺名称string我的速卖通店铺可选店铺名称
2.2.45supplyPriceList供货价列表array<object>—可选供货价列表
2.2.45.1beginStr时间开始string2024-01-01可选时间开始,前端展示
2.2.45.2currency币种stringUSD可选币种
2.2.45.3endStr时间结束string2024-12-31可选时间结束,null代表至今,前端展示
2.2.45.4price金额number49.99可选金额
2.2.46title商品标题stringWireless Bluetooth Headphones可选商品标题
2.2.47uniqueId唯一IDstringUNI123456可选唯一ID
2.2.48variantUniqueId变体唯一IDstringVAR123456可选变体唯一ID
2.2.49wareHouseDataList仓库详情列表array<object>—可选仓库详情列表
2.2.49.1quantity库存数量integer200可选库存数量
2.2.49.2warehouseId仓库唯一IDstringWH001可选仓库唯一ID
2.2.49.3warehouseName仓库名称string深圳仓可选仓库名称
2.2.50warehouseStock仓库库存string450可选仓库库存
3error_details错误详情array<any>—必填错误详情
4message提示信息string—必填提示信息
5request_id请求idstring—必填请求id
6response_time响应时间string—必填响应时间
7total总记录数integer—必填总记录数

领星ERP的接口:查询AliExpress在线商品 - 托管模式(/basicOpen/multiplatform/aliexpress/list/v2),由轻易云数据集成平台 API 资产管理模块整理收纳,并随领星ERP版本更新同步更新。

需要对接这个接口?

轻易云已预置该接口的适配能力,联系我们即可开始配置数据集成。