Lingxing
切换旧版

多平台 - 查询Line在线商品

POST/basicOpen/multiplatform/line/list

支持多平台-查询Line在线商品

接口信息

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

请求参数

isParentinteger
是否父体,枚举值:1-父体, 0-子体
availableNumberstring
可用库存数,用于库存筛选
availableNumberConditioninteger
库存筛选条件,枚举值:1-大于, 2-小于
brandIdsarray<any>
品牌ID列表
categoryIdsarray<any>
分类ID列表,如果选了父分类,要把父分类以及其下所有子分类传进来
lengthinteger
分页长度,每页条数,最大200
offsetinteger
分页偏移量,从0开始
pairingStatusinteger
配对状态,枚举值:0-未配对, 1-配对, null-全部
parentUniqueIdsarray<any>
父体全局唯一ID列表
pricestring
金额,用于价格筛选
priceConditioninteger
金额筛选条件,枚举值:1-大于, 2-小于
principalUidsarray<any>
商品负责人UID列表
productUniqueIdinteger
商品全局唯一ID
searchFieldstring
搜索类型,枚举值:1-msku, 2-msku ID, 3-SKU, 4-品名
searchSingleValuestring
搜索值,单个模糊搜索,字符串类型
searchValuesarray<any>
搜索值,数组类型,多个精确搜索
sortFieldstring
排序字段,直接传返参的字段名
sortTypestring
排序类型,枚举值:asc-升序, desc-降序
statusListarray<any>
状态列表,枚举值:0-正常, 1-已删除
storeIdsarray<any>
店铺ID列表

请求cURL示例

curl --location 'https://openapi.lingxing.com/basicOpen/multiplatform/line/list?access_token=value&timestamp=value&sign=value&app_key=value' \
--header 'Content-Type: application/json' \
--data '{
    "isParent": 1,
    "availableNumber": "50",
    "availableNumberCondition": 1,
    "brandIds": [1001,1002],
    "categoryIds": [2001,2002],
    "length": 20,
    "offset": 0,
    "pairingStatus": 1,
    "parentUniqueIds": [3001,3002],
    "price": "100.5",
    "priceCondition": 1,
    "principalUids": [4001,4002],
    "productUniqueId": 9876543210123456,
    "searchField": "1",
    "searchSingleValue": "测试商品",
    "searchValues": ["SKU001","SKU002"],
    "sortField": "price",
    "sortType": "desc",
    "statusList": ["0","1"],
    "storeIds": [1234567890123456,1234567890123457]
}'

返回结果

Json Object

codeinteger必填
响应码
dataobject必填
返回数据
隐藏子属性
countinteger必填
总条数
示例 100
listarray<object>必填
商品详细信息列表
隐藏子属性
attributesstring必填
变体属性
示例 颜色:红色;尺寸:L
availableNumberinteger必填
可用库存数
示例 100
bidinteger必填
品牌ID
示例 1234567890123456
bnamestring
品牌名称
示例 Nike
categorystring必填
分类名称
示例 服装
childrenarray<object>必填
子体商品列表
隐藏子属性
attributesstring必填
变体属性
示例 颜色:蓝色;尺寸:M
availableNumberinteger必填
可用库存数
示例 50
bidinteger必填
品牌ID
示例 1234567890123456
categorystring必填
分类名称
示例 服装
cidinteger必填
分类ID,0代表没分类
示例 1234567890123456
companyIdinteger必填
企业ID
示例 1234567890123456
idstring必填
记录ID
示例 1002
imgUrlstring必填
商品图片URL地址
示例 https://example.com/image2.jpg
mskustring必填
MSKU,卖家自己起名的SKU
示例 MY-SKU-002
mskuIdinteger必填
平台商品ID,商品唯一标识
示例 1234567890123456
onHandNumberinteger必填
锁定库存数
示例 15
pidinteger必填
本地产品ID
示例 1234567890123456
platformCodestring必填
平台编号
示例 LINE
pnamestring必填
品名
示例 测试品名-子体
pricestring必填
商品价格
示例 49.99
productIdinteger必填
平台商品ID
示例 1234567890123456
productUniqueIdinteger必填
平台商品在listing的唯一ID
示例 9876543210123456
readyToShipNumberinteger必填
预锁库存数
示例 10
skustring必填
平台SKU
示例 LINE-SKU-002
statusinteger必填
状态,枚举值:0-正常, 1-已删除
示例 0
storeIdinteger必填
店铺ID
示例 1234567890123456
storeNamestring必填
店铺名称
示例 Line官方店铺
supplyPriceListarray<any>必填
供货价数据列表
titlestring必填
商品标题
示例 Line测试商品-子体
wareHouseDataListarray<any>必填
商品仓库详情列表
cidinteger必填
分类ID,0代表没分类
示例 1234567890123456
cnamestring
分类名称
示例 运动鞋
companyIdinteger必填
企业ID
示例 1234567890123456
day30SaleCntinteger
30天销量
示例 150
day7SaleCntinteger
7天销量
示例 50
idstring必填
记录ID
示例 1001
imgUrlstring必填
商品图片URL地址
示例 https://example.com/image.jpg
mskustring必填
MSKU,卖家自己起名的SKU
示例 MY-SKU-001
mskuIdinteger必填
平台商品ID,商品唯一标识
示例 1234567890123456
notesstring
备注信息
示例 热卖商品
onHandNumberinteger必填
锁定库存数
示例 30
pidinteger必填
本地产品ID
示例 1234567890123456
platformCodestring必填
平台编号
示例 LINE
pnamestring必填
品名
示例 测试品名
pricestring必填
商品价格
示例 99.99
principalNamestring
商品负责人名称
示例 张三
principalUidsarray<any>
商品负责人UID列表
示例 [4001,4002]
productIdinteger必填
平台商品ID
示例 1234567890123456
productUniqueIdinteger必填
平台商品在listing的唯一ID
示例 9876543210123456
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
操作人名称
示例 李四
readyToShipNumberinteger必填
预锁库存数
示例 20
skustring必填
平台SKU
示例 LINE-SKU-001
statusinteger必填
状态,枚举值:0-正常, 1-已删除
示例 0
storeIdinteger必填
店铺ID
示例 1234567890123456
storeNamestring必填
店铺名称
示例 Line官方店铺
supplyPriceListarray<any>必填
供货价数据列表
titlestring必填
商品标题
示例 Line测试商品
wareHouseDataListarray<any>必填
商品仓库详情列表
error_detailsarray<any>必填
错误详情
messagestring必填
提示信息
request_idstring必填
请求id
response_timestring必填
响应时间
totalinteger必填
总记录数

