创建存证 - BSN官方算力中心OpenAPI

用于创建存证

请求参数

Header 参数

apitoken

string

apitoken

必需

Body 参数application/json

additionalData

object

可选

自定义数据(Map类型的自定义数据，将直接展示在存证证书中，目前支持最多添加7组Key和Value，每组Key的长度不超过32字符，每组key+Value的总长度不超过62字符，7组自定义数据长度总和不超过233字符。)

示例值:

{"name":"张三","age":20}

depositDesc

string

存证描述

可选

示例值:

图片存证

depositHash

string

存证哈希

必需

示例值:

941cdaeadf8011cd75db01394ce45ce6e16446958e6b1ccaa6515f073e058414

opbChainId

integer <int64>

必需

链标识(调用“开放联盟链框架查询”接口查询)

示例值:

userTradeCode

string

用户第三方流水号

可选

示例值:

123456789012345678901

示例

{
  "additionalData": "{\"name\":\"张三\",\"age\":20}",
  "depositDesc": "图片存证",
  "depositHash": "941cdaeadf8011cd75db01394ce45ce6e16446958e6b1ccaa6515f073e058414",
  "opbChainId": 3,
  "userTradeCode": "123456789012345678901"
}

返回响应

🟢200成功

*/*

Body

code

integer <int32>

必需

成功：0，失败：-1

示例值:

data

object (OutDepositCreateSave)

可选

txNo

string

可选

存证交易流水号（需使用该流水号查询存证结果）

示例值:

30032411191056299045187887256

userTradeCode

string

用户第三方流水号

可选

示例值:

123456789012345678901

errorLogCode

string

必需

此标记同时写入到日志文件中，方便查找

示例值:

message

string

必需

都是消息编码，前端自行国际化处理

示例值:

portalToken

string

可选

凭此token可以访问共享接口，返回空则表示无法使用

示例值:

portaltoken

示例

{
  "code": 0,
  "data": {
    "txNo": "30032411191056299045187887256",
    "userTradeCode": "123456789012345678901"
  },
  "errorLogCode": "0",
  "message": "0",
  "portalToken": "portaltoken"
}

🟢201成功

🟠401没有权限

🟠403禁止访问

🟠404记录不存在