文档首页/数字资产链 DAC/API参考/API/可信溯源/溯源码管理/溯源码列表 - ListLabels
更新时间：2025-11-18 GMT+08:00
查看PDF
分享

溯源码列表 - ListLabels

功能介绍

溯源码列表

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见权限和授权项。

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

分页参数

表4 Query

参数

是否必选

参数类型

描述

current

否

Integer

当前页

size

否

Integer

每页的数量

响应参数

状态码：200

表5 响应Body参数

参数

参数类型

描述

code

String

返回码

message

String

返回描述

data

data object

详情

表6 data

参数

参数类型

描述

pageNum

Integer

页数

pageSize

Integer

每页展示的数量

total

Integer

总数

pages

Integer

总页数

record

Array of record objects

溯源码信息

表7 record

参数

参数类型

描述

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

父主题：溯源码管理

相关文档