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

添加存证

功能介绍

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

URI

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

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

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

最小长度：32

最大长度：64

chain_id

是

String

数字资产链实例ID

最小长度：32

最大长度：64

请求参数

表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

表3 响应Body参数

参数

参数类型

描述

tx_id

String

交易ID, 64位哈希值

最小长度：64

最大长度：64

ev_id

String

存证ID

最小长度：0

最大长度：64

状态码： 400

表4 响应Body参数

参数

参数类型

描述

error_code

String

错误码

最小长度：1

最大长度：20

error_msg

String

错误描述

最小长度：1

最大长度：512

状态码： 401

表5 响应Body参数

参数

参数类型

描述

error_code

String

错误码

最小长度：1

最大长度：20

error_msg

String

错误描述

最小长度：1

最大长度：512

状态码： 403

表6 响应Body参数

参数

参数类型

描述

error_code

String

错误码

最小长度：1

最大长度：20

error_msg

String

错误描述

最小长度：1

最大长度：512

状态码： 500

表7 响应Body参数

参数

参数类型

描述

error_code

String

错误码

最小长度：1

最大长度：20

error_msg

String

错误描述

最小长度：1

最大长度：512

请求示例

{
  "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
父主题： 存证管理

相关文档