Lingxing
切换旧版

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

POST/basicOpen/multiplatform/aliexpress/list/v2

支持查询aliexpress-托管模式在线商品

接口信息

API Path请求协议请求方式令牌桶容量
/basicOpen/multiplatform/aliexpress/list/v2HTTPSPOST1

请求参数

isParentinteger
是否父体,必填,枚举值:1-父体, 0-子体
lengthinteger
分页长度,必填,每页条数
brandIdsarray<any>
品牌ID列表
categoryIdsarray<any>
分类ID列表,如果选了父分类,要把父分类以及其下所有子分类传进来
endstring
结束时间,格式:yyyy-MM-dd
offsetinteger
分页偏移量,必填,从0开始
pairingStatusinteger
配对状态,枚举值:0-未配对, 1-配对, null-全部
platformCodeListarray<any>
平台编码列表
priceinteger
供货价金额
priceConditioninteger
供货价金额筛选条件,枚举值:1-大于, 2-小于
principalUidsarray<any>
商品负责人UID列表
productTypeListarray<any>
发货模式列表,枚举值:0-仓发, 1-JIT, 2-海外备仓
productUniqueIdinteger
商品全局唯一ID
productUniqueIdListarray<any>
父体唯一ID列表
quantityinteger
库存数
quantityConditioninteger
库存筛选条件,枚举值:1-大于, 2-小于
searchFieldinteger
搜索类型,枚举值:1-msku, 2-商品ID, 3-SKU, 4-品名, 5-SKU, 6-品名, 7-标题
searchSingleValuestring
搜索值,单个模糊搜索
searchValuesarray<any>
搜索值,数组,多个精确搜索
sortFieldstring
排序字段,直接传返参的字段名
sortTypestring
排序类型,枚举值:asc-升序, desc-降序
startstring
开始时间,格式:yyyy-MM-dd
statusListarray<any>
状态列表,枚举值:S1-待售, S2-可售
storeIdsarray<any>
店铺ID列表
storeTypeinteger
店铺类型,枚举值:半托管, 全托管, 海外托管

请求cURL示例

curl --location 'https://openapi.lingxing.com/basicOpen/multiplatform/aliexpress/list/v2?access_token=value&timestamp=value&sign=value&app_key=value' \
--header 'Content-Type: application/json' \
--data '{
    "isParent": 1,
    "length": 20,
    "brandIds": [1001,1002],
    "categoryIds": [2001,2002],
    "end": "2024-12-31",
    "offset": 0,
    "pairingStatus": 1,
    "platformCodeList": ["aliexpress"],
    "price": 100,
    "priceCondition": 1,
    "principalUids": [3001,3002],
    "productTypeList": [0,1],
    "productUniqueId": 1234567890,
    "productUniqueIdList": [9876543210],
    "quantity": 100,
    "quantityCondition": 1,
    "searchField": 1,
    "searchSingleValue": "MSKU001",
    "searchValues": ["SKU001","SKU002"],
    "sortField": "createTime",
    "sortType": "desc",
    "start": "2024-01-01",
    "statusList": ["S1","S2"],
    "storeIds": [1234567890],
    "storeType": 全托管
}'

返回结果

Json Object

codeinteger必填
响应码
dataobject必填
返回数据
隐藏子属性
countinteger必填
总条数
示例 100
listarray<object>必填
商品详细信息列表
隐藏子属性
attributeNamestring
变体属性名
示例 颜色;尺寸
attributeValuestring
变体属性值
示例 红色;L码
attributesstring
变体属性JSON
示例 {"color":"red","size":"L"}
autoRestockboolean
是否自动补货,枚举值:0-无补货规则, 1-启用, 2-停用
示例 1
bidinteger
品牌ID
示例 6666666666
bnamestring
品牌名称
示例 自有品牌
cidinteger
分类ID,0代表没分类
示例 5555555555
cnamestring
分类名称
示例 电子产品
companyIdinteger
企业ID
示例 7777777777
createTimestring
listing创建时间,北京时间
示例 2024-01-15 10:30:00
currencyCodestring
子体货币代码
示例 USD
day30SaleCntinteger
30天销量
示例 150
day7SaleCntinteger
7天销量
示例 35
effectiveSupplyPricestring
子体有效供货价
示例 59.99
extJsonstring
仓库详情JSON字符串
示例 {"warehouse1":100}
hasListinteger
是否多子体,枚举值:1-多子体, 2-单子体
示例 1
idinteger
记录ID
示例 100001
imageUrlsstring
父体图片URL
inventoryQuantityinteger
仓库总库存数
示例 500
isDeleteboolean
是否删除,枚举值:0-否, 1-是
itemIdstring
货品ID
示例 ITEM123456
modestring
发货模式
示例 仓发
modelstring
本地SKU型号
示例 MODEL-2024
mskustring
变体MSKU
示例 MSKU-001
mskuIdstring
变体MSKU ID
示例 9876543210
notesstring
备注
示例 热销商品
pidinteger
本地产品ID
示例 1234567890
platformCodestring
平台编号
示例 aliexpress
platformNamestring
平台名称
示例 速卖通
pnamestring
品名
示例 蓝牙耳机
priceinteger
价格,单位分,需除以100万
示例 99990000
principalNamestring
商品负责人名称
示例 张三
principalUidsarray<any>
商品负责人UID列表
示例 [3001,3002]
productIdstring
平台商品ID
示例 32987654321
productTypeinteger
发货模式,枚举值:0-仓发, 1-JIT, 2-海外备仓
示例 0
productTypeNamestring
发货模式名称
示例 仓发
productUniqueIdinteger
平台商品在listing的唯一ID
示例 1234567890
quantitySynobject
库存同步中信息,null代表不在同步中
隐藏子属性
afterstring
调整后的值
示例 500
beforestring
调整前的值
示例 450
quantitySynWareHousesarray<object>
仓库同步详情,当type=2时取该列表
隐藏子属性
afterstring
调整后的值
示例 200
beforestring
调整前的值
示例 180
uidinteger
操作人ID
示例 9002
userNamestring
操作人名称
示例 王五
wareHouseNamestring
仓库名称
示例 广州仓
typeinteger
库存队列类型,枚举值:1-单条库存(取同级字段), 2-仓库列表(取quantitySynWareHouses)
示例 1
uidinteger
操作人ID
示例 9001
userNamestring
操作人名称
示例 李四
skustring
SKU编码
示例 SKU-AE-001
skuImagestring
变体图片地址
statusinteger
状态
示例 2
statusNamestring
状态名称
示例 可售
storeIdinteger
店铺ID
示例 8888888888
storeNamestring
店铺名称
示例 我的速卖通店铺
supplyPriceListarray<object>
供货价列表
隐藏子属性
beginStrstring
时间开始,前端展示
示例 2024-01-01
currencystring
币种
示例 USD
endStrstring
时间结束,null代表至今,前端展示
示例 2024-12-31
pricenumber
金额
示例 49.99
titlestring
商品标题
示例 Wireless Bluetooth Headphones
uniqueIdstring
唯一ID
示例 UNI123456
variantUniqueIdstring
变体唯一ID
示例 VAR123456
wareHouseDataListarray<object>
仓库详情列表
隐藏子属性
quantityinteger
库存数量
示例 200
warehouseIdstring
仓库唯一ID
示例 WH001
warehouseNamestring
仓库名称
示例 深圳仓
warehouseStockstring
仓库库存
示例 450
error_detailsarray<any>必填
错误详情
messagestring必填
提示信息
request_idstring必填
请求id
response_timestring必填
响应时间
totalinteger必填
总记录数

返回成功示例

{
  "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
}