Skip to content

商品列表

请求路径

  • 请求方式:GET
  • 请求头:Content-Type:application/x-www-form-urlencoded
  • 接口地址:/Third/Goods/goodsList
  • 频率限制:10秒100次

请求参数

参数必选类型描述
uidstring用户id
app_idstring频道ID
gidstring查询商品详情时使用商品ID
currentPagestring当前页:分页情况下是必填参数
pageSizestring每页记录数,默认为10
optstring返回数据是否分页控制 all:不分页
namestring搜索的商品名称
category_idstring商品分组id
sale_statusstring开售状态:0-全部,1-未开售,2-销售中

请求示例

{
    "uid": "123456",
    "app_id": "789",
    "currentPage": "1",
    "pageSize": "10"
}

响应参数

参数必选类型描述
codestring状态码:200-成功,400-失败
msgstring提示信息
dataobject消息内容

data 参数结构

参数必选类型描述
listarray商品列表
totalstring总记录数
currentPagenumber当前页码
pageSizenumber每页记录数

list 参数结构

参数必选类型描述
idstring商品(记录)ID
namestring商品名称
pricestring商品价格
linkTypestring购买方式:text-文字链接,pic-图片链接,local-本地购买
linkstring购买方式链接
typestring商品类型(默认都是goods)
storagestring库存
discount_pricestring商品折扣价格
unitstring商品单位
recommendstring推荐:0-不推荐,1-推荐
descstring商品富文本描述
picsstring商品图片详情(json)
picArrarray商品图片(arr)
push_app_nickstring直播房间名称
buy_user_namestring买家姓名
goods_type_infostring商品类型信息
attr_namestring属性名
attr_valstring属性值
is_limit_buystring限购:1-开启,2-关闭
num_limit_buystring限购数量
sale_typestring开售类型:1-立即,2-定时
sale_timestring定时时间
sale_time_datestring定时日期
sale_statusstring开售状态:1-未开始,2-销售中
sale_status_infostring未开始,销售中
num_limit_killstring秒杀次数限制

响应示例

json
{
  "code": 200,
  "msg": "success",
  "data": {
    "list": [
      {
        "id": "168452",
        "name": "秒杀商品次数限制",
        "price": "0.01",
        "linkType": "local",
        "link": "",
        "type": "virtual",
        "storage": "17",
        "unit": "盒",
        "recommend": 0,
        "desc": "<p><br></p>",
        "pics": "[{\"path\":\"https://nyfs.oss.nuoyun.tv/Uploads/ConsoleWechat/35016/materialPic/202206281723541933342.png\"}]",
        "picArr": [
          "https://nyfs.oss.nuoyun.tv/Uploads/ConsoleWechat/35016/materialPic/202206281723541933342.png"
        ],
        "push_app_nick": null,
        "buy_user_name": null,
        "goods_type_info": null,
        "attr_name": null,
        "attr_val": null,
        "is_limit_buy": "2",
        "num_limit_buy": "1",
        "sale_type": "1",
        "sale_time": "0",
        "sale_status": 2,
        "sale_status_info": "售卖中",
        "num_limit_kill": "1"
      }
    ],
    "total": "2",
    "currentPage": 1,
    "pageSize": 10
  }
}

可能遇到的问题