简要描述
- 获取橱窗商品列表
请求URL
{Host}/lt-third/api/goods/list
,见【基础参数说明】
请求方式
- GET 方式发送参数
- POST 方式发送参数。当使用 POST 时,请求的主体必须是 JSON 格式,而且 HTTP header 的 Content-Type 需要设置为 application/json
请求参数说明
参数名 | 必选 | 类型 |
说明
|
---|---|---|---|
appId | 是 | string | 应用AppId |
appSecret | 是 | string | 应用AppSecret |
platformShopIds | 否 | string | 【API-达人ID】集合 可逗号隔开 |
platformGoodsIds | 否 | string | 【API-商品ID】集合 可逗号隔开 |
updateStartTime | 否 | string | 数据更新开始时间,格式: yyyy-MM-dd HH:mm:ss |
updateEndTime | 否 | string | 数据更新结束时间,格式: yyyy-MM-dd HH:mm:ss |
pageIndex | 否 | int | 页码,默认值为1 |
pageSize | 否 | int | 每页记录数,默认值为20 取值范围:1~50 |
keywords | 否 | string | 关键词 |
请求示例
POST {Host}/lt-third/api/goods/list
Content-Type: application/json
{
"appId": "RlYajTa4hd74xh4FuGrVkDPx",
"appSecret": "uy8wHbPohwT8cB1HncTJaZaBSmVwaV",
"pageIndex": 1,
"pageSize": 10
}
返回参数说明
参数名 | 类型 |
说明
|
---|---|---|
code | int | 状态码 |
msg | string | 描述 |
data | object | |
total | int | 总行数 |
rows | Goods[] | 商品列表 |
Goods 实体:
参数名 | 类型 |
说明
|
---|---|---|
platformGoodsId | string | 商品ID,唯一值 |
platformShopId | string | 达人ID,唯一值 |
thirdPlatform | string | 对接平台,见【字典数据】 |
platformShopNo | string | 平台达人ID |
platformGoodsNo | string | 平台商品ID |
goodsLogo | string | 商品图片 |
goodsTitle | string | 商品标题 |
goodsSn | string | 商品编码 |
goodsDetail | string | 商品详情 |
goodsPrice | number | 商品参考价,最多保留4位小数 |
goodsCreateTime | string | 商品创建时间,格式: yyyy-MM-dd HH:mm:ss |
saleStatus | string | 上架状态文本 |
goodsStatusValue | string | 商品状态值(0-未上架/1-已上架/2-删除) |
updateTime | string | 数据更新时间,格式: yyyy-MM-dd HH:mm:ss |
otherInfo | string | 其他信息JSON字符串,每个平台定制字段,见【字典数据】 |
返回示例
{
"code": 200,
"msg": "查询成功",
"data": {
"total": 15,
"rows": [
{
"platformGoodsId": "buyin_77844856_3588123425924850693",
"platformShopId": "buyin_77844856",
"thirdPlatform": "buyin",
"platformShopNo": "77844856",
"platformGoodsNo": "3588123425924850693",
"goodsLogo": "https://p6-aio.ecombdimg.com/obj/e505bb853f_sx_58687_www800-800",
"goodsTitle": "巧发力羽毛球训练器 练习器辅助发力阻力拍套器 羽毛球挥拍训练器",
"goodsSn": "",
"goodsDetail": "{\"shop_id\":\"48494940\",\"shop_name\":\"四季风供应链个体店\",\"detail_imgs\":[\"https://lf6-cm.ecombdstatic.com/obj/ecom-shop-material/v1_liuzfzSf_70971899616313674630940_cc966194826f4b549335d9673eabecac_sx_28826_www790-493\"]}",
"goodsPrice": 170.90,
"goodsCreateTime": "",
"saleStatus": "已上架",
"goodsStatusValue": "1",
"updateTime": "2023-02-13 17:16:47",
"otherInfo": "{\"promotionId\": \"3652072598491242673\", \"commissionCosRatio\": 30, \"commission\": 3.84, \"gmv\": 0, \"pvExposureRate\": 0}"
}
]
}
}