附件3.全国工程质量安全监管信息平台电子证照数据交换接口规范（V2.0）.doc

附件3

全国工程质量安全监管信息平台

电子证照数据交换接口规范

（V2.0）

2022年08月

文档修订历史

序号

版本

修订日期

修改记录

1

1.0

2022-07

全国工程质量安全监管信息平台电子证照数据交换接口规范（试运行）

2

1.1

2022-08

调整“业务数据校验接口”返回值

调整“业务数据赋码接口”返回值

3

1.2

2022-11

新增安管人员“业务数据校验接口”

新增安管人员“业务数据赋码接口”

新增安管人员“电子证照文件归集接口”

4

1.3

2022-12

1、调整安管人员“证书状态代码表”，新增项：07-吊销

2、调整安管人员“业务数据赋码接口”，添加技术职称、文化程度的必填条件描述

5

1.4

2023-01

1、调整“证书状态与操作类型关系代码表”

2、特种人员“工种类别描述”字段的补充说明

3、安管人员“证书状态描述”字段的补充说明

4、添加接口单次上传上限50条的说明

6

1.5

2023-02

新增三本证的“数据更正接口”

按照业务归类完善整体接口内容结构

按照业务归类对代码表进行调整，增加安管人员字典表

7

1.6

2023-03

1、调整接口参数形式分层级展示，调整请求参数和返回结果参数和对应示例

2、调整“数据更正接口”字段，增加更正字段：证书状态

8

1.7

2023-04

1、按照三本证电子证照标准调整接口参数的说明

2、调整三本证接口返回结果参数说明

3、新增特种人员、安管人员证件号码变更接口

9

2.0

2023-05

1、调整校验接口请求参数，增加必要性关键字段

2、新增证书状态变更接口，更新状态使用场景说明

3、根据业务场景提供三本证调用接口详细说明，流程指南

增加业务规则校验和接口调整内容

目录

TOC\o1-3\h\z\u26827一、概述 1

84611.1、目的 1

148411.2、参考资料 1

211971.3、基本术语 1

90791.3.1、资源请求方 1

200251.3.2、资源提供方 1

279431.3.3、服务API 1

47201.3.4、服务授权 1

156901.4、参数类型说明 1

18892二、服务申请流程 2

96082.1、账号开设 2

218202.2、用户个人资料完整 2

269622.3、服务使用登记授权 3

16299三、服务调用流程 7

205403.1、步骤一、获取认证token 7

167433.2、步骤二、上传资源数据 8

113283.3、Java代码参考示例 8

317073.4、标准代码定义 10

15115四、二维码赋码加解密 11

61804.1、二维码赋码密文解密方法 11

7104.1.1、解密流程图 11

18674.1.2、import引用 11

35674.1.3、解密方法 11

228114.1.4、解密结果示例 13

182434.1.5、说明 13

17804.2、二维码赋码明文加密方法 13

322104.2.1、加密流程图 13

148704.2.2、import引用 13

68184.2.3、加密方法 14

43884.2.4、加密结果示例 15

73204.2.5、说明 15

18173五、对接接口标准 16

216315.1、建筑施工企业安全生产许可证 16

279275.1.1、业务数据校验接口 17

272325.1.2、业务数据赋码接口 21

158765.1.3、证书状态变更接口 27

160125.1.4、电子证照文件归集接口 30

288725.1.5、数据更正接口 33

30795.2、建筑施工特种作业操作资格证书 39

317795.2.1、业务数据校验接口 40

79885.2.2、业务数据赋码接口 44

289345.2.3、证书状态变更接口 51

191825.2.4、电子证照文件归集接口 54

35275.2.5、数据更正接口 57

223985.2.6、证件号码变更接口（临时接口按需开放、关闭） 63

306665.3、建筑施工企业安全生产管理人员考核合格证书 67

168945.3.1、业务数据校验接口 69

142795.3.2、业务数据赋码接口 74

61955.3.3、证书状态变更接口 81

135125.3.4、电子证照文件归集接口 85

235295.3.5、数据更正接口 88

32255.3.6、证件号码变更