放心签电子合同蚂蚁链存证API接口
2022-03-01
放心签电子合同蚂蚁链存证API接口
文件存证:通过请求签署完成的合同进行合同原文存证。
文本存证:通过请求其他签署环节原文信息(如:实名认证、意愿认证)进行文本存证。
全链路存证:首次请求文件存证或文本存证会新增一条证据链记录,并返回transactionId。将多个证据点关联到相同的编号ID,即可形成一个完整的证据链条。作为纠纷发生时的电子证据,实现全流程留痕,全链路可信,全节点见证。
核验方法:打开蚂蚁区块链可信存证首页。点击核验中心,进入核验页面,依照提示完成实名后输入存证hash进行核验。
接口信息
描述 | 值 |
---|---|
请求地址 | /evidence/v1/full |
请求方式 | POST |
Content-Type | application/json |
Headers | token=您申请获得的token |
请求参数
参数名称 | 类型 | 必选 | 参数说明 |
---|---|---|---|
evidenceType | string | 否 | 存证类型(1:文本存证,2:文件存证,默认为1) |
transactionId | string | 否 | 存证事务id,标识一组关联的存证链路,首次存证不存在会自动创建,注意:关联的一组存证链路请使用同一个transactionId |
phase | string | 否 | 当前所处存证事务中的阶段,请合作方自行定义-文本存证时必传,注意:文件存证时不须要传,阶段默认就是合同签署 |
content | string | 是 | 文本存证时,表示所存的原文信息(注意:输入值根据实际填写);文件存证时,表示源文件网络地址或者base64值 |
响应参数
参数名称 | 类型 | 参数说明 |
---|---|---|
code | int | 状态码值,10000代表成功 |
data | object | 返回数据 |
msg | string | 返回消息 |
tradeNo | string | 交易单号 |
data参数
参数名称 | 类型 | 参数说明 |
---|---|---|
transactionId | string | 存证事务id,标识一组关联的存证链路,注意:关联的一组存证链路请使用同一个transactionId;合作方请自行存储,后期的流程溯源和出证须要提供此信息 |
hash | string | 本阶段的存证hash,注意:合作方请自行存储,后期的流程溯源和出证须要提供此信息 |
返回状态码说明
状态码 | 说明 |
---|---|
10000 | 成功 |
10004 | token不能为空 |
10005 | token已失效,请重新获取 |
10006 | token非法请重新获取 |
10007 | token签名错误 |
10009 | 服务暂未开通或已关闭 |
10010 | 余额不足,请充值 |
10011 | 服务使用期限已过 |
10012 | 参数缺失 |
99999 | 其他异常,请稍后再试 |