# 溯源码列表 - ListLabels
#### 功能介绍
溯源码列表
#### 授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-dac/dac_api_006.html)。
#### URI
POST /v1/{project_id}/trace/trace-sweepcode/label/list
表1路径参数 
| 参数         | 是否必选 | 参数类型   | 描述                            |
|:---|:---|:---|:---|
| project_id | 是    | String | 租户从IAM申请到的projectid，一般为32位字符串 |
#### 请求参数
表2请求Header参数 
| 参数           | 是否必选 | 参数类型   | 描述      |
|:---|:---|:---|:---|
| X-Auth-Token | 是    | String | 用户Token |
   
表3请求Body参数 
| 参数        | 是否必选 | 参数类型                                       | 描述            |
|:---|:---|:---|:---|
| itemCode  | 否    | String                                     | 溯源码           |
| batchCode | 否    | String                                     | 批次码           |
| 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 | 商品名称              |
| batchCode          | String | 批次码               |
| isUse              | String | 是否使用，0 未使用，1 已使用  |
| itemCode           | String | 一级溯源码             |
| traceabilityStatus | String | 溯源状态，0 正常，1 禁用    |
| productTraceUrl    | String | 商品溯源url           |
| latestActionsDate  | String | 最近溯源信息变化时间        |
| latestActions      | String | 最近溯源信息            |
| isSupportTrace     | String | 是否支持溯源，0 不支持，1 支持 |
   
**状态码：500**
表8响应Body参数 
| 参数         | 参数类型   | 描述   |
|:---|:---|:---|
| error_code | String | 错误码  |
| error_msg  | String | 错误描述 |
   
#### 请求示例
```
{
  "query" : {
    "size" : 500,
    "current" : 1
  },
  "merchant" : "1754386705866125313"
}
```
#### 响应示例
**状态码：200**
Success
```
{
  "code" : "200",
  "message" : "操作成功!",
  "data" : {
    "pageNum" : 1,
    "pageSize" : 10,
    "total" : 2,
    "pages" : 1,
    "record" : [ {
      "gmtCreate" : "2024-02-25 17:57:01",
      "gmtModified" : "2024-02-25 17:57:01",
      "productName" : null,
      "batchCode" : null,
      "isUse" : "0",
      "isSupportTrace" : "0",
      "itemCode" : "NftlBzOaNM",
      "latestActions" : null,
      "latestActionsDate" : null,
      "traceabilityStatus" : "0",
      "productTraceUrl" : "http://xxx.xxx.xxx.xxx/#/?itemCode=NftlBzOaNM"
    }, {
      "gmtCreate" : "2024-02-22 21:30:21",
      "gmtModified" : "2024-02-22 21:30:21",
      "productName" : null,
      "batchCode" : null,
      "isUse" : "0",
      "isSupportTrace" : "0",
      "itemCode" : "g6MJ9lyaHl",
      "latestActions" : null,
      "latestActionsDate" : null,
      "traceabilityStatus" : "0",
      "productTraceUrl" : "http://xxx.xxx.xxx.xxx/#/?itemCode=g6MJ9lyaHl"
    } ]
  }
}
```
**状态码：500**
Error response
```
{
  "code" : "500",
  "message" : "系统异常"
}
```
#### 状态码
| 状态码 | 描述             |
|:---|:---|
| 200 | Success        |
| 500 | Error response |