ProductCode API
产品编码查询 API 文档
通过统一接口查询商品编码、品牌、规格、充值类型等信息。请求体使用 JSON，签名验证保持原有规则不变。
HTTPhttp://productcode.cn/api/productSearch
HTTPShttps://productcode.cn/api/productSearch
请求参数
| 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|
| app_key | string | 是 | 应用编码 |
| sign | string | 是 | 签名，用于验证请求有效性 |
| time | string | 是 | 10 位时间戳 |
| code | string | 否 | 商品编码，支持模糊搜索 |
| brand | string | 否 | 品牌名称，支持模糊搜索 |
| membership | string | 否 | 等级名称 |
| value | string | 否 | 综合查询，匹配商品名、品牌、会员、有效期 |
| charge_type | int | 否 | 充值类型，1 直充，2 卡券，3 代充 |
| page | int | 否 | 页码，默认 1 |
| limit | int | 否 | 每页数量，默认 20，最大 100 |
请求示例
{
"app_key": "your_app_key",
"sign": "your_sign",
"time": "1630000000",
"code": "ZMGTV",
"brand": "芒果tv",
"membership": "VIP",
"value": "VIP会员",
"charge_type": 1,
"page": 1,
"limit": 20
}
响应参数
| 参数名 | 类型 | 描述 |
|---|---|---|
| code | int | 状态码，0 表示成功 |
| data | object | 返回数据 |
| data.list | array | 产品列表 |
| data.count | int | 总记录数 |
| message | string | 消息说明 |
成功响应示例
{
"code": 0,
"data": {
"list": [
{
"code": "ZMGTVVIP1Y",
"brand": "芒果tv",
"validity": "1年",
"charge_type": "直充",
"product_name": "芒果tv/VIP会员/1年",
"membership": "VIP",
"order": 1
}
],
"count": 10
},
"message": ""
}
错误响应示例
{
"code": 400,
"message": "请求参数错误"
}
错误代码
- 400 - 请求参数错误
- 401 - 无效 app_key 或未启用
- 403 - IP 不在允许范围，或签名校验失败
- 404 - 路径无效
- 408 - 请求超时
- 429 - 请求频率限制
- 500 - 服务器内部错误
签名验证说明
- 除 sign 外，所有参数参与签名。
- 按 key 升序排列，拼接成 query 字符串，例如 a=1&b=2&c=3。
- 将 query 拼接 app_secret 后进行 MD5 加密，小写输出。
ksort($params); $query = urldecode(http_build_query($params)); $sign = strtolower(md5($query . $app_secret));