
# 查询批次列表 - BatchListProducts
#### 功能介绍
查询批次列表
#### 授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-dac/dac_api_006.html)。
#### URI
POST /v1/{project_id}/trace/trace-sweepcode/product-batch/batch-list
表1路径参数 
| 参数         | 是否必选 | 参数类型   | 描述                            |
|:---|:---|:---|:---|
| project_id | 是    | String | 租户从IAM申请到的projectid，一般为32位字符串 |
#### 请求参数
表2请求Header参数 
| 参数           | 是否必选 | 参数类型   | 描述      |
|:---|:---|:---|:---|
| X-Auth-Token | 是    | String | 用户Token |
   
表3请求Body参数 
| 参数       | 是否必选 | 参数类型                                              | 描述            |
|:---|:---|:---|:---|
| merchant | 是    | String                                            | 商户ID（取值为项目ID） |
| query    | 是    | [Query] object | 分页参数          |
   
 表4Query 
| 参数      | 是否必选 | 参数类型    | 描述    |
|:---|:---|:---|:---|
| current | 否    | Integer | 当前页   |
| size    | 否    | Integer | 每页的数量 |
   
#### 响应参数
**状态码：200**
表5响应Body参数 
| 参数      | 参数类型                                             | 描述     |
|:---|:---|:---|
| code    | String                                           | 返回码    |
| message | String                                           | 响应消息   |
| data    | [data] object | 批次列表数据 |
   
 表6data 
| 参数       | 参数类型                                                           | 描述   |
|:---|:---|:---|
| pageNum  | Integer                                                        | 页数   |
| pageSize | Integer                                                        | 每页数量 |
| total    | Integer                                                        | 总数   |
| pages    | Integer                                                        | 总页数  |
| record   | Array of [record] objects | 批次信息 |
   
 表7record 
| 参数          | 参数类型   | 描述            |
|:---|:---|:---|
| gmtCreate   | String | 创建时间          |
| gmtModified | String | 修改时间          |
| productName | String | 商品名称          |
| productCode | String | 商品码           |
| batchCode   | String | 批次码           |
| batchName   | String | 批次名称          |
| merchant    | String | 商户ID（取值为项目ID） |
   
**状态码：500**
表8响应Body参数 
| 参数         | 参数类型   | 描述   |
|:---|:---|:---|
| error_code | String | 错误码  |
| error_msg  | String | 错误描述 |
   
#### 请求示例
```
{
  "query" : {
    "size" : 500,
    "current" : 1
  },
  "merchant" : "1754804134391934977"
}
```
#### 响应示例
**状态码：200**
Success
```
{
  "code" : 200,
  "message" : "操作成功!",
  "data" : {
    "pageNum" : 1,
    "pageSize" : 10,
    "total" : 1,
    "pages" : 1,
    "record" : [ {
      "gmtCreate" : "2022-02-24 01:00:07",
      "gmtModified" : "2022-02-24 01:00:07",
      "productName" : "测试",
      "productCode" : "测试",
      "batchCode" : "889af5124bfe4e4fbae7cc9aa9b3d786",
      "batchName" : "批次1",
      "merchant" : "1748189792481312769"
    } ]
  }
}
```
**状态码：500**
Error response
```
{
  "code" : "500",
  "message" : "系统异常"
}
```
#### 状态码
| 状态码 | 描述             |
|:---|:---|
| 200 | Success        |
| 500 | Error response |
   
