存证回调接口

接口描述

存证回调接口

请求路径

/v1/callback/{appid}

请求方式

POST

请求参数

Header

参数名	参数值	必填	描述
Content-Type	application/json	Y	body传递json格式参数

Param

参数名	类型	必选	描述
appid	String	Y	联系运营人员

Body

参数名	类型	必选	描述
outTradeNo	String	Y	进件序列号
certificationInfos	String	Y	存证凭证json数组

certificationInfos字段说明

参数名	类型	必选	描述
cerNo	String	N	cerNo 与 cerLink 二选一 区块链统一存证编号
cerLink	String	N	cerNo 与 cerLink 二选一 存证PDF文件下载地址

请求示例

appid=null
{
	"outTradeNo": "AABB",
	"certificationInfos": "[{\"cerNo\":\"200245020\",\"cerLink\":\"http:www.baidu.com\"}]"
}

返回参数

参数名	类型	必选	描述
code	Integer	Y	200成功，不等于200都是失败
msg	String	N	失败原因
data	String	N	返回数据
requestId	String	N	请求ID

返回示例

{
    "code": 0,
    "msg": "",
    "data": "",
    "requestId": ""
}

Protocol Buffers 定义

以下是使用 protobuf 格式定义的请求和响应消息结构：

syntax = "proto3";

package api;

// 存证凭证信息
message CertificationInfo {
  optional string cerNo = 1;    // 区块链统一存证编号 (cerNo 与 cerLink 二选一)
  optional string cerLink = 2;   // 存证PDF文件下载地址 (cerNo 与 cerLink 二选一)
}

// 存证回调请求
message CallbackRequest {
  string outTradeNo = 1;           // 进件序列号 (必填)
  string certificationInfos = 2;   // 存证凭证json数组 (必填)
}

// 存证回调响应
message CallbackResponse {
  int32 code = 1;          // 200成功，不等于200都是失败 (必填)
  optional string msg = 2;          // 失败原因 (可选)
  optional string data = 3;        // 返回数据 (可选)
  optional string requestId = 4;    // 请求ID (可选)
}

使用方可以通过以上 proto 定义快速生成相应的代码结构和类型定义。