文档首页/数字资产链 DAC/API参考/API/可信溯源/批次环节管理/查询批次关联环节 - ListBatchLinks
更新时间：2025-11-18 GMT+08:00
查看PDF
分享

查询批次关联环节 - ListBatchLinks

功能介绍

查询批次关联环节

授权信息

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

URI

POST /v1/{project_id}/trace/trace-sweepcode/batch-link/list

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

租户从IAM申请到的projectid，一般为32位字符串

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

用户Token

表3 请求Body参数

参数

是否必选

参数类型

描述

batchCode

是

String

批次码

merchant

是

String

商户ID（取值为项目ID）

响应参数

状态码：200

表4 响应Body参数

参数

参数类型

描述

code

Integer

返回码

message

String

返回描述

data

Array of data objects

返回批次溯源环节

表5 data

参数

参数类型

描述

batchCode

String

批次码

linkCode

String

环节码

linkName

String

环节名称

linkSeq

Integer

环节顺序

isSweepCodeDisplay

String

是否扫码展示：0: 不展示 1: 展示

isChain

String

是否上链:0:不上链,1:上链

inOutType

Integer

出入库类型:0：入库;1：出库;2：不涉及出入库

linkStatus

String

环节状态:

0未上链,

1上链中,

2已上链,

3上链失败

状态码：500

表6 响应Body参数

参数

参数类型

描述

error_code

String

错误码

error_msg

String

错误描述

请求示例

{
  "batchCode" : " 1c403af577ec4b369140c95327b17",
  "merchant" : " 1754386705866125313 "
}

响应示例

状态码：200

Success

{
  "code" : 200,
  "message" : "操作成功!",
  "data" : [ {
    "batchCode" : "962cc65f20674ebeb67b765f83bcaa24",
    "linkCode" : "2024031221062190307601",
    "linkName" : "清风",
    "linkSeq" : 6,
    "isSweepCodeDisplay" : "1",
    "isChain" : "1",
    "inOutType" : 2,
    "linkStatus" : "3"
  } ]
}

状态码：500

Error response

{
  "code" : "500",
  "message" : "系统异常"
}

状态码

状态码

描述

200

Success

500

Error response

父主题：批次环节管理

相关文档