文档首页/ 数字资产链 DAC/ API参考/ API/ 可信存证（专享版）/ 存证管理/ 添加存证 - AddEvidence
更新时间：2025-11-18 GMT+08:00
查看PDF
分享

添加存证 - AddEvidence

功能介绍

添加存证。注意：只对文件Hash值上链，不对原文进行报送，Hash值需要用户本地生成并保证正确性，请使用SM3算法。

授权信息

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

URI

POST /v1/{project_id}/chains/{chain_id}/evidences

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

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

chain_id

是

String

数字资产链实例ID

请求参数

表2 请求Body参数

参数

是否必选

参数类型

描述

charge_type

否

String

存证类型, normal:普通存证

name

否

String

存证名称，默认为文件名称

file_hash

否

String

文件hash值。

platform_name

否

String

平台名称，用户定义的平台名称

data_type

否

Integer

存证的文件类型，1:文件类型2:图片类型3:视频类型4:音频类型5:其他

响应参数

状态码：200

表3 响应Body参数

参数

参数类型

描述

tx_id

String

交易ID, 64位哈希值

ev_id

String

存证ID

状态码：400

表4 响应Body参数

参数

参数类型

描述

error_code

String

错误码

error_msg

String

错误描述

状态码：401

表5 响应Body参数

参数

参数类型

描述

error_code

String

错误码

error_msg

String

错误描述

状态码：403

表6 响应Body参数

参数

参数类型

描述

error_code

String

错误码

error_msg

String

错误描述

状态码：500

表7 响应Body参数

参数

参数类型

描述

error_code

String

错误码

error_msg

String

错误描述

请求示例

{
  "charge_type" : "normal",
  "name" : "test.pgn",
  "file_hash" : "501da8f081152990fe2e896f83124a0dc55f1562fe5fc67ede08332a082cb410",
  "platform_name" : "test",
  "data_type" : 1
}

响应示例

状态码：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"
}

状态码

状态码

描述

200

success

400

Error response

401

Error response

403

Error response

500

Error response
父主题： 存证管理

相关文档