拼接用于查看存证证明的跳转URL

更新时间:2021-07-20 10:09:30

描述

数据存证成功后可以将该链接嵌入到贵司系统中,以方便贵司的客户快速跳转到e签宝的存证证明查看页面浏览存证信息。

开发者需注意:

如果贵司访问存证证明页面Url的时候存在网络访问限制,请放行以下域名:

正式环境域名:eviweb.esign.cn

模拟环境域名:smlcunzheng.esign.cn

请求地址

环境

地址

沙箱环境

https://smlcunzheng.esign.cn/evi-web/static/certificate-info.html

正式环境

https://eviweb.esign.cn/evi-web/static/certificate-info.html

拼接规则

拼接格式如下:

https://测试环境查看地址?id=存证编号&projectId=应用ID&timestamp=时间戳(毫秒级)& reverse= Url访问地址的有效期& type=证件类型& number=证件号码&signature=请求签名值


示例:

https://smlcunzheng.esign.cn/evi-web/static/certificate-info.html?id=C918397270204903425&projectId=1111563517&timestamp=1510987348003&reverse=false&type=CODE_USC&number=591101009HEC6BFG3T&signature=089b1666edf9ca398b70e13a8216020d7f77e86d7f42a6dcdbb837f96044ce08


参数说明如下:

参数名称

必选

参数说明

id

数据存证编号,证据链id

projectId

项目projectId

timestamp

时间戳(毫秒级)<点击查看获取方法>

reverse

Url访问地址的有效期,<见锚点【有效期说明】>

true表示timestamp字段为链接的失效时间

false表示timestamp字段为链接的生效时间

type

证件类型:

ID_CARD:身份证

CODE_ORG:组织机构代码

CODE_USC:社会统一信用代码

CODE_REG:工商注册号

HK_CARD:香港居民来往内地通行证

MO_CARD:澳门居民来往内地通行证

TW_CARD:台湾居民来往大陆通行证

FOR_CARD:护照

number

证件号码

signature

请求签名值<点击查看获取方法>


注意:

signature请求签名值是对【id=存证编号&projectId=应用ID&timestamp=时间戳(毫秒级)& reverse= Url访问地址的有效期& type=证件类型& number=证件号码】拼接得到的字符串用projectSecret值进行HmacSHA256算法计算得到的一个值。

如:字符串【id=C918397270204903425&projectId=1111563517&timestamp=1510987348003&reverse=false&type=CODE_USC&number=591101009HEC6BFG3T】利用projectSecret值进行HmacSHA256计算,获得signature请求签名值089b1666edf9ca398b70e13a8216020d7f77e86d7f42a6dcdbb837f96044ce08

查看方式

将拼接好的跳转Url放入到贵公司页面代码中即可,请根据实际业务需求进行跳转查看。

示例:

<a href="https://smlcunzheng.esign.cn/evi-web/static/certificate-info.html?id=C918397270204903425&projectId=1111563517&timestamp=1510987348003&reverse=false&type=CODE_USC&number=591101009HEC6BFG3T&signature=089b1666edf9ca398b70e13a8216020d7f77e86d7f42a6dcdbb837f96044ce08" target="_blank"> 
  点击查看存证证明
</a>

有效期说明

拼接好的跳转Url有效期计算方式分为两种:

一、自定义失效时间

在拼接跳转Url时把reverse设置为true,此时的timestamp时间戳(毫秒级)就是失效时间,超过这个时间戳后该跳转Url失效无法再进行查看。

二、30分钟后失效

在拼接跳转Url时把reverse设置为false,此时的timestamp时间戳(毫秒级)就是跳转Url生效时间,以这个时间戳开始计算30分钟后该跳转Url失效无法再进行查看。

我要纠错