创建证据链

更新时间:2025-04-17 10:28:06

接口描述

创建一条证据链记录,并获取数据存证编号(证据链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
            }
        ]
    }
}


我要纠错