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

SL/TXXX-20XX

PAGE

PAGE14

附录A

（资料性）

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

A.1接口使用说明

A.1.1返回值统一格式

表A.1返回值统一格式

参数名

类型

说明

success

bool

状态true或false

data

object

{}

msg

string

提示信息

status

int

状态码

timestamps

long

时间戳

A.1.2请求参数

对于POST请求且contentType=application/json;charset=UTF-8的接口，系统通过使用appKey/appSecret对称加密的方式来验证某个请求的发送者身份。appKey用于标识调用者身份（每个发证机关分对应不同的appKey），appSecret是调用者用于加密请求BODY和电子证照系统用来验证签名字符串的密钥，其中appSecret必须必威体育官网网址。当项目需要向电子证照系统发送请求时，需要以请求的byte流作为签名字符串使用appSecret进行加密产生签名结果，并将请求byte流设置到HTTP-BODY中。

A.1.3返回参数

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

A.1.4加密说明

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

密钥：项目的appSecret

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

编码方式：UTF-8

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

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

A.2.1简要说明

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

A.2.2请求URL

/sys/token/signup

A.2.3请求方式

POST

contentType:application/json;charset=UTF-8

A.2.4头部参数

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

参数名

类型

说明

是否必填

appKey

string

分配的appKey

是

A.2.5请求体

表A.3登录接口请求体

参数名

类型

说明

是否必填

appKey

string

注册时应用的key

是

appSecret

string

密钥

是

A.2.6返回值

表A.4登录接口返回值

参数名

类型

说明

success

bool

状态true或false

data

object

{

token:

}

msg

string

提示信息

status

int

状态码

timestamps

long

时间戳

A.3*新办接口（数据推送）

A.3.1简要说明

发证时调用此方法。

A.3.2请求URL

/jsec/zj/interface/newEC仅生成文件（前端UKEY盖章时调用）

/jsec/zj/interface/newECSeal生成文件并调用签章系统盖章（未对接签章系统调用此接口会报错，可先调用第一个接口）

A.3.3请求方式

POST

contentType:application/json;charset=UTF-8

A.3.4头部参数

表A.5新办接口头部参数

参数名

类型

说明

是否必填

appToken

string

取登录接口返回值

是

appKey

string

系统key

是

A.3.5请求体

表A.6新办接口请求体

参数名

类型

说明

data

json

水利水电工程施工企业安全生产管理人员考核合格证书电子证照属性（证件等级、发证机关、发证机关代码、发证日期、有效期开始时间、有效期截止时间、姓名、性别、出生日期、证件类型、证件号码等）

A.3.6返回值

表A.7新办接口返回值

参数名

类型

说明

success

bool

状态true或false

data

object

{

file:文件名,

id:文件id,

type:文件类型,

fileExt:文件扩展名,

certId:电子证照唯一标识,

certNum:证照编号,

message:提示信息,

url:“参数串”

}

msg

string

提示信息

status

int

状态码

timestamps

long

时间戳

A.3.7返回示例

示例：

{

status:200,

data:{

file:1,

id:a101ffd510f940b1111111b

type:1,

fileExt:ofd,

certId:005.2.111000000000133111111.111300000001234567.13221351000001.0