全国工程质量安全监管信息平台建筑起重机械备案证电子证照数据交换接口规范(试运行)V1.0

附件3

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

建筑起重机械备案证

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

（试运行）

二〇二四年十月

文档修订历史

序号

版本

修订日期

修改记录

1

V1.0

2024-10-23

初稿

目次

TOC\o"1-3"\h\z\uHYPERLINK\l"_Toc29953"1概述PAGEREF_Toc29953\h1

HYPERLINK\l"_Toc21484"1.1范围PAGEREF_Toc21484\h1

HYPERLINK\l"_Toc10931"1.2数据类型和格式PAGEREF_Toc10931\h1

HYPERLINK\l"_Toc13558"2对接联调流程PAGEREF_Toc13558\h1

HYPERLINK\l"_Toc28379"2.1整体流程PAGEREF_Toc28379\h1

HYPERLINK\l"_Toc27092"2.2获取授权PAGEREF_Toc27092\h2

HYPERLINK\l"_Toc9948"2.3测试联调PAGEREF_Toc9948\h2

HYPERLINK\l"_Toc11800"2.4检查验证PAGEREF_Toc11800\h2

HYPERLINK\l"_Toc17628"2.5正式上线PAGEREF_Toc17628\h2

HYPERLINK\l"_Toc1243"3对接加解密流程PAGEREF_Toc1243\h2

HYPERLINK\l"_Toc23274"3.1赋码结果解密方法PAGEREF_Toc23274\h3

HYPERLINK\l"_Toc28105"3.1.1结构说明PAGEREF_Toc28105\h3

HYPERLINK\l"_Toc12407"3.1.2解密流程图PAGEREF_Toc12407\h3

HYPERLINK\l"_Toc1849"3.1.3import引用PAGEREF_Toc1849\h4

HYPERLINK\l"_Toc13441"3.1.4解密方法PAGEREF_Toc13441\h4

HYPERLINK\l"_Toc11818"3.1.5解密结果示例PAGEREF_Toc11818\h5

HYPERLINK\l"_Toc14877"3.2查询二维码加密方法PAGEREF_Toc14877\h6

HYPERLINK\l"_Toc29483"3.2.1结构说明PAGEREF_Toc29483\h6

HYPERLINK\l"_Toc6721"3.2.2加密流程图PAGEREF_Toc6721\h6

HYPERLINK\l"_Toc13166"3.2.3import引用PAGEREF_Toc13166\h6

HYPERLINK\l"_Toc27908"3.2.4加密方法PAGEREF_Toc27908\h7

HYPERLINK\l"_Toc24480"3.2.5加密结果示例PAGEREF_Toc24480\h8

HYPERLINK\l"_Toc23974"4业务场景说明PAGEREF_Toc23974\h8

HYPERLINK\l"_Toc1585"4.1业务场景实现PAGEREF_Toc1585\h8

HYPERLINK\l"_Toc30759"4.2证书状态约束PAGEREF_Toc30759\h9

HYPERLINK\l"_Toc9525"4.3业务校验规则PAGEREF_Toc9525\h9

HYPERLINK\l"_Toc1069"5接口说明PAGEREF_Toc1069\h10

HYPERLINK\l"_Toc10251"5.1获取认证token接口PAGEREF_Toc10251\h10

HYPERLINK\l"_Toc24718"5.1.1接口功能PAGEREF_Toc24718\h10

HYPERLINK\l"_Toc22371"5.1.2接口使用说明PAGEREF_Toc22371\h10

HYPERLINK\l"_Toc11193"5.1.3接口调用示例代码PAGEREF_Toc11193\h12

HYPERLINK\l"_Toc30308"5.2设备唯一编号查验接口PAGEREF_Toc30308\h12

HYPERLINK\l"_Toc10447"5.2.1接口功能PAGEREF_Toc10447\h12

HYPERLINK\l"_Toc24055"5.2.2接口使用说明PAGEREF_Toc24055\h12

HYPERLINK\l"_Toc3636"5.3业务办理初步校验接口PAGEREF_Toc3636\h14

HYPERLINK\l"_Toc12170"5.3.1接口功能PAGEREF_Toc12170\h14

HYPERLINK\l"_Toc4565"5.3.2接口使用说明PAGEREF_Toc4565\h14

HYPERLINK\l"_Toc17091"5.4业务数据校验接口PAGEREF_Toc17091\h18

HYPERLINK\l"_Toc26745"5.4.1接口功能PAGEREF_Toc26745\h18

HYPERLINK\l"_Toc19968"5.4.2接口使用说明PAGEREF_Toc19968\h18

