查询商品列表

云端 Mock

POST

/goofish/goods/list

请求参数

Query 参数

mch_id

string

必需

示例值:

1001

timestamp

integer

必需

当前时间戳（单位秒，5分钟内有效）

默认值:

sign

string

必需

签名MD5值（参考签名说明）

默认值:

Body 参数application/json

keyword

string

搜索关键词

可选

注意：需同时支持商品名称模糊搜索和商品编码精准搜索

goods_type

enum<integer> <int32>

商品类型

可选

1：直充商品
2：卡密商品

枚举值:

示例值:

page_no

integer <int32>

当前页码

必需

默认值:

page_size

integer <int32>

每页行数

必需

注意：最大行数需支持到100

>= 1<= 100

默认值:

示例

{
  "keyword": "",
  "goods_type": 2,
  "page_no": 1,
  "page_size": 68
}

返回响应

🟢200成功

application/json

Body

code

enum<integer> <int32>

必需

>= 0<= 0

默认值:

示例值:

固定值:

msg

string

必需

默认值:

data

object

必需

list

array[object (商品详情) {8}]

商品列表

必需

count

integer <int32>

商品总数

必需

示例值:

1000

示例

{
  "code": 0,
  "msg": "OK",
  "data": {
    "list": [
      {
        "goods_no": "12344532",
        "goods_type": 1,
        "goods_name": "【自动充值】哔哩哔哩大会员『7天』",
        "price": 1000,
        "stock": 99999,
        "status": 1,
        "update_time": 1723870189,
        "template": [
          {
            "code": "account",
            "name": "充值账号",
            "desc": "仅支持手机号",
            "check": 0
          }
        ]
      }
    ],
    "count": 1000
  }
}

🟢200失败

修改于 2025-03-18 07:54:30

查询商户信息

查询商品详情