文档
测试

查询商品品牌信息

POST
请求地址/router

接口描述

获取用户的品牌信息

系统相关界面

"界面路径:【商品】----【商品品牌】"

请求地址

|环境|服务地址(HTTP/HTTPS)| |-|-| |V2正式环境(推荐)| https://gw.superboss.cc/router| **2022年4月1日**以后申请的APP Key,统一使用V2正式环境的请求地址:**https://gw.superboss.cc/router**

公共参数

调用任何一个API都必须传入的参数,目前支持的公共参数有: | 参数名称 | 参数类型 | 是否必须 | 参数描述 | | --- | --- | --- | --- | | method | string | 是 | API接口名称 | | appKey | string | 是 | 分配给应用的AppKey | | timestamp | string | 是 | 时间戳,时区为GMT+8,例如:2020-09-21 16:58:00。API服务端允许客户端请求最大时间误差为10分钟 | | format | string | 否 | 响应格式。默认为json格式,可选值:json | | version | string | 是 | API协议版本 可选值:1.0 | | sign\_method | string | 否 | 签名的摘要算法(默认 hmac),可选值为:hmac,md5,hmac-sha256。 | | sign | string | 是 | 签名 | | session | string | 是 | 授权会话信息 (即access_token,由系统分配) |

请求头

参数名
类型
描述
必填
Content-Type
string
application/x-www-form-urlencoded
必填

API接口地址

参数名
类型
描述
必填
method
string
brand.list.get
必填

请求参数

参数名
类型
描述
必填
默认值
pageNo
integer
页码 取值范围:大于零的整数。
可选
1
pageSize
integer
每页条数 取值范围:大于零的整数;最大值:200;
可选
40

请求示例

示例一: ----------------- ``` { "pageNo":1, "pageSize":10 } ```

响应参数

参数名
类型
描述
items
array
数据字典
brandId
long
品牌ID
brandName
string
品牌名称
created
long
品牌创建时间
modified
long
品牌修改时间
total
long
返回总数
success
boolean
示例:true
trace_id
string
示例:3553483395407017

响应示例

``` { "traceId": "1871260094457119864", "total": 1, "success": true, "items": [ { "brandName": "测试", "created": 1665198251000, "brandId": 498117188973056, "modified": 1665198251000 } ] } ```

异常示例

``` { "code": "25", "msg": "服务方法(brand.list.get:1.0)的签名无效", "success": false, "trace_id": "3553483395423660" } ```

错误码解释

| 错误码 |错误信息|解决方案| |-|-|-| |20001|页码为空或不符合规定|页码的值不能为空,且不能小于1| |20002|页数为空或不符合规定|页数的值不能为空,且不能小于1或超过200| |20102|查询品牌列表有误|请根据返回错误信息进行处理|