华为云用户手册

  • URI GET /v1/{project_id}/chains/{chain_id}/evidence/verification 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 租户从 IAM 申请到的projectid,一般为32位字符串 最小长度:32 最大长度:64 chain_id 是 String 数字资产链实例ID 最小长度:32 最大长度:64 表2 Query参数 参数 是否必选 参数类型 描述 index 否 String 通用搜索条件:取值为存证ID、证据指纹、交易ID中任意1个值 最小长度:32 最大长度:64 file_hash 否 String 证据指纹搜索条件:取值为证据指纹 最小长度:32 最大长度:64 tx_id 否 String 交易ID搜索条件:取值为交易ID 最小长度:32 最大长度:64 ev_id 否 String 存证ID搜索条件:取值为存证ID 最小长度:32 最大长度:64
  • 响应参数 状态码: 200 表4 响应Body参数 参数 参数类型 描述 code Integer 返回码 最小值:1 最大值:100 message String 返回描述 最小长度:1 最大长度:100 data Array of data objects 返回批次溯源环节 表5 data 参数 参数类型 描述 batchCode String 批次码 linkCode String 环节码 linkName String 环节名称 最小长度:1 最大长度:20 linkSeq Integer 环节顺序 最小值:0 最大值:50 isSweepCodeDisplay String 是否扫码展示:0: 不展示 1: 展示 isChain String 是否上链:0:不上链,1:上链 枚举值: 0 1 inOutType Integer 出入库类型:0:入库;1:出库;2:不涉及出入库 枚举值: 0 1 2 linkStatus String 环节状态: 0未上链, 1上链中, 2已上链, 3上链失败 枚举值: 0 1 2 3 状态码: 500 表6 响应Body参数 参数 参数类型 描述 error_code String 错误码 最小长度:1 最大长度:100 error_msg String 错误描述 最小长度:1 最大长度:100
  • 响应示例 状态码: 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" : "系统异常" }
  • URI GET /v1/open/evidences/verification 表1 Query参数 参数 是否必选 参数类型 描述 index 否 String 通用搜索条件:取值为存证ID、证据指纹、交易ID中任意1个值 最小长度:32 最大长度:64 file_hash 否 String 证据指纹搜索条件:取值为证据指纹 最小长度:32 最大长度:64 tx_id 否 String 交易ID搜索条件:取值为交易ID 最小长度:32 最大长度:64 ev_id 否 String 存证ID搜索条件:取值为存证ID 最小长度:32 最大长度:64
  • 响应参数 状态码: 200 表2 响应Body参数 参数 参数类型 描述 name String 存证名称 ev_id String 存证ID file_hash String 文件内容Hash, 即存证指纹 block_hash String 区块哈希 block_height Integer 区块高度 create_time String 创建时间 tx_id String 交易ID 状态码: 400 表3 响应Body参数 参数 参数类型 描述 error_code String 错误码 最小长度:1 最大长度:20 error_msg String 错误描述 最小长度:1 最大长度:512
  • 响应参数 状态码: 200 表3 响应Body参数 参数 参数类型 描述 total_count Integer 总记录 evidences Array of Evidence objects 存证信息列表 表4 Evidence 参数 参数类型 描述 name String 存证名称 ev_id String 存证ID file_hash String 存证指纹 charge_type String 存证类型, normal:普通存证 create_time String 创建时间 tx_id String 交易ID 状态码: 400 表5 响应Body参数 参数 参数类型 描述 error_code String 错误码 最小长度:1 最大长度:20 error_msg String 错误描述 最小长度:1 最大长度:512
  • URI GET /v1/{project_id}/evidences 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 租户从IAM申请到的projectid,一般为32位字符串 最小长度:32 最大长度:64 表2 Query参数 参数 是否必选 参数类型 描述 limit 否 Integer 分页,每页大小,分页大小只支持10、20、50/页,默认显示10条/页 最小值:10 最大值:50 offset 否 Integer 偏移量,从第几项开始,默认值为0 最小值:0 最大值:65535 name 否 String 按照存证名称字段搜索,不支持模糊匹配 最小长度:4 最大长度:765 charge_type 否 String 按照存证类型,精确匹配 最小长度:4 最大长度:64 begin_time 是 String 按照时间范围搜索,起始时间 (UTC时间,毫秒级),和end_time配合使用。最大时间不超过30天。 最小长度:13 最大长度:16 end_time 是 String 按照时间范围搜索,截止时间 (UTC时间,毫秒级),和begin_time配合使用。最大时间不超过30天 最小长度:13 最大长度:16
  • 请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token 最小长度:1 最大长度:65535 表3 请求Body参数 参数 是否必选 参数类型 描述 merchant 是 String 商户ID 最小长度:1 最大长度:100 query 是 Query object 分页参数 表4 Query 参数 是否必选 参数类型 描述 current 否 Integer 当前页 最小值:1 最大值:2147483647 缺省值:1 size 否 Integer 每页的数量 最小值:1 最大值:2147483647 缺省值:10
  • 响应参数 状态码: 200 表5 响应Body参数 参数 参数类型 描述 code String 返回码 最小长度:1 最大长度:50 message String 响应消息 最小长度:1 最大长度:100 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 商品名称 最小长度:1 最大长度:100 productCode String 商品码 最小长度:1 最大长度:100 batchCode String 批次码 最小长度:1 最大长度:100 batchName String 批次名称 merchant String 商户ID 最小长度:1 最大长度:100 状态码: 500 表8 响应Body参数 参数 参数类型 描述 error_code String 错误码 最小长度:1 最大长度:100 error_msg String 错误描述 最小长度:1 最大长度:100
  • 响应示例 状态码: 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" : "系统异常" }
  • 请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token 最小长度:1 最大长度:65535 表3 请求Body参数 参数 是否必选 参数类型 描述 batchCode 是 String 批次码 最小长度:1 最大长度:100 linkName1 是 String 环节名称1 最小长度:1 最大长度:20 linkSeq1 是 Integer 环节顺序1 最小值:0 最大值:50 linkName2 是 String 环节名称2 最小长度:1 最大长度:100 linkSeq2 是 Integer 环节顺序2 最小值:0 最大值:50 merchant 是 String 商户ID 最小长度:1 最大长度:100
  • 请求示例 { "productCode" : " qfftest2201", "batchName" : "批次02202", "traceabilityLevels" : "1", "productBatchUnits" : [ { "level" : "1", "unitName" : "圆通" } ], "merchant" : " 1754386705866125313" }
  • 请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token 最小长度:1 最大长度:65535 表3 请求Body参数 参数 是否必选 参数类型 描述 batchName 是 String 批次名称 最小长度:1 最大长度:255 productCode 是 String 商品码 最小长度:1 最大长度:255 traceabilityLevels 是 Integer 溯源层级数,1,2,3,当前只支持1级溯源码 枚举值: 1 2 3 merchant 是 String 商户ID 最小长度:1 最大长度:100 productBatchUnits 是 Array of productBatchUnits objects 层级信息列表 表4 productBatchUnits 参数 是否必选 参数类型 描述 level 是 Integer 溯源层级数,当前只支持1级溯源码 枚举值: 1 2 3 unitName 否 String 单位名称 最小长度:1 最大长度:50
  • 响应参数 状态码: 200 表5 响应Body参数 参数 参数类型 描述 code String 返回码 最小长度:1 最大长度:20 message String 返回描述 最小长度:1 最大长度:255 data data object data 表6 data 参数 参数类型 描述 batchCode String 批次码 batchName String 批次名称 productCode String 商品码 merchant String 商户ID 状态码: 500 表7 响应Body参数 参数 参数类型 描述 error_code String 错误码 最小长度:1 最大长度:100 error_msg String 错误描述 最小长度:1 最大长度:100
  • 响应示例 状态码: 200 Success { "code" : "200", "message" : "操作成功!", "data" : { "batchCode" : "2024021753347601", "batchName" : "香蕉第一批次", "productCode" : "banana", "merchant" : "1752329807713542146" } } 状态码: 500 Error response { "code" : "500", "message" : "系统异常" }
  • 响应参数 状态码: 200 表4 响应Body参数 参数 参数类型 描述 code Integer 返回码 最小值:1 最大值:50 message String 响应消息 最小长度:1 最大长度:100 data String 上传的文件链接 状态码: 500 表5 响应Body参数 参数 参数类型 描述 error_code String 错误码 最小长度:1 最大长度:100 error_msg String 错误描述 最小长度:1 最大长度:100
  • 响应参数 状态码: 200 表4 响应Body参数 参数 参数类型 描述 code String 返回码 message String 响应消息 最小长度:1 最大长度:100 data String 下载任务ID 最小长度:1 最大长度:100 状态码: 500 表5 响应Body参数 参数 参数类型 描述 error_code String 错误码 最小长度:1 最大长度:100 error_msg String 错误描述 最小长度:1 最大长度:100
  • 响应示例 状态码: 200 Success { "code" : 200, "message" : "操作成功!", "data" : { "gmtCreate" : "2022-02-24 17:53:07", "gmtModified" : "2022-02-24 17:53:22", "productName" : "测试产品", "productCode" : "测试", "batchCode" : "462d61980ad140549b3ac9080ce04861", "batchName" : "批次", "merchant" : "1748189792481312769", "level1Count" : 0, "level2Count" : 0, "level3Count" : 0, "productBatchUnitRespList" : [ { "level" : 0, "unitName" : "单位" } ] } } 状态码: 500 Error response { "code" : "500", "message" : "系统异常" }
  • 响应参数 状态码: 200 表4 响应Body参数 参数 参数类型 描述 code String 返回码 最小长度:1 最大长度:20 message String 返回消息 最小长度:1 最大长度:255 data data object 批次详情数据 表5 data 参数 参数类型 描述 gmtCreate String 创建时间 gmtModified String 更新时间 productName String 商品名称 productCode String 商品码 batchCode String 批次码 batchName String 批次名称 merchant String 商户ID level1Count Integer 一级码数量 level2Count Integer 二级码数量 level3Count Integer 三级码数量 productBatchUnitRespList Array of productBatchUnitRespList objects 层级信息列表 表6 productBatchUnitRespList 参数 参数类型 描述 level Integer 所在层级 unitName String 单位名称 状态码: 500 表7 响应Body参数 参数 参数类型 描述 error_code String 错误码 最小长度:1 最大长度:100 error_msg String 错误描述 最小长度:1 最大长度:100
  • 请求示例 { "merchant" : "1748189792481312769", "batchCode" : "962cc65f20674ebeb67b765f83bcaa24", "linkName" : "清风", "batchLinkContentList" : [ { "contentUrl" : "url", "contentType" : "0", "contentName" : "测试", "contentText" : "String", "sweepCodeDisplay" : "1", "contentId" : 1456460643218268200 } ] }
  • 请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token 最小长度:1 最大长度:65535 表3 请求Body参数 参数 是否必选 参数类型 描述 merchant 是 String 商户ID 最小长度:1 最大长度:100 batchCode 是 String 批次码 最小长度:1 最大长度:100 linkName 是 String 环节名称 最小长度:1 最大长度:20 batchLinkContentList 是 Array of BatchLinkContentList objects 环节内容 表4 BatchLinkContentList 参数 是否必选 参数类型 描述 contentUrl 否 String 对于图片、PDF等存储url 最小长度:1 最大长度:250 contentType 是 String 溯源内容类型(0.图片、1.PDF、2.文本) 枚举值: 0 1 2 contentName 是 String 溯源内容名称 最小长度:1 最大长度:100 contentText 否 String 对于文本,直接存储文本内容 最小长度:1 最大长度:250 sweepCodeDisplay 是 String 扫码展示方式:0 不展示,1 展示 枚举值: 0 1 contentId 是 String 环节内容ID
  • 响应参数 状态码: 200 表5 响应Body参数 参数 参数类型 描述 code Integer 返回码 最小值:1 最大值:100 message String 响应消息 最小长度:1 最大长度:100 data Boolean 环节内容是否修改成功 状态码: 500 表6 响应Body参数 参数 参数类型 描述 error_code String 错误码 最小长度:1 最大长度:100 error_msg String 错误描述 最小长度:1 最大长度:100
  • 请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token 最小长度:1 最大长度:65535 表3 请求Body参数 参数 是否必选 参数类型 描述 productCode 是 String 商品码 最小长度:1 最大长度:100 batchCode 是 String 批次码,不可修改 最小长度:1 最大长度:255 batchName 是 String 批次名称 最小长度:1 最大长度:255 traceabilityLevels 是 String 溯源层级数,1,2,3,当前只支持一级溯源码 枚举值: 1 2 3 productBatchUnits 否 Array of productBatchUnits objects 层级信息列表 merchant 是 String 商户ID,不可修改 最小长度:1 最大长度:100 表4 productBatchUnits 参数 是否必选 参数类型 描述 level 是 String 所在层级 unitName 否 String 单位名称
  • 请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token 最小长度:1 最大长度:65535 表3 FormData参数 参数 是否必选 参数类型 描述 merchant 是 String 商户ID 最小长度:1 最大长度:100 batchCode 是 String 批次码 最小长度:1 最大长度:100 file 是 File 文件,支持文件后缀为xlsx,xls
  • 响应参数 状态码: 200 表4 响应Body参数 参数 参数类型 描述 code String 返回码 message String 信息 data data object 返回数据 表5 data 参数 参数类型 描述 taskId String 任务ID batchCode String 批次码 merchant String 商户ID 状态码: 500 表6 响应Body参数 参数 参数类型 描述 error_code String 错误码 最小长度:1 最大长度:100 error_msg String 错误描述 最小长度:1 最大长度:100
  • 响应示例 状态码: 200 Success { "code" : "200", "message" : "操作成功!", "data" : { "taskId" : "547d2f7cdcb149fca8a2bb499762b43a", "batchCode" : "1c403af577ec4b369140c95327b17aed", "merchant" : "1754386705866125313" } } 状态码: 500 Error response { "code" : "500", "message" : "系统异常" }
  • 响应参数 状态码: 200 表4 响应Body参数 参数 参数类型 描述 code String 返回码 最小长度:1 最大长度:20 message String 返回描述 最小长度:1 最大长度:255 状态码: 500 表5 响应Body参数 参数 参数类型 描述 error_code String 错误码 最小长度:1 最大长度:100 error_msg String 错误描述 最小长度:1 最大长度:100
  • 响应参数 状态码: 200 表2 响应Body参数 参数 参数类型 描述 total_count Integer 总数 tde_seals_image Array of tde_seals_image objects 印章图片信息列表 表3 tde_seals_image 参数 参数类型 描述 image_id String 图片ID img_name String 图片名称 状态码: 400 表4 响应Body参数 参数 参数类型 描述 error_code String 错误码 最小长度:1 最大长度:20 error_msg String 错误描述 最小长度:1 最大长度:512
  • 请求参数 表2 请求Body参数 参数 是否必选 参数类型 描述 charge_type 否 String 存证类型, normal:普通存证 最小长度:1 最大长度:32 name 否 String 存证名称,默认为文件名称 最小长度:4 最大长度:255 file_hash 否 String 文件hash值。 最小长度:64 最大长度:64 platform_name 否 String 平台名称,用户定义的平台名称 最小长度:0 最大长度:255 data_type 否 Integer 存证的文件类型,1:文件类型2:图片类型3:视频类型4:音频类型5:其他 枚举值: 1 2 3 4 5
  • 响应示例 状态码: 200 success { "tx_id" : "e5e967bb14f97734c9957560267357ee916918bd5dd5130e30fe6e88ca2c76df", "ev_id" : "7484b9b5b4bc11ed87c64a2b0e716f7e" } 状态码: 400 Error response { "error_code" : "TDE.40000400", "error_msg" : "InvokeReq params invalid" } 状态码: 401 Error response { "error_code" : "TDE.40100401", "error_msg" : "unauthorized user" } 状态码: 403 Error response { "error_code" : "TDE.40300403", "error_msg" : "c59b99a1-32e8-11ef-8e12-0255ac100037 chainID does not exist" } 状态码: 500 Error response { "error_code" : "TDE.50010010", "error_msg" : "Internal error" } { "error_code" : "TDE.50010019", "error_msg" : "c59b99a1-32e8-11ef-8e12-0255ac100037 chainID status is Unavailable" } { "error_code" : "TDE.50004001", "error_msg" : "db query error" } { "error_code" : "TDE.50010011", "error_msg" : "the file hash already exist" }
共100000条