HYPERLINK\l"_Toc22752"5.5电子证照赋码接口PAGEREF_Toc22752\h27

HYPERLINK\l"_Toc1940"5.5.1接口功能PAGEREF_Toc1940\h27

HYPERLINK\l"_Toc18546"5.5.2接口使用说明PAGEREF_Toc18546\h27

HYPERLINK\l"_Toc11802"5.6电子证照文件归集接口PAGEREF_Toc11802\h37

HYPERLINK\l"_Toc5837"5.6.1接口功能PAGEREF_Toc5837\h37

HYPERLINK\l"_Toc6244"5.6.2接口使用说明PAGEREF_Toc6244\h37

HYPERLINK\l"_Toc1661"5.7业务信息变更接口39

HYPERLINK\l"_Toc12742"5.7.1接口功能PAGEREF_Toc12742\h40

HYPERLINK\l"_Toc9368"5.7.2接口使用说明PAGEREF_Toc9368\h40

HYPERLINK\l"_Toc11728"5.8证书状态变更接口PAGEREF_Toc11728\h45

HYPERLINK\l"_Toc28181"5.8.1接口功能PAGEREF_Toc28181\h45

HYPERLINK\l"_Toc22189"5.8.2接口使用说明PAGEREF_Toc22189\h46

HYPERLINK\l"_Toc10527"5.9业务数据更正接口PAGEREF_Toc10527\h49

HYPERLINK\l"_Toc13260"5.9.1接口功能PAGEREF_Toc13260\h49

HYPERLINK\l"_Toc22958"5.9.2接口使用说明PAGEREF_Toc22958\h50

HYPERLINK\l"_Toc29307"附录APAGEREF_Toc29307\h59

HYPERLINK\l"_Toc2197"A.1返回结果代码PAGEREF_Toc2197\h59

HYPERLINK\l"_Toc17888"A.2操作类型代码PAGEREF_Toc17888\h59

HYPERLINK\l"_Toc2426"A.3施工升降机用途类型代码PAGEREF_Toc2426\h59

HYPERLINK\l"_Toc2726"A.4其他起重机械类型代码PAGEREF_Toc2726\h59

HYPERLINK\l"_Toc10215"A.5是否代码PAGEREF_Toc10215\h60

HYPERLINK\l"_Toc8136"附录BPAGEREF_Toc8136\h61

HYPERLINK\l"_Toc29542"B.1Java代码参考示例PAGEREF_Toc29542\h61

HYPERLINK\l"_Toc2104"B.2接口响应结果说明PAGEREF_Toc2104\h63

HYPERLINK\l"_Toc5745"B.3接口返回值说明PAGEREF_Toc5745\h64

概述

范围

本文档规定了各省建筑起重机械备案证电子证照系统接入全国工程质量安全监管信息平台（以下简称“全国质量安全平台”）进行电子证照数据共享归集的相关技术规范和数据共享联调实施流程。

本文档适用于指导各省级建筑起重机械备案证电子证照系统技术人员开展与全国质量安全平台对接联调。

数据类型和格式

对于请求入参和出参的数据类型，采用缩略语表示。

数据类型

格式说明

C

表示字符型，包含汉字、字母字符（a～z，A～Z）、数字和符号等，若长度固定2，可用C2表示，其他类同

C..ul

表示长度不确定的文本，若不超过长度200，可用C..200表示，其他类同

N

表示数值型，用“0”到“9”数字形式表示的数值（包括整型数和实型数），可进行数学运算。若作为逻辑型使用0：否；1：是，若长度固定1，可用N1表示，其他类同

N1..ul,ul

表示长度不确定的数值，若长度1，且不超过3，可用N1..3表示，其他类同

如果数值需要明确精度数值，若精度为2位，可用N1..3,2表示，其他类同

D

日期型，按照GB/T7408中规定的YYYYMMDD格式

DT

日期时间型，按照GB/T7408中规定的YYYYMMDDThhmmss格式

对接联调流程

整体流程

由各省级主管部门提交对接申请，经部级审核确认完成接口应用服务授权，同时提供相关资料文档用于指导对接联调。省级技术人员应按照应用场景调用服务API进行数据共享交换，部级平台技术负责人按照检查清单checklist逐项检查，待全部通过联调测试后，方可切换正式上线，具体流程见图1。

图1对接联调流程

获取授权

由各省级主管部门按要求填写《接口服务授权申请表》，部级对接入申请表进行审核，确认信息无误后予以授权，将测试阶段的应用标识（AppKey/client_i