Lingxing
切换旧版

查询Kaufland在线商品

POST/basicOpen/multiplatform/kaufland/list

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

接口信息

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

请求参数

principalUidsarray<any>
负责人用户ID列表；传[-1]表示仅查询未分配负责人，-1不能与其他UID混传
offsetinteger
偏移量，默认0
lengthinteger
每页条数，默认20，最大200
storeIdsarray<any>
店铺ID列表
pairingStatusinteger
配对状态
0=未配对
1=已配对
searchSingleValuestring
模糊搜索值
searchValuesarray<any>
精确搜索值列表
searchFieldinteger
搜索类型：
1=msku
2=商品ID
3=SKU
4=品名
sortTypestring
排序方式：asc/desc
sortFieldstring
排序字段
categoryIdsarray<any>
分类ID列表
brandIdsarray<any>
品牌ID列表
statusListarray<any>
状态列表：
INCOMPLETE=0
AVAILABLE=1
ONHOLD=2
productTypeListarray<any>
商品类型列表
pricenumber
金额筛选值
priceConditioninteger
金额筛选条件：
1=大于
2=小于
quantityinteger
库存数筛选值
quantityConditioninteger
库存筛选条件：
1=大于
2=小于

请求cURL示例

curl --location 'https://openapi.lingxing.com/basicOpen/multiplatform/kaufland/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": 1,
    "searchSingleValue": "商品A"
}'

返回结果

Json Object

codeinteger必填
状态码，0：成功
示例 0
messagestring必填
消息提示
示例 success
error_detailsarray<any>必填
数据校验失败时的错误详情
request_idstring必填
请求链路id
示例 a0d54debf93140f3b58d1ed81e8e3583
response_timestring必填
响应时间
示例 2026-07-14 12:00:00
dataobject必填
响应数据
隐藏子属性
countinteger必填
总数
示例 25
listarray<object>必填
列表数据
隐藏子属性
principalUidsarray<any>
负责人用户ID列表
示例 [10001]
principalNamestring
负责人名称
示例 张三
performanceUidinteger
业绩归属人用户ID
示例 10002
performanceNamestring
业绩归属人名称
示例 李四
idinteger必填
ID
示例 1
productUniqueIdinteger必填
商品唯一ID
示例 10001
mskuIdstring必填
MSKU ID
示例 MSKU001
mskustring必填
MSKU
示例 msku-test
titlestring必填
标题
示例 示例商品标题
imgUrlstring必填
图片URL
示例 https://img.example.com/1.jpg
statusstring必填
状态
示例 1
statusNamestring必填
状态名称
示例 Available
eanstring必填
EAN
示例 1234567890123
pricenumber必填
价格
示例 49.99
currencystring必填
币种
示例 EUR
currencyIconstring必填
币种符号
示例 €
quantityinteger必填
库存
示例 100
storeIdinteger必填
店铺ID
示例 1
storeNamestring必填
店铺名称
示例 我的店铺
pnamestring必填
品名
示例 商品A
skustring必填
SKU
示例 SKU001
pidinteger必填
本地产品ID
示例 1001
totalinteger必填
总数
示例 25

返回成功示例

{
    "code": 0,
    "message": "success",
    "error_details": [],
    "request_id": "a0d54debf93140f3b58d1ed81e8e3583",
    "response_time": "2026-07-14 12:00:00",
    "data": {
        "count": 25,
        "list": [
            {
                "id": 1,
                "productUniqueId": 10001,
                "principalUids": [10001],
                "principalName": "张三",
                "performanceUid": 10002,
                "performanceName": "李四",
                "mskuId": "MSKU001",
                "msku": "msku-test",
                "title": "示例商品标题",
                "imgUrl": "https://img.example.com/1.jpg",
                "status": "1",
                "statusName": "Available",
                "ean": "1234567890123",
                "price": 49.99,
                "currency": "EUR",
                "currencyIcon": "€",
                "quantity": 100,
                "storeId": 1,
                "storeName": "我的店铺",
                "pname": "商品A",
                "sku": "SKU001",
                "pid": 1001
            }
        ]
    },
    "total": 25
}