接口描述
创建一条证据链记录,并获取数据存证编号(证据链ID),后期可以向该条证据链中继续追加证据点。
一条证据链上最多可追加100个证据点
接口地址&请求方法
接口地址:https://{host}/v3/evidence/evi-chain/create
请求方法:POST
请求头格式
具体请求头参数,请查看公共请求头格式。
请求参数
展开全部参数参数名称 | 参数类型 | 必选 | 参数位置 | 参数说明 | |
templateId | string | 是 | body | 证据链模板ID(证据链模板ID,请点击获取) | |
name | string | 是 | body | 证据链名称 | |
points | array | 否 | body | 证据点列表 | |
eviPointType | int | 否 | body | 证据点类型 (1)0 代表创建证据点时返回的eviPointId(P或H开头的); (2)1 代表e签宝电子签名SDK签署成功时返回的signServiceId(签署记录ID); (3)3 代表e签宝实名认证服务成功时返回的serviceId或者flowId(认证流程ID) (4)5 代表e签宝电子签名SaaS API 系列产品签署成功的流程flowId/signFlowId(签署流程ID) | |
eviPointId | string | 否 | body | 证据点编码或其他流程ID(根据证据点类型决定) |
响应参数
展开全部参数参数名称 | 参数类型 | 必选 | 参数说明 | |||
code | int32 | 是 | 业务码,0表示成功,非0表示异常。 | |||
message | string | 否 | 业务信息 请根据 code 来判断错误情况,不应该依赖 message 匹配,因为 message 可能会调整。 | |||
data(点击“+”展开详情) | object | 否 | 业务数据 | |||
eviChainId | string | 是 | 证据链ID/数据存证编号( 以C开头) | |||
billPointIdCount | int | 否 | 计费的证据点数量 注:当证据点类型(eviPointType)是1、3、5时需要单独计算这个证据点的费用,该参数返回计费的证据点数量 | |||
billPoints | array | 否 | 计费的证据点编号信息 注:当证据点类型(eviPointType)是1、3、5时需要单独计算这个证据点的费用,该参数返回计费的证据点编号信息 | |||
eviPointId | string | 否 | 计费的证据点编码或其他流程ID | |||
eviPointType | int | 否 | 计费的证据点类型 |
请求示例
{
"name": "测试",
"templateId": "aaaaaa4-0001-aaaa-aaaa-aaaaaaaaaaa",
"points": [
{
"eviPointType": 0,
"eviPointId": "P19121111577330769927"
},
{
"eviPointType": 1,
"eviPointId": "3859711175753611277"
}
]
}
响应示例
{
"code": 0,
"message": null,
"data": {
"eviChainId": "C1912437977783709696",
"billPointIdCount": 1,
"billPoints": [
{
"eviPointId": "3859711175753611277",
"eviPointType": 1
}
]
}
}