水利水电工程施工企业安全生产管理人员考核合格证书电子证照系统对接接口示例、电子证照特殊说明.pdfVIP

附录A

（资料性）

水利水电工程施工企业安全生产管理人员考核合格证书电子证照系对接接口示例

A.1接口使用说明

A.1.1返回值一格式

表A.1返回值一格式

参数名类型说明

successbool状态true或false

dataobject()

msgstring提示信息

statusint状态码

timestampslong时间戳

A.1.2请求参数

对于POST请求且contcntTypc=applicationyjson;charsct=UT-8的接口，系通过使用

appKey/appSecret对称加密的方式来验证某个请求的发送者身份。appKey用于标识调用者身份（每个发

证机关分对应不同的appKey）,appSecrel是调用者用于加密请求BODY和电子证照系用来验证签名

字符串的密钥，其中叩pSecrel必须保密。当项目需要向电子证照系发送请求时，需要以请求的byle

流作为签名字符串使用appSccrct进行加密产生签名结果，并将请求byte流设置到HTTP-BODY中。

A.1.3返回参数

系对返回值中的data对象进行整体加密处理，需要用叩pSccrct作为密钥来解密后使用。

A.1.4加密说明

签名算法：3DES（ECB/PKCS5Padding）

密钥：项目的appSecret

签名方式：整体签名方式，对请求的HTTP-BODY进行整体签名

编码方式：UT-8

适用接口类型：附录中*开头的接口

A.2*登录接口验（证服务）

A.2.1简要说明

与水利电子证照系对接的系需要先通过电子证照验证服务，获取token令牌。

A.2.2请求URL

/sys/token/signup

A.2.3请求方式

POST

contenlType:application/json;charsel=UT-8

A.2.4头部参数

表A.2登录接口头部参数

参数名类型说明是否必填

appKeystring分配的appKey是

A.2.5请求体

表A.3登录接口请求体

参数名类型说明是否必填