查询存证 - BSN官方算力中心OpenAPI

根据交易流水号查询存证结果

请求参数

Header 参数

apitoken

string

apitoken

必需

Body 参数application/json

opbChainId

integer <int64>

必需

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

示例值:

txNo

string

存证交易流水号

可选

示例值:

30032411281059466463481569281

userTradeCode

string

用户第三方流水号

可选

示例值:

30022411281059466463473180672

示例

{
  "opbChainId": 3,
  "txNo": "30032411281059466463481569281",
  "userTradeCode": "30022411281059466463473180672"
}

返回响应

🟢200成功

*/*

Body

code

integer <int32>

必需

成功：0，失败：-1

示例值:

data

object (OutDepositSearchByTxHash)

可选

additionalData

object

自定义数据

必需

示例值:

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

blockHeight

integer <int64>

区块

必需

示例值:

depositDesc

string

存证描述

必需

示例值:

图片存证

depositHash

string

存证哈希

必需

示例值:

941cdaeadf8011cd000b01394ce45ce6e16446958e6b1ccaa6515f073e058414

depositId

string

存证id

必需

示例值:

30012411281059466463481569280

failMessage

string

失败原因

可选

示例值:

敏感词检测不通过

generateDate

object

存证时间

必需

示例值:

2022-03-09 14:41:41

opbChainId

integer <int64>

必需

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

示例值:

status

integer <int32>

必需

0=待处理 1=完成 2=失败 3=处理中

示例值:

txHash

string

交易哈希

必需

示例值:

0x208e2b20e17bd09e3e8e8db0c9946f6ccc8d2e99100b0c9c3daa96b0355b4706

url

string

存证查询的url

可选

示例值:

https://slzx.ddc.bsnbase.com/deposit-querys/querys?timeOut=500&depositIdOrHash=30012411281059466463481569280

errorLogCode

string

必需

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

示例值:

message

string

必需

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

示例值:

portalToken

string

可选

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

示例值:

portaltoken

示例

{
  "code": 0,
  "data": {
    "additionalData": "{\"name\":\"张三\",\"age\":20}",
    "blockHeight": 33,
    "depositDesc": "图片存证",
    "depositHash": "941cdaeadf8011cd000b01394ce45ce6e16446958e6b1ccaa6515f073e058414",
    "depositId": "30012411281059466463481569280",
    "failMessage": "敏感词检测不通过",
    "generateDate": "2022-03-09 14:41:41",
    "opbChainId": 3,
    "status": 1,
    "txHash": "0x208e2b20e17bd09e3e8e8db0c9946f6ccc8d2e99100b0c9c3daa96b0355b4706",
    "url": "https://slzx.ddc.bsnbase.com/deposit-querys/querys?timeOut=500&depositIdOrHash=30012411281059466463481569280"
  },
  "errorLogCode": "0",
  "message": "0",
  "portalToken": "portaltoken"
}

🟢201成功

🟠401没有权限

🟠403禁止访问

🟠404记录不存在