返回成功示例

{
    "code": 0,
    "message": "success",
    "error_details": [],
    "request_id": "a0d54debf93140f3b58d1ed81e8e3583.178.17255922733991817",
    "response_time": "2024-11-12 16:00:00",
    "data": {
        "list": [
            {
                "attributes": "颜色:红色;尺寸:L",
                "availableNumber": 100,
                "bid": 1234567890123456,
                "bname": "Nike",
                "category": "服装",
                "children": [
                    {
                        "attributes": "颜色:蓝色;尺寸:M",
                        "availableNumber": 50,
                        "bid": 1234567890123456,
                        "category": "服装",
                        "cid": 1234567890123456,
                        "companyId": 1234567890123456,
                        "id": "1002",
                        "imgUrl": "https://example.com/image2.jpg",
                        "msku": "MY-SKU-002",
                        "mskuId": 1234567890123456,
                        "onHandNumber": 15,
                        "pid": 1234567890123456,
                        "platformCode": "LINE",
                        "pname": "测试品名-子体",
                        "price": "49.99",
                        "productId": 1234567890123456,
                        "productUniqueId": 9876543210123456,
                        "readyToShipNumber": 10,
                        "sku": "LINE-SKU-002",
                        "status": 0,
                        "storeId": 1234567890123456,
                        "storeName": "Line官方店铺",
                        "supplyPriceList": [],
                        "title": "Line测试商品-子体",
                        "wareHouseDataList": []
                    }
                ],
                "cid": 1234567890123456,
                "cname": "运动鞋",
                "companyId": 1234567890123456,
                "day30SaleCnt": 150,
                "day7SaleCnt": 50,
                "id": "1001",
                "imgUrl": "https://example.com/image.jpg",
                "msku": "MY-SKU-001",
                "mskuId": 1234567890123456,
                "notes": "热卖商品",
                "onHandNumber": 30,
                "pid": 1234567890123456,
                "platformCode": "LINE",
                "pname": "测试品名",
                "price": "99.99",
                "principalName": "张三",
                "principalUids": [
                    4001,
                    4002
                ],
                "productId": 1234567890123456,
                "productUniqueId": 9876543210123456,
                "quantitySyn": {
                    "after": "500",
                    "before": "450",
                    "quantitySynWareHouses": [],
                    "type": 1,
                    "uid": 9001,
                    "userName": "李四"
                },
                "readyToShipNumber": 20,
                "sku": "LINE-SKU-001",
                "status": 0,
                "storeId": 1234567890123456,
                "storeName": "Line官方店铺",
                "supplyPriceList": [],
                "title": "Line测试商品",
                "wareHouseDataList": []
            },
            {
                "attributes": "颜色:绿色;尺寸:XL",
                "availableNumber": 75,
                "bid": 9876543210987654,
                "bname": "Adidas",
                "category": "鞋类",
                "children": [],
                "cid": 9876543210987654,
                "cname": "休闲鞋",
                "companyId": 1234567890123456,
                "day30SaleCnt": 80,
                "day7SaleCnt": 20,
                "id": "1003",
                "imgUrl": "https://example.com/image3.jpg",
                "msku": "MY-SKU-003",
                "mskuId": 9876543210987654,
                "notes": "新品上市",
                "onHandNumber": 10,
                "pid": 9876543210987654,
                "platformCode": "AMAZON",
                "pname": "休闲跑鞋",
                "price": "79.99",
                "principalName": "王五",
                "principalUids": [
                    4003
                ],
                "productId": 9876543210987654,
                "productUniqueId": 1122334455667788,
                "quantitySyn": {
                    "after": "100",
                    "before": "80",
                    "quantitySynWareHouses": [
                        {
                            "after": "50",
                            "before": "40",
                            "uid": 9002,
                            "userName": "王五",
                            "wareHouseName": "广州仓"
                        },
                        {
                            "after": "50",
                            "before": "40",
                            "uid": 9002,
                            "userName": "王五",
                            "wareHouseName": "上海仓"
                        }
                    ],
                    "type": 2,
                    "uid": 9002,
                    "userName": "王五"
                },
                "readyToShipNumber": 5,
                "sku": "AMAZON-SKU-003",
                "status": 0,
                "storeId": 1122334455667788,
                "storeName": "Amazon官方店铺",
                "supplyPriceList": [],
                "title": "Adidas休闲跑鞋",
                "wareHouseDataList": []
            }
        ],
        "count": 2
    },
    "total": 2
}