前言
本文件按照GB/T 1.1—2020《标准化工作导则 第1部分:标准化文件的结构和起草规则》的规定起草。
请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。
本文件由中国民用航空局空管行业管理办公室提出。
本文件由中国民航科学技术研究院归口。
本文件起草单位:中国民用航空局信息中心、民航第二研究所有限公司、北京久其软件股份有限公司、安徽省低空无人机航行服务中心、深圳低空产业发展服务有限公司、海南省低空飞行服务中心有限公司、江苏省低空飞行服务中心、四川省低空空域运行服务中心、成都低空飞行服务有限责任公司、中国交通通信信息中心、广东机场白云信息科技股份有限公司。
本文件主要起草人:孙立超、田东东、邹翔、张晔、王兆星、唐滔、刘欢、秦金梁、朱少杰、杨艺钦、孟杰、杨洁、郝斌、史俊辰、卫晋军、杜平、余沫、张延铭、王夏峥、杨洪宇、牟松。
1 范围
本文件规定了民用无人驾驶航空器综合管理平台与民用无人驾驶航空器航行服务提供方系统之间接口概述、一般要求,以及各类数据接口的通信协议、数据传输、输入参数和输出参数等要求。
本文件适用于民用无人驾驶航空器综合管理平台与民用无人驾驶航空器航行服务提供方系统之间的数据交互。
2 规范性引用文件
下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中,注日期的引用文件,仅该日期对应的版本适用于本文件;不注日期的引用文件,其最新版本(包括所有的修改单)适用于本文件。
GB 46750 民用无人驾驶航空器系统运行识别规范
GB/T 38152 无人驾驶航空器系统术语
MH/T 3030 民用无人驾驶航空器实名登记数据交换接口规范
3 术语和定义
GB 46750、 GB/T 38152、MH/T 3030界定的术语和定义适用于本文件。
4 缩略语
下列缩略语适用于本文件。
CBC:密码分组链接(Cipher Block Chaining)
CGCS2000:2000国家大地坐标系(China Geodetic Coordinate System 2000)
UAS码:民用无人驾驶航空器实名登记标志(Civil Unmanned Aircraft System Registration Mark)
UOM:民用无人驾驶航空器综合管理平台(Civil Unmanned Aircraft Operation Management Platform)
UPIC_MSN:唯一产品识别码或民用无人驾驶航空器序列号 (Unique Product Identification Code / Machine Serial Number)
USS:民用无人驾驶航空器航行服务提供方(Civil Unmanned Aircraft Air Navigation Service Supplier)
WGS-84:世界大地测量系统-1984(World Geodetic System-1984)
5 接口概述
UOM 与 USS 系统数据接口类型包括如下。
a) 实名登记数据接口:主要用于 USS 系统通过 UOM 校验民用无人驾驶航空器(以下简称“无人机”)登记状态,以及查询登记数据等。
b) 操控员资质数据接口:主要用于 USS 系统通过 UOM 校验操控员执照、理论合格证证件状态,以及查询操控员执照、理论合格证证件数据等。
c) 运营许可数据接口:主要用于 USS 系统通过 UOM 校验运营合格证状态,以及查询运营合格证数据等。
d) 运行管理数据接口:主要用于 USS 系统通过 UOM 获取适飞空域数据,发送临时管制空域需求申请数据,查询临时管制空域需求申请审批状态,发送变更/取消临时管制空域需求申请,发送一般/紧急/长期/场内飞行活动申请数据,发送长期飞行活动备案数据,撤回已发送的飞行活动申请,查询已发送的飞行活动申请审批结果及起飞确认批准情况,获取用户直接通过 UOM平台提交的飞行活动申请数据,发送一般/紧急/长期/场内飞行活动起飞确认数据,上报飞行活动降落报告,获取网络式运行识别信息,发送其获取的广播式运行识别信息。
e) 心跳探测接口:主要用于 USS 系统向 UOM 发送心跳探测数据。
UOM 与 USS 系统数据流向关系见图 1。

6 一般要求
报文格式
6.1.1 USS 系统在调用实名登记、操控员资质、运营许可相关数据接口时,应按表 1 规定统一输入报文格式传输。
| 序号 | 字段 | 字段代码 | 字段类型 | 字段长度(byte) | 是否必填 | 是否加密 | 描述及要求 |
| 1 | 单位id | id | String | 36 | 是 | 否 | 单位id |
| 2 | 加密字符串 | body | String | - | 是 | 是 | 加密字符串,来源于接口输入参数加密后字符串,加密使用密钥id |
| 序号 | 字段 | 字段代码 | 字段类型 | 字段长度 (byte) | 是否必填 | 是否加密 | 描述及要求 |
| 1 | 单位id | id | String | 36 | 是 | 否 | 单位id |
| 2 | 数据传输格式 | format | String | 4 | 是 | 否 | 数据传输格式,默认“JSON” |
| 3 | 签名 | sign | String | - | 是 | 否 | 签名值,默认使用SM4签名,签名算法是对数据散列值进行签名 |
| 4 | 请求时间 | timeStamp | String | 19 | 是 | 否 | 发送请求的时间,格式:“yyyy-MM-dd HH:mm:ss” |
| 5 | 接口版本 | version | String | - | 是 | 否 | 调用的接口版本,默认“1.0” |
| 6 | 请求接口类型 | type | Integer | 2 | 是 | 否 | 请求接口类型:1:适飞空域查询;2:临时管制空域需求申请;3:临时管制空域需求申请审批状态查询;4:临时管制空域需求申请变更/取消;5:一般/紧急飞行活动申请;6:长期/场内飞行活动申请;7:长期飞行活动备案;8:飞行活动审批状态查询;9:飞行活动申请撤回;10:飞行活动申请数据获取;11:一般/紧急/长期飞行活动起飞确认;12:场内飞行活动起飞确认;13:飞行活动降落报告;14:网络式运行识别信息获取;15:广播式运行识别信息报送 |
| 7 | 输入参数集 | bizContent | JSON | - | 是 | 否 | 业务输入参数的集合,具体按照对应业务接口输入参数的要求 |
| 8 | 编码格式 | charset | String | 5 | 是 | 否 | 报文编码格式,默认使用“utf-8” |
| 9 | 摘要方式 | signType | String | 3 | 是 | 否 | 数据摘要的方式,默认传入“SM3”(使用SM3获取数据散列值,使用SM4对散列值签名) |
加密、解密
UOM向USS用户提供单位id和密钥id,双方基于该密钥id为数据做加密。加密、解密示例见附录A。
其他要求
除10.14和10.15定义的接口外,运行管理数据接口中所有涉及经纬度的字段,其坐标值应统一采用WGS-84坐标系,并以十进制小数形式传输。
7 实名登记数据接口
根据 UAS 码和 UPIC_MSN 码校验实名登记状态接口
7.1.1 通讯协议
接口应采用https通信协议。
7.1.2 数据传输
数据传输应满足如下要求:
a) 使用 RESTful API 方式,以 JSON 作为数据交换格式;
b) 请求方式:post;
c) 请求头:Content-Type: application/json; charset=utf-8;
d) 请求频率:相同的输入参数请求频率不超过一分钟每次。
7.1.3 输入参数
输入参数应符合表3的要求,接口输入示例见附录B.1.1。
| 序号 | 字段 | 字段代码 | 字段类型 | 字段长度(byte) | 是否必填 | 是否加密 | 描述及要求 |
| 1 | 实名登记标志 | uas | String | 11 | 是 | 否 | 实名登记标志 |
| 2 | 唯一产品识别码/产品序列号 | upicMsn | String | 20 | 是 | 否 | 若没有唯一产品识别码,则使用产品序列号 |
7.1.4 输出参数
输出参数应符合表4和表5的要求,接口输出示例见附录B.1.2。
| 序号 | 字段 | 字段代码 | 字段类型 | 字段长度(byte) | 是否必填 | 是否加密 | 描述及要求 |
| 1 | 响应状态 | code | Integer | 3 | 是 | 否 | 响应状态:200:成功;400:输入参数错误;401:认证失败;403:无权限访问;429:请求过于频繁;500:服务器内部错误 |
| 2 | 描述 | msg | String | - | 是 | 否 | 返回信息描述 |
| 3 | 登记状态 | data | String | - | 是 | 否 | 按照表5实名登记状态 |
| 序号 | 字段 | 字段代码 | 字段类型 | 字段长度(byte) | 是否必填 | 是否加密 | 描述及要求 |
| 1 | 登记状态 | uavState | String | 2 | 是 | 否 | 登记状态:0:正常;3:注销;99:无记录 |
根据 UAS 码和 UPIC_MSN 码查询实名登记数据接口
7.2.1 通讯协议
接口应采用https通信协议。
7.2.2 数据传输
数据传输应满足如下要求:
a) 使用 RESTful API 方式,以 JSON 作为数据交换格式;
b) 请求方式:post;
c) 请求头:Content-Type: application/json; charset=utf-8;
d) 请求频率:相同的输入参数请求频率不超过一分钟每次。
7.2.3 输入参数
输入参数应符合表6的要求,接口输入示例见附录B.2.1。
| 序号 | 字段 | 字段代码 | 字段类型 | 字段长度(byte) | 是否必填 | 是否加密 | 描述及要求 |
| 1 | 实名登记标志 | uas | String | 11 | 是 | 否 | 实名登记标志 |
| 2 | 唯一产品识别码/产品序列号 | upicMsn | String | 20 | 是 | 否 | 若没有唯一产品识别码,则使用产品序列号 |
| 3 | 飞行活动编号 | planId | String | - | 否 | 否 | 在已使用该无人机提交飞行活动申请的情况下,可传入对应的飞行活动申请id以辅助查询实名登记数据 |
7.2.4 输出参数
输出参数应符合表7和表8的要求,接口输出示例见附录B.2.2。
| 序号 | 字段 | 字段代码 | 字段类型 | 字段长度 (byte) | 是否必填 | 是否加密 | 描述及要求 |
| 1 | 响应状态 | code | Integer | 3 | 是 | 否 | 响应状态:200:成功;400:输入参数错误;401:认证失败;403:无权限访问;429:请求过于频繁;500:服务器内部错误 |
| 2 | 描述 | msg | String | - | 是 | 否 | 返回信息描述 |
| 3 | 登记数据 | data | String | - | 是 | 是 | 按照表8实名登记数据。需密钥id解密。若无登记数据,相关字段为空值 |
| 序号 | 字段 | 字段代码 | 字段类型 | 字段长度(byte) | 是否必填 | 是否加密 | 描述及要求 |
| 1 | 登记状态 | uavState | String | 2 | 是 | 否 | 登记状态:0:正常;3:注销;99:无记录 |
| 2 | 用户类型 | uavUserType | String | 1 | 是 | 否 | 无人机拥有者用户类型:0:个人;1:单位 |
| 3 | 无人机类型 | uavType | String | 1 | 是 | 否 | 无人机类型:0:固定翼;1:旋翼航空器;2:多桨或多轴航空器;3:复合翼航空器;4:飞艇;5:其他 |
| 4 | 实名登记标志 | uas | String | 11 | 是 | 否 | 实名登记标志 |
| 5 | 产品名称 | uavName | String | - | 是 | 否 | 产品名称 |
| 6 | 产品型号 | uavModel | String | - | 是 | 否 | 产品型号 |
| 7 | 厂商名称 | uavManufacturer | String | - | 是 | 否 | 生产厂商名称 |
| 8 | 空机重量 | uavEmptyWeight | String | - | 是 | 否 | 空机重量(单位:kg) |
| 9 | 最大起飞重量 | uavMaxWeight | String | - | 是 | 否 | 最大起飞重量(单位:kg) |
| 10 | 姓名 | uavPersonName | String | - | 是 | 否 | 个人拥有者姓名 |
| 序号 | 字段 | 字段代码 | 字段类型 | 字段长度(byte) | 是否必填 | 是否加密 | 描述及要求 |
| 11 | 证件类型 | uavPersonCardType | String | 1 | 是 | 否 | 个人拥有者证件类型:0:身份证;1:港澳居民往来内地通行;2:台湾居民往来大陆通行证;3:护照;4:外国人永久居留身份证;5:港澳居民居住证;6:台湾居民居住证;7:其他证件 |
| 12 | 证件号码 | uavPersonCardNum | String | - | 是 | 否 | 个人拥有者证件号码 |
| 13 | 手机号码 | uavPersonPhone | String | - | 是 | 否 | 个人拥有者手机号码 |
| 14 | 统一社会信用代码 | uavUscCode | String | 18 | 是 | 否 | 单位拥有者统一社会信用代码 |
| 15 | 单位类型 | uavUnitType | String | 6 | 是 | 否 | 单位拥有者类型:010101:营利法人;010201:事业单位;010202:社会团体;010203:基金会;010204:社会服务机构;010205:其他;010301:机关法人;010302:农村集体经济组织法人;010303:城镇农村的合作经济组织法人;010304:基层群众性自治组织法人;010401:非法人组织;0201:国内无人机生产厂商;0202:国外无人机生产厂商 |
| 16 | 单位名称 | uavUnit | String | - | 是 | 否 | 单位拥有者名称 |
| 17 | 单位联系人 | uavUnitContact | String | - | 是 | 否 | 单位拥有者联系人姓名 |
| 18 | 手机号码 | uavUnitPhone | String | - | 是 | 否 | 单位拥有者联系人手机号码 |
7.3.1 通讯协议
接口应采用https通信协议。
7.3.2 数据传输
数据传输应满足如下要求:
a) 使用 RESTful API 方式,以 JSON 作为数据交换格式;
b) 请求方式:post;
c) 请求头:Content-Type: application/json; charset=utf-8;
d) 请求频率:相同的输入参数请求频率不超过一分钟每次。
7.3.3 输入参数
输入参数应符合表9的要求,接口输入示例见附录B.3.1。
| 序号 | 字段 | 字段代码 | 字段类型 | 字段长度(byte) | 是否必填 | 是否加密 | 描述及要求 |
| 1 | 厂商统一社会信用代码 | uscCode | String | 18 | 是 | 否 | 生产厂商统一社会信用代码 |
| 2 | 唯一产品识别码/产品序列号 | upicMsn | String | 20 | 是 | 否 | 若没有唯一产品识别码,则使用产品序列号 |
7.3.4 输出参数
输出参数应符合表10和表11的要求,接口输出示例见附录B.3.2。
| 序号 | 字段 | 字段代码 | 字段类型 | 字段长度(byte) | 是否必填 | 是否加密 | 描述及要求 |
| 1 | 响应状态 | code | Integer | 3 | 是 | 否 | 响应状态:200:成功;400:输入参数错误;401:认证失败;403:无权限访问;429:请求过于频繁;500:服务器内部错误 |
| 2 | 描述 | msg | String | - | 是 | 否 | 返回信息描述 |
| 3 | 登记数据 | data | String | - | 是 | 是 | 按照表11实名登记数据。需密钥id解密。若无登记数据,相关字段为空值 |
| 序号 | 字段 | 字段代码 | 字段类型 | 字段长度(byte) | 是否必填 | 是否加密 | 描述及要求 |
| 1 | 登记状态 | uavState | String | 2 | 是 | 否 | 登记状态:0:正常;3:注销;99:无记录 |
| 2 | 用户类型 | uavUserType | String | 1 | 是 | 否 | 无人机拥有者用户类型:0:个人;1:单位 |
| 3 | 无人机类型 | uavType | String | 1 | 是 | 否 | 无人机类型:0:固定翼;1:旋翼航空器;2:多桨或多轴航空器;3:复合翼航空器;4:飞艇;5:其他 |
| 4 | 实名登记标志 | uas | String | 11 | 是 | 否 | 实名登记标志 |
| 5 | 产品名称 | uavName | String | - | 是 | 否 | 产品名称 |
| 6 | 产品型号 | uavModel | String | - | 是 | 否 | 产品型号 |
| 7 | 厂商名称 | uavManufacturer | String | - | 是 | 否 | 生产厂商名称 |
| 8 | 空机重量 | uavEmptyWeight | String | - | 是 | 否 | 空机重量(单位:kg) |
| 9 | 最大起飞重量 | uavMaxWeight | String | - | 是 | 否 | 最大起飞重量(单位:kg) |
| 10 | 姓名 | uavPersonName | String | - | 是 | 否 | 个人拥有者姓名 |
| 序号 | 字段 | 字段代码 | 字段类型 | 字段长度(byte) | 是否必填 | 是否加密 | 描述及要求 |
| 11 | 证件类型 | uavPersonCardType | String | 1 | 是 | 否 | 个人拥有者证件类型:0:身份证;1:港澳居民往来内地通行;2:台湾居民往来大陆通行证;3:护照;4:外国人永久居留身份证;5:港澳居民居住证;6:台湾居民居住证;7:其他证件 |
| 12 | 证件号码 | uavPersonCardNum | String | - | 是 | 否 | 个人拥有者证件号码 |
| 13 | 手机号码 | uavPersonPhone | String | - | 是 | 否 | 个人拥有者手机号码 |
| 14 | 统一社会信用代码 | uavUscCode | String | 18 | 是 | 否 | 单位拥有者统一社会信用代码 |
| 15 | 单位类型 | uavUnitType | String | 6 | 是 | 否 | 单位拥有者类型:010101:营利法人;010201:事业单位;010202:社会团体;010203:基金会;010204:社会服务机构;010205:其他;010301:机关法人;010302:农村集体经济组织法人;010303:城镇农村的合作经济组织法人;010304:基层群众性自治组织法人;010401:非法人组织;0201:国内无人机生产厂商;0202:国外无人机生产厂商 |
| 16 | 单位名称 | uavUnit | String | - | 是 | 否 | 单位拥有者名称 |
| 17 | 单位联系人 | uavUnitContact | String | - | 是 | 否 | 单位拥有者联系人姓名 |
| 18 | 手机号码 | uavUnitPhone | String | - | 是 | 否 | 单位拥有者联系人手机号码 |
8 操控员资质数据接口
操控员执照数据校验接口
8.1.1 通讯协议
接口应采用https通信协议。
8.1.2 数据传输
数据传输应满足如下要求:
a) 使用 RESTful API 方式,以 JSON 作为数据交换格式;
b) 请求方式:post;
c) 请求头:Content-Type: application/json; charset=utf-8;
d) 请求频率:相同的输入参数请求频率不超过一分钟每次。
8.1.3 输入参数
输入参数应符合表12的要求,接口输入示例见附录B.4.1。
| 序号 | 字段 | 字段代码 | 字段类型 | 字段长度 (byte) | 是否必填 | 是否加密 | 描述及要求 |
| 1 | 姓名 | uavrpName | String | - | 是 | 否 | 操控员姓名 |
| 2 | 证件号码 | uavrpCertNo | String | - | 是 | 否 | 操控员证件号码 |
| 3 | 执照种类 | licenseType | String | 1 | 否 | 否 | 执照种类:0: 小型无人机操控员执照;1: 中型无人机操控员执照;2: 大型无人机操控员执照 |
| 4 | 类别等级 | classRating | String | 1 | 否 | 否 | 类别等级:0: 飞机;1: 垂直起降飞机;2: 旋翼机;3: 倾转旋翼机;4: 飞艇;5: 自由气球;6: 滑翔机;7: 特殊类 |
| 5 | 级别等级 | licenseRating | String | 1 | 否 | 否 | 级别等级:0: 旋翼机—多旋翼;1: 旋翼机—自转旋翼机;2: 旋翼机—直升机;3: 特殊类 |
| 6 | 超视距等级 | bvlosRating | String | 2 | 否 | 否 | 超视距等级:0: 超视距—飞机;1: 超视距—垂直起降飞机;2: 超视距—多旋翼;3: 超视距—自转旋翼机;4: 超视距—直升机;5: 超视距—倾转旋翼机;6: 超视距—飞艇;7: 超视距—自由气球;8: 超视距—滑翔机;9: 超视距—特殊类 |
| 7 | 教员等级 | instructorRating | String | 2 | 否 | 否 | 教员等级:0: 教员—飞机;1: 教员—垂直起降飞机;2: 教员—多旋翼;3: 教员—自转旋翼机;4: 教员—直升机;5: 教员—倾转旋翼机;6: 教员—飞艇;7: 教员—自由气球;8: 教员—滑翔机;9: 教员—型别教员;10: 教员—特殊类 |
8.1.4 输出参数
输出参数应符合表13和表14的要求,接口输出示例见附录B.4.2。
| 序号 | 字段 | 字段代码 | 字段类型 | 字段长度(byte) | 是否必填 | 是否加密 | 描述及要求 |
| 1 | 响应状态 | code | Integer | 3 | 是 | 否 | 响应状态:200:成功;400:输入参数错误;401:认证失败;403:无权限访问;429:请求过于频繁;500:服务器内部错误 |
| 2 | 描述 | msg | String | - | 是 | 否 | 返回信息描述 |
| 3 | 操控员数据 | data | String | - | 是 | 否 | 按照表14 操控员执照状态 |
| 序号 | 字段 | 字段代码 | 字段类型 | 字段长度(byte) | 是否必填 | 是否加密 | 描述及要求 |
| 1 | 执照状态 | state | String | 1 | 是 | 否 | 执照状态:0:无记录;1:有效;2:失效 |
操控员执照数据查询接口
8.2.1 通讯协议
接口应采用https通信协议。
8.2.2 数据传输
数据传输应满足如下要求:
a) 使用 RESTful API 方式,以 JSON 作为数据交换格式;
b) 请求方式:post;
c) 请求头:Content-Type: application/json; charset=utf-8;
d) 请求频率:相同的输入参数请求频率不超过一分钟每次。
8.2.3 输入参数
输入参数应符合表15的要求,接口输入示例见附录B.5.1。
| 序号 | 字段 | 字段代码 | 字段类型 | 字段长度(byte) | 是否必填 | 是否加密 | 描述及要求 |
| 1 | 姓名 | uavrpName | String | - | 是 | 否 | 操控员姓名 |
| 2 | 证件号码 | uavrpCertNo | String | - | 是 | 否 | 操控员证件号码 |
| 3 | 执照种类 | licenseType | String | 1 | 否 | 否 | 执照种类:0:小型无人机操控员执照;1:中型无人机操控员执照;2:大型无人机操控员执照 |
| 4 | 类别等级 | classRating | String | 1 | 否 | 否 | 类别等级:0:飞机;1:垂直起降飞机;2:旋翼机;3:倾转旋翼机;4:飞艇;5:自由气球;6:滑翔机;7:特殊类 |
| 序号 | 字段 | 字段代码 | 字段类型 | 字段长度 (byte) | 是否必填 | 是否加密 | 描述及要求 |
| 5 | 级别等级 | licenseRating | String | 1 | 否 | 否 | 级别等级:0:旋翼机—多旋翼;1:旋翼机—自转旋翼机;2:旋翼机—直升机;3:特殊类 |
| 6 | 超视距等级 | bvlosRating | String | 2 | 否 | 否 | 超视距等级:0:超视距—飞机;1:超视距—垂直起降飞机;2:超视距—多旋翼;3:超视距—自转旋翼机;4:超视距—直升机;5:超视距—倾转旋翼机;6:超视距—飞艇;7:超视距—自由气球;8:超视距—滑翔机;9:超视距—特殊类 |
| 7 | 教员等级 | instructorRating | String | 2 | 否 | 否 | 教员等级:0:教员—飞机;1:教员—垂直起降飞机;2:教员—多旋翼;3:教员—自转旋翼机;4:教员—直升机;5:教员—倾转旋翼机;6:教员—飞艇;7:教员—自由气球;8:教员—滑翔机;9:教员—型别教员;10:教员—特殊类 |
| 8 | 飞行活动编号 | planId | String | - | 否 | 否 | 在已使用该操控员数据提交飞行活动申请的情况下,可传入对应的飞行活动申请id以辅助查询操控员执照数据 |
8.2.4 输出参数
输出参数应符合表16和表17的要求,接口输出示例见附录B.5.2。
| 序号 | 字段 | 字段代码 | 字段类型 | 字段长度(byte) | 是否必填 | 是否加密 | 描述及要求 |
| 1 | 响应状态 | code | Integer | 3 | 是 | 否 | 响应状态:200:成功;400:输入参数错误;401:认证失败;403:无权限访问;429:请求过于频繁;500:服务器内部错误 |
| 2 | 描述 | msg | String | - | 是 | 否 | 返回信息描述 |
| 3 | 操控员执照数据 | data | String | - | 是 | 是 | 按照表17 操控员执照数据。需密钥id解密。若无操控员执照数据,相关字段为空值 |
| 序号 | 字段 | 字段代码 | 字段类型 | 字段长度(byte) | 是否必填 | 是否加密 | 描述及要求 |
| 1 | 执照状态 | state | String | 1 | 是 | 否 | 执照状态:0:无记录;1:有效;2:失效 |
| 2 | 姓名 | uavrpName | String | - | 是 | 否 | 操控员姓名 |
| 3 | 执照编号 | licenseNo | String | - | 是 | 否 | 执照编号 |
| 4 | 签发日期 | issueDate | String | 19 | 是 | 否 | 签发日期,格式:" yyyy-MM-dd HH:mm:ss" |
| 5 | 更新日期 | updateDate | String | 19 | 是 | 否 | 更新日期,格式:" yyyy-MM-dd HH:mm:ss" |
| 6 | 失效日期 | invalidDate | String | 19 | 是 | 否 | 失效日期,格式:" yyyy-MM-dd HH:mm:ss" |
| 7 | 执照种类 | licenseType | String | 1 | 是 | 否 | 执照种类:0:小型无人机操控员执照;1:中型无人机操控员执照;2:大型无人机操控员执照 |
| 8 | 类别等级 | classRating | String | 1 | 是 | 否 | 类别等级:0:飞机;1:垂直起降飞机;2:旋翼机;3:倾转旋翼机;4:飞艇;5:自由气球;6:滑翔机;7:特殊类 |
| 9 | 级别等级 | licenseRating | String | 1 | 是 | 否 | 级别等级:0:旋翼机-多旋翼;1:旋翼机-自转旋翼机;2:旋翼机-直升机;3:特殊类 |
| 10 | 超视距等级 | bvlosRating | String | 2 | 是 | 否 | 超视距等级:0:超视距-飞机;1:超视距-垂直起降飞机;2:超视距-多旋翼;3:超视距-自转旋翼机;4:超视距-直升机;5:超视距-倾转旋翼机;6:超视距-飞艇;7:超视距-自由气球;8:超视距-滑翔机;9:超视距-特殊类 |
| 11 | 教员等级 | instructorRating | String | 2 | 是 | 否 | 教员等级:0:教员-飞机;1:教员-垂直起降飞机;2:教员-多旋翼;3:教员-自转旋翼机;4:教员-直升机;5:教员-倾转旋翼机;6:教员-飞艇;7:教员-自由气球;8:教员-滑翔机;9:教员-型别教员;10:教员-特殊类 |
理论合格证数据校验接口
8.3.1 通讯协议
接口应采用https通信协议。
8.3.2 数据传输
数据传输应满足如下要求:
a) 使用 RESTful API 方式,以 JSON 作为数据交换格式;
b) 请求方式:post;
c) 请求头:Content-Type: application/json; charset=utf-8;
d) 请求频率:相同的输入参数请求频率不超过一分钟每次。
8.3.3 输入参数
输入参数应符合表18的要求,接口输入示例见附录B.6.1。
| 序号 | 字段 | 字段代码 | 字段类型 | 字段长度(byte) | 是否必填 | 是否加密 | 描述及要求 |
| 1 | 姓名 | name | String | - | 是 | 否 | 个人用户姓名 |
| 2 | 证件号码 | certNo | String | - | 是 | 否 | 个人用户证件号码 |
8.3.4 输出参数
输出参数应符合表19和表20的要求, 接口请求及响应示例见附录B.6.2。
| 序号 | 字段 | 字段代码 | 字段类型 | 字段长度(byte) | 是否必填 | 是否加密 | 描述及要求 |
| 1 | 响应状态 | code | Integer | 3 | 是 | 否 | 响应状态:200:成功;400:输入参数错误;401:认证失败;403:无权限访问;429:请求过于频繁;500:服务器内部错误 |
| 2 | 描述 | msg | String | - | 是 | 否 | 返回信息描述 |
| 3 | 理论合格证状态 | data | String | - | 是 | 否 | 按照表20 理论合格证状态 |
| 序号 | 字段 | 字段代码 | 字段类型 | 字段长度(byte) | 是否必填 | 是否加密 | 描述及要求 |
| 1 | 证件状态 | state | String | 1 | 是 | 否 | 证件状态:0:无记录;1:有效;2:失效 |
理论合格证数据查询接口
8.4.1 通讯协议
接口应采用https通信协议。
8.4.2 数据传输
数据传输应满足如下要求:
a) 使用 RESTful API 方式,以 JSON 作为数据交换格式;
b) 请求方式:post;
c) 请求头:Content-Type: application/json; charset=utf-8;
d) 请求频率:相同的请求参数请求频率不超过一分钟每次。
8.4.3 输入参数
输入参数应符合表21的要求,接口请求及响应示例见附录B.7.1。
| 序号 | 字段 | 字段代码 | 字段类型 | 字段长度(byte) | 是否必填 | 是否加密 | 描述及要求 |
| 1 | 姓名 | name | String | - | 是 | 否 | 个人用户姓名 |
| 2 | 证件号码 | certNo | String | - | 是 | 否 | 个人用户证件号码 |
| 3 | 飞行活动编号 | planId | String | - | 否 | 否 | 在已使用该个人用户信息提交飞行活动申请的情况下,可传入对应的飞行活动申请id以辅助查询理论合格证数据 |
8.4.4 输出参数
输出参数应符合表22和表23的要求,接口请求及响应示例见附录B.7.2。
| 序号 | 字段 | 字段代码 | 字段类型 | 字段长度(byte) | 是否必填 | 是否加密 | 描述及要求 |
| 1 | 响应状态 | code | Integer | 3 | 是 | 否 | 响应状态:200:成功;400:输入参数错误;401:认证失败;403:无权限访问;429:请求过于频繁;500:服务器内部错误 |
| 2 | 描述 | msg | String | - | 是 | 否 | 返回信息描述 |
| 3 | 理论合格证数据 | data | String | - | 是 | 是 | 按照表23 理论合格证数据。需密钥id解密。若无理论合格证数据,相关字段为空值 |
| 序号 | 字段 | 字段代码 | 字段类型 | 字段长度(byte) | 是否必填 | 是否加密 | 描述及要求 |
| 1 | 证件状态 | state | String | 1 | 是 | 否 | 证件状态:0:无记录;1:有效;2:失效 |
| 2 | 姓名 | name | String | - | 是 | 否 | 姓名 |
| 3 | 性别 | gender | String | 1 | 是 | 否 | 性别:0:女;1:男 |
| 4 | 证件号码 | certNo | String | - | 是 | 否 | 证件号码 |
| 5 | 理论合格证种类 | licenseClass | String | 1 | 是 | 否 | 理论合格证种类:0:固定翼;1:多旋翼 |
| 6 | 证书编号 | licenseNo | String | - | 是 | 否 | 证书编号 |
| 7 | 证件颁发日期 | issueDate | String | 19 | 是 | 否 | 证件颁发日期,格式:"yyyy-MM-dd HH:mm:ss" |
| 8 | 证件失效日期 | invalidDate | String | 19 | 是 | 否 | 证件失效日期,格式:"yyyy-MM-dd HH:mm:ss" |
9 运营许可数据接口
运营合格证数据校验接口
9.1.1 通讯协议
接口应采用https通信协议。
9.1.2 数据传输
数据传输应满足如下要求:
a) 使用 RESTful API 方式,以 JSON 作为数据交换格式;
b) 请求方式:post;
c) 请求头:Content-Type: application/json; charset=utf-8;
d) 请求频率:相同的请求参数请求频率不超过一分钟每次。
9.1.3 输入参数
输入参数应符合表24的要求,接口请求及响应示例见附录B.8.1。
| 序号 | 字段 | 字段代码 | 字段类型 | 字段长度(byte) | 是否必填 | 是否加密 | 描述及要求 |
| 1 | 单位名称 | uavUnitName | String | - | 是 | 否 | 运营单位名称 |
| 2 | 统一社会信用代码 | uavUscCode | String | 18 | 是 | 否 | 运营单位统一社会信用代码 |
9.1.4 输出参数
输出参数应符合表25和表26的要求,M 接口请求及响应示例见附录B.8.2。H
| 序号 | 字段 | 字段代码 | 字段类型 | 字段长度(byte) | 是否必填 | 是否加密 | 描述及要求 |
| 1 | 响应状态 | code | Integer | 3 | 是 | 否 | 响应状态:200:成功;400:输入参数错误;401:认证失败;403:无权限访问;429:请求过于频繁;500:服务器内部错误 |
| 2 | 描述 | msg | String | - | 是 | 否 | 返回信息描述 |
| 3 | 运营合格证状态 | data | String | - | 是 | 否 | 按照表26 运营合格证状态 |
| 序号 | 字段 | 字段代码 | 字段类型 | 字段长度(byte) | 是否必填 | 是否加密 | 描述及要求 |
| 1 | 证件状态 | state | String | 1 | 是 | 否 | 证件状态:0:无记录;1:有效;2:失效 |
运营合格证数据查询接口
9.2.1 通讯协议
接口应采用https通信协议。
9.2.2 数据传输
数据传输应满足如下要求:
a) 使用 RESTful API 方式,以 JSON 作为数据交换格式;
b) 请求方式:post;
c) 请求头:Content-Type: application/json; charset=utf-8;
d) 请求频率:相同的请求参数请求频率不超过一分钟每次。
9.2.3 输入参数
输入参数应符合表27的要求,接口请求及响应示例见附录B.9.1。
| 序号 | 字段 | 字段代码 | 字段类型 | 字段长度(byte) | 是否必填 | 是否加密 | 描述及要求 |
| 1 | 单位名称 | uavUnitName | String | - | 是 | 否 | 运营单位名称 |
| 2 | 统一社会信用代码 | uavUscCode | String | 18 | 是 | 否 | 运营单位单位统一社会信用代码 |
| 3 | 飞行活动编号 | planId | String | - | 否 | 否 | 在已使用该运营单位数据提交飞行活动申请的情况下,可传入对应的飞行活动申请id以辅助查询运营合格证数据 |
9.2.4 输出参数
输出参数应符合表28和表29的要求,接口请求及响应示例见附录B.9.2。
| 序号 | 字段 | 字段代码 | 字段类型 | 字段长度(byte) | 是否必填 | 是否加密 | 描述及要求 |
| 1 | 响应状态 | code | Integer | 3 | 是 | 否 | 响应状态:200:成功;400:输入参数错误;401:认证失败;403:无权限访问;429:请求过于频繁;500:服务器内部错误 |
| 2 | 描述 | msg | String | - | 是 | 否 | 返回信息描述 |
| 3 | 运营合格证数据 | data | String | - | 是 | 是 | 按照表29 运营合格证数据。需密钥id解密。若无运营合格证数据,相关字段为空值 |
| 序号 | 字段 | 字段代码 | 字段类型 | 字段长度 (byte) | 是否必填 | 是否加密 | 描述及要求 |
| 1 | 证件状态 | state | String | 1 | 是 | 否 | 证件状态:0:无记录;1:有效;2:失效 |
| 2 | 证书编号 | certNumber | String | - | 是 | 否 | 证书编号 |
| 3 | 运营人名称 | certOperator | String | - | 是 | 否 | 运营人名称 |
| 4 | 运营人地址 | certAddress | String | - | 是 | 否 | 运营人地址 |
| 5 | 主运行基地 | certPrincipalBase | String | - | 是 | 否 | 主运行基地 |
| 6 | 运行管理联系人 | certContactPerson | String | - | 是 | 否 | 运行管理联系人 |
| 7 | 运行种类 | certCategory | String | - | 是 | 否 | 运行种类:0:留空飞行;1:航线飞行;2:其他飞行若多选,各值之间以英文半角逗号分隔,示例:“0,1,2” |
| 8 | 经营种类 | certCommercial | String | - | 是 | 否 | 经营种类:0:载客类;1:载人类;2:培训类;3:其他类;4:载货类若多选,各值之间以英文半角逗号分隔,示例:“0,1,2” |
| 9 | 签发日期 | certIssuedDate | String | 19 | 是 | 否 | 签发日期,格式:“yyyy-MM-dd HH:mm:ss” |
| 10 | 更新日期 | certReissuedDate | String | 19 | 是 | 否 | 更新日期,格式:“yyyy-MM-dd HH:mm:ss” |
| 11 | 发证机关 | certAuthority | String | - | 是 | 否 | 发证机关 |
10 运行管理数据接口
适飞空域查询接口
10.1.1 通讯协议
接口应采用https通信协议。
10.1.2 数据传输
数据传输应满足如下要求:
a) 使用 RESTful API 方式,以 JSON 作为数据交换格式;
b) 请求方式:post;
c) 请求头:Content-Type: application/json; charset=utf-8;
d) 请求频率:相同的请求参数请求频率不超过一分钟每次。
10.1.3 输入参数
输入参数应符合表30的要求,接口请求及响应示例见附录B.10.1。
| 序号 | 字段 | 字段代码 | 字段类型 | 字段长度(byte) | 是否必填 | 是否加密 | 描述及要求 |
| 1 | 行政区划代码 | distCode | String | 6 | 是 | 否 | 行政区划代码,示例:北京市为"110000"。按行政区划范围提供查询结果,市级为最小查询单元 |
10.1.4 输出参数
输出参数应符合表31和表32的要求,接口请求及响应示例见附录B.10.2。
| 序号 | 字段 | 字段代码 | 字段类型 | 字段长度(byte) | 是否必填 | 是否加密 | 描述及要求 |
| 1 | 响应状态 | code | Integer | 3 | 是 | 否 | 响应状态:200:成功;400:输入参数错误;401:认证失败;403:无权限访问;429:请求过于频繁;500:服务器内部错误 |
| 2 | 描述 | msg | String | - | 是 | 否 | 返回信息描述 |
| 3 | 适飞空域数据 | data | JSON数组 | - | 是 | 否 | 按照表32 适飞空域数据 |
| 序号 | 字段 | 字段代码 | 字段类型 | 字段长度(byte) | 是否必填 | 是否加密 | 描述及要求 |
| 1 | 空域坐标集合 | flyableAirspace | String | - | 是 | 否 | 行政区划范围内适飞空域的经纬度坐标集合。数据格式为字符串,由多个栅格组成,栅格之间用分号";"分隔,每个栅格内由多个坐标点组成,坐标点之间用竖线"|"分隔,每个坐标点的格式为"经度,纬度",示例:"104.359131,30.481567|104.359131,30.487061|104.364624,30.487061|104.364624,30.481567;104.304199,30.481567|104.304199,30.487061|104.309692,30.487061|104.309692,30.481567;" |
临时管制空域需求申请接口
10.2.1 通讯协议
接口应采用https通信协议。
10.2.2 数据传输
数据传输应满足如下要求:
a) 使用 RESTful API 方式,以 JSON 作为数据交换格式;
b) 请求方式:post;
c) 请求头:Content-Type: application/json; charset=utf-8;
d) 请求频率:相同的请求参数请求频率不超过一分钟每次。
10.2.3 输入参数
输入参数应符合表33至表35的要求,接口请求及响应示例见附录B.11.1。
| 序号 | 字段 | 字段代码 | 字段类型 | 字段长度(byte) | 是否必填 | 是否加密 | 描述及要求 |
| 1 | 需求说明 | reqDesc | String | - | 是 | 否 | 说明临时管制空域的用途 |
| 2 | 管制空域集合 | areaList | JSON数组 | - | 是 | 否 | 按照表34 临时管制空域数据 |
| 3 | 申请时间 | applyTime | String | 19 | 是 | 否 | 提交临时管制空域需求的时间,格式:"yyyy-MM-dd HH:mm:ss" |
| 4 | 生效时间 | startTime | String | 19 | 是 | 否 | 临时管制空域生效时间,格式:"yyyy-MM-dd HH:mm:ss" |
| 5 | 失效时间 | endTime | String | 19 | 是 | 否 | 临时管制空域失效时间,格式:"yyyy-MM-dd HH:mm:ss" |
| 6 | 申请单位 | applicantUnit | String | - | 是 | 否 | 申请单位名称 |
| 7 | 统一社会信用代码 | uscc | String | 18 | 是 | 否 | 申请单位统一社会信用代码 |
| 8 | 联系电话 | phone | String | - | 是 | 是 | 手机或座机号码 |
| 9 | 附件 | files | JSON数组 | - | 否 | 否 | 临时管制空域需求申请相关批件,格式按照表35 附件数据。数组长度不大于5 |
| 序号 | 字段 | 字段代码 | 字段类型 | 字段长度 (byte) | 是否必填 | 是否加密 | 描述及要求 |
| 1 | 类型 | areaType | Integer | 1 | 是 | 否 | 临时管制空域类型:1:多边形;2:圆形 |
| 2 | 区域范围 | areaData | String | - | 是 | 是 | 临时管制空域范围格式定义:多边形:格式为“点1经度,纬度|点2经度,纬度|点3经度,纬度......”圆形:格式为“经度,纬度|半径”,半径的单位:m |
| 序号 | 字段 | 字段代码 | 字段类型 | 字段长度(byte) | 是否必填 | 是否加密 | 描述及要求 |
| 1 | 文件名称 | fileName | String | - | 是 | 否 | 文件名称 |
| 2 | 文件后缀 | fileSuffix | String | 3 | 是 | 否 | 文件类型 |
| 3 | 文件编码 | fileData | String | - | 是 | 否 | 文件的Base64编码。文件大小不超过2MB |
10.2.4 输出参数
输出参数应符合表36和表37的要求,接口请求及响应示例见附录B.11.2。
| 序号 | 字段 | 字段代码 | 字段类型 | 字段长度(byte) | 是否必填 | 是否加密 | 描述及要求 |
| 1 | 响应状态 | code | Integer | 3 | 是 | 否 | 响应状态:200:成功;400:输入参数错误;401:认证失败;403:无权限访问;429:请求过于频繁;500:服务器内部错误 |
| 2 | 描述 | msg | String | - | 是 | 否 | 返回信息描述 |
| 3 | 临时管制空域需求编码数据 | data | JSON | - | 是 | 否 | 按照表37 临时管制空域需求编号数据 |
| 序号 | 字段 | 字段代码 | 字段类型 | 字段长度(byte) | 是否必填 | 是否加密 | 描述及要求 |
| 1 | 临时管制空域需求编号 | tempControlReqId | String | - | 是 | 否 | 临时管制空域需求id |
临时管制空域需求申请审批状态查询接口
10.3.1 通讯协议
接口应采用https通信协议。
10.3.2 数据传输
数据传输应满足如下要求:
a) 使用 RESTful API 方式,以 JSON 作为数据交换格式;
b) 请求方式:post;
c) 请求头:Content-Type: application/json; charset=utf-8;
d) 请求频率:相同的请求参数请求频率不超过一分钟每次。
10.3.3 输入参数
输入参数应符合表38的要求,接口请求及响应示例见附录B.12.1。
| 序号 | 字段 | 字段代码 | 字段类型 | 字段长度(byte) | 是否必填 | 是否加密 | 描述及要求 |
| 1 | 临时管制空域需求编号 | tempControlReqId | String | - | 是 | 否 | 临时管制空域需求id |
10.3.4 输出参数
输出参数应符合表39和表40的要求,接口请求及响应示例见附录B.12.2。
| 序号 | 字段 | 字段代码 | 字段类型 | 字段长度(byte) | 是否必填 | 是否加密 | 描述及要求 |
| 1 | 响应状态 | code | Integer | 3 | 是 | 否 | 响应状态:200:成功;400:输入参数错误;401:认证失败;403:无权限访问;429:请求过于频繁;500:服务器内部错误 |
| 2 | 描述 | msg | String | - | 是 | 否 | 返回信息描述 |
| 3 | 临时管制空域需求申请审批数据 | data | JSON | - | 是 | 否 | 按照表40 临时管制空域需求申请审批数据 |
| 序号 | 字段 | 字段代码 | 字段类型 | 字段长度 (byte) | 是否必填 | 是否加密 | 描述及要求 |
| 1 | 临时管制需求编号 | tempControlReqId | String | - | 是 | 否 | 临时管制需求id |
| 2 | 申请状态 | applySts | Integer | 1 | 是 | 否 | 临时管制空域需求申请状态:0:审批中;1:已审批;2:已撤回;3:取消中;4:已取消;5:变更中;6:已变更;7:取消驳回;8:变更驳回 |
| 3 | 审批状态 | auditSts | Integer | 1 | 是 | 否 | 临时管制空域需求审批状态:0:审批中;1:批准;2:不予批准 |
| 4 | 审批意见 | auditDesc | String | - | 否 | 否 | 审批意见 |
| 5 | 审批时间 | auditTime | String | 19 | 否 | 否 | 临时管制空域需求的审批时间,格式:“yyyy-MM-dd HH:mm:ss” |
临时管制空域需求申请变更/取消接口
10.4.1 通讯协议
接口应采用https通信协议。
10.4.2 数据传输
数据传输应满足如下要求:
a) 使用 RESTful API 方式,以 JSON 作为数据交换格式;
b) 请求方式:post;
c) 请求头:Content-Type: application/json; charset=utf-8;
d) 请求频率:相同的请求参数请求频率不超过一分钟每次。
10.4.3 输入参数
输入参数应符合表41的要求,接口请求及响应示例见附录B.13.1和B.13.3。
| 序号 | 字段 | 字段代码 | 字段类型 | 字段长度(byte) | 是否必填 | 是否加密 | 描述及要求 |
| 1 | 临时管制空域需求编号 | tempControlReqId | String | - | 是 | 否 | 临时管制空域需求id |
| 2 | 操作类型 | optType | Integer | 1 | 是 | 否 | 操作类型:0:变更临时管制需求;1:取消临时管制需求;变更临时管制需求时需根据实际情况对非必填的字段进行赋值传输 |
| 3 | 需求说明 | reqDesc | String | - | 否 | 否 | 说明临时管制空域的用途 |
| 4 | 变更/取消时间 | changeTime | String | 19 | 是 | 否 | 变更/取消临时管制空域需求的时间,格式:"yyyy-MM-dd HH:mm:ss" |
| 5 | 生效时间 | startTime | String | 19 | 否 | 否 | 临时管制空域生效时间,格式:"yyyy-MM-dd HH:mm:ss" |
| 6 | 失效时间 | endTime | String | 19 | 否 | 否 | 临时管制空域失效时间,格式:"yyyy-MM-dd HH:mm:ss" |
| 7 | 申请单位 | applicantUnit | String | - | 否 | 否 | 申请单位名称 |
| 8 | 统一社会信用代码 | uscc | String | 18 | 否 | 否 | 申请单位统一社会信用代码 |
| 9 | 联系电话 | phone | String | - | 否 | 是 | 手机或座机号码 |
| 10 | 变更/取消原因 | reason | String | - | 是 | 否 | 临时管制空域需求申请变更/取消的原因说明 |
| 11 | 附件 | files | JSON数组 | - | 否 | 否 | 临时管制空域需求申请变更/取消相关批件,格式按照表35 附件数据。数组长度不大于5 |
10.4.4 输出参数
| 序号 | 字段 | 字段代码 | 字段类型 | 字段长度(byte) | 是否必填 | 是否加密 | 描述及要求 |
| 1 | 响应状态 | code | Integer | 3 | 是 | 否 | 响应状态:200:成功;400:输入参数错误;401:认证失败;403:无权限访问;429:请求过于频繁;500:服务器内部错误 |
| 2 | 描述 | msg | String | - | 是 | 否 | 返回信息描述 |
| 3 | 临时管制空域需求编码数据 | data | JSON | - | 是 | 否 | 按照表37 临时管制空域需求编号数据 |
一般/紧急飞行活动申请接口
10.5.1 通讯协议
接口应采用https通信协议。
10.5.2 数据传输
数据传输应满足如下要求:
a) 使用 RESTful API 方式,以 JSON 作为数据交换格式;
b) 请求方式:post;
c) 请求头:Content-Type: application/json; charset=utf-8;
d) 请求频率:相同的请求参数请求频率不超过五秒每次。
10.5.3 输入参数
输入参数应符合表43至表46的要求,接口请求及响应示例见附录B.14.1。
| 序号 | 字段 | 字段代码 | 字段类型 | 字段长度 (byte) | 是否必填 | 是否加密 | 描述及要求 |
| 1 | 申请时间 | applyTime | String | 19 | 是 | 否 | 一般/紧急飞行活动申请时间,格式:“yyyy-MM-dd HH:mm:ss” |
| 2 | 用户类型 | userType | String | 1 | 是 | 否 | 申请活动的用户类型:1:个人;2:单位 |
| 3 | 申请人 | userName | String | - | 是 | 否 | 申请活动的个人姓名/单位名称 |
| 4 | 证件类型 | personCardType | String | 1 | 否 | 否 | 申请活动的个人证件类型:0:身份证;1:港澳居民往来内地通行证;2:台湾居民往来大陆通行证;3:护照;4:外国人永久居留身份证;5:港澳居民居住证;6:台湾居民居住证;7:其他证件申请用户为个人用户时该字段必填 |
| 5 | 证件号码 | personCardNo | String | - | 否 | 是 | 申请活动的个人证件号码。申请用户为个人用户时该字段必填 |
| 序号 | 字段 | 字段代码 | 字段类型 | 字段长度(byte) | 是否必填 | 是否加密 | 描述及要求 |
| 6 | 单位类型 | deptType | String | 6 | 否 | 否 | 申请活动的单位类型:010101:营利法人;010201:事业单位;010202:社会团体;010203:基金会;010204:社会服务机构;010205:其他;010301:机关法人;010302:农村集体经济组织法人;010303:城镇农村的合作经济组织法人;010304:基层群众性自治组织法人;010401:非法人组织;0201:国内无人机生产厂商;0202:国外无人机生产厂商申请用户为单位用户时该字段必填 |
| 7 | 统一社会信用代码 | deptCode | String | 18 | 否 | 否 | 申请活动的单位统一社会信用代码。申请用户为单位用户时该字段必填 |
| 8 | 联系人 | contactPerson | String | - | 是 | 是 | 申请活动的单位联系人/个人姓名 |
| 9 | 手机号码 | phone | String | - | 是 | 是 | 申请活动的单位联系人/个人手机号码 |
| 10 | 电子邮箱 | String | - | 是 | 是 | 申请活动的单位联系人/个人电子邮箱 | |
| 11 | 飞行活动申请类型 | planType | String | 2 | 是 | 否 | 飞行活动申请类型:11:一般飞行活动申请;12:紧急飞行活动申请;13:特别紧急飞行活动申请申请用户为个人用户时该字段仅可填一般飞行活动申请 |
| 12 | 预计飞行最大高度 | maxHeight | Integer | - | 是 | 否 | 真高,单位:m |
| 13 | 预计开始时刻 | planBeg | String | 19 | 是 | 否 | 飞行活动预计开始时刻,格式:"yyyy-MM-dd HH:mm:ss" |
| 14 | 预计结束时刻 | planEnd | String | 19 | 是 | 否 | 飞行活动预计结束时刻,格式:"yyyy-MM-dd HH:mm:ss" |
| 15 | 通信联络方法 | txll | String | - | 否 | 是 | 进行飞行活动时的联系人联系方式。申请用户为单位用户时该字段必填 |
| 序号 | 字段 | 字段代码 | 字段类型 | 字段长度(byte) | 是否必填 | 是否加密 | 描述及要求 |
| 16 | 任务性质 | M taskType | String | 3 | 是 | 否 | 任务性质,单位用户可申请:载客类(101-102)101:短途运输;102:包机飞行;载人类(111-115)111:石油服务;112:无人机引航;H111111载1培1任请833333345:货训务:23456700个::::::::类类性人空空科气表其载培((质娱中中学象演他货训,1145乐拍广实探飞;类类个00照告验测行););人;;;;;用户可申113:航空医疗救护;114:空中游览;115:跳伞飞行服务;其他类(121-138)121:航空护林;122:城市消防;123:机外载荷飞行;124:人工影响天气;125:航空探矿;126:航空摄影;127:海洋监测;128:渔业飞行;129:空中巡查;130:电力作业;131:航空喷洒(撒); |
| 17 | 操控模式 | optType | String | 1 | 否 | 否 | 操控模式:1:遥控飞行;2:自主飞行申请用户为单位用户时该字段必填 |
| 18 | 飞行模式 | flyType | String | 1 | 否 | 否 | 飞行模式:0:超视距;1:视距内申请用户为单位用户时该字段必填 |
| 序号 | 字段 | 字段代码 | 字段类型 | 字段长度(byte) | 是否必填 | 是否加密 | 描述及要求 |
| 19 | 起降备降场地 | remarkQjbj | String | - | 否 | 否 | 起降备降场地地址,格式示例:"起飞地址|起飞点经度,起飞点纬度|降落地址|降落点经度,降落点纬度|备降地址|备降点经度,备降点纬度"。若无固定起降备降点,以"无|0,0|无|0,0|无|0,0"的格式传输。申请用户为单位用户时该字段必填 |
| 20 | 应急处置程序 | remarkYjcz | String | - | 否 | 否 | 应急处置程序说明。申请用户为单位用户时该字段必填 |
| 21 | 特殊飞行保障需求 | remarkTsxq | String | - | 否 | 否 | 说明特殊飞行保障需求。申请用户为单位用户时该字段必填 |
| 22 | 通导和被监视能力 | remarkTdjn | String | - | 否 | 否 | 通信、导航和被监视能力。申请用户为单位用户时该字段必填 |
| 23 | 飞行速度和进出空域方法 | remarkFxhx | String | - | 否 | 否 | 说明飞行速度和进出空域方法。申请用户为单位用户时该字段必填 |
| 24 | 指挥控制链路无线电频率以及占用带宽 | remarkZhkz | String | - | 否 | 否 | 说明指挥控制链路无线电频率以及占用带宽,若没有相关信息可填"无"。申请用户为单位用户时该字段必填 |
| 25 | 二次雷达应答机或者有关自动监视设备代码 | remarkEcld | String | - | 否 | 否 | 说明二次雷达应答机或者有关自动监视设备代码,若没有相关信息可填"无"。申请用户为单位用户时该字段必填 |
| 26 | 其他 | remarkQtxx | String | - | 否 | 否 | 其他需要补充的必要信息。申请用户为单位用户时该字段必填 |
| 序号 | 字段 | 字段代码 | 字段类型 | 字段长度 (byte) | 是否必填 | 是否加密 | 描述及要求 |
| 27 | 涉及的特殊飞行活动 | involvedSpecialPlan | String | 5 | 否 | 否 | 以5位String类型的字符串传输,按下述1-5的顺序通过“0”或者“1”表示,其中:0:不涉及相关飞行活动;1:涉及相关飞行活动涉及的特殊飞行活动包括,第1类:通过通信基站或者互联网进行无人驾驶航空器中继飞行;第2类:运载危险品或者投放物品(常规农用无人驾驶航空器作业飞行活动除外);第3类:飞越集会人群上空;第4类:在移动的交通工具上操控无人驾驶航空器;第5类:实施分布式操作或者集群飞行。示例:“00000”代表不涉及,“11000”代表涉及第1类和第2类特殊飞行活动,以此类推 |
| 28 | 航空器和操控员列表 | uavAndDriver | JSON数组 | - | 是 | 否 | 按照表44航空器和操控员数据 |
| 29 | 空域 | space | JSON | - | 是 | 否 | 按照表45空域数据 |
| 30 | 任务审批文件 | files | JSON数组 | - | 否 | 否 | 若涉及特殊飞行活动,必须上传任务审批文件;若飞行任务性质为航空摄影,必须上传测绘资质证明。格式按照表46任务审批文件数据。数组长度不大于5 |
| 31 | 预审状态 | preAuditSts | String | - | 是 | 否 | 预审状态:0:未授权;1:通过;2:未通过默认“0”,未授权。若多方参与预审,依次在字符串中拼接预审状态,示例三方参与预审:“112” |
| 32 | 预审意见 | preAuditDesc | String | - | 是 | 否 | 预审意见。默认“无”。预审意见按“单位:意见说明”的形式描述。根据预审状态的字符串组装顺序,依次描述各方预审意见,用“|”分隔,示例:“单位1:同意|单位2:同意|单位3:不同意” |
| 序号 | 字段 | 字段代码 | 字段类型 | 字段长度(byte) | 是否必填 | 是否加密 | 描述及要求 |
| 1 | 唯一产品识别码/产品序列号 | upicMsn | String | 20 | 是 | 否 | 若没有唯一产品识别码,则使用产品序列号 |
| 2 | 实名登记标志 | uas | String | 11 | 是 | 否 | 实名登记标志 |
| 3 | 操控员姓名 | uavrpName | String | - | 是 | 否 | 操控员姓名 |
| 4 | 操控员证件号码(理论培训合格证件号码) | uavrpCertNo | String | - | 是 | 是 | 操控员证件号码(理论培训合格证件号码) |
| 序号 | 字段 | 字段代码 | 字段类型 | 字段长度(byte) | 是否必填 | 是否加密 | 描述及要求 |
| 1 | 空域形状 | spcShape | String | 1 | 是 | 否 | 空域形状:1:多边形;2:圆形;3:线缓冲区 |
| 2 | 坐标 | location | String | - | 是 | 是 | 空域坐标范围格式定义:多边形:格式为"点1经度,纬度|点2经度,纬度|点3经度,纬度"圆形:格式为"经度,纬度|半径",半径的单位:m线缓冲区:格式为"点1经度,纬度|点2经度,纬度|点3经度,纬度|点N经度,纬度|宽度",宽度的单位:m,表示以经纬度点连线为中心,向两侧各扩展宽度值一半所形成的带状区域 |
| 3 | 最小高度 | spcBottom | Integer | - | 是 | 否 | 真高,单位:m,默认"0" |
| 4 | 最大高度 | spcTop | Integer | - | 是 | 否 | 真高,单位:m |
| 5 | 空域编码 | spcCode | String | - | 否 | 否 | 空域编码,编码规则为:空域名称-当前时间(格式:yyyyMMddHHmmss)-4位随机码(数字或字母均可),示例:测试空域-20251105172500-45DF。长期飞行活动申请多空域时,该字段必填;一般/紧急/场内飞行活动申请只支持单空域 |
| 序号 | 字段 | 字段代码 | 字段类型 | 字段长度(byte) | 是否必填 | 是否加密 | 描述及要求 |
| 1 | 文件名称 | fileName | String | - | 是 | 否 | 文件名称 |
| 2 | 文件后缀 | fileSuffix | String | 3 | 是 | 否 | 文件类型 |
| 3 | 文件编码 | fileData | String | - | 是 | 否 | 文件的Base64编码。文件大小不超过2MB |
10.5.4 输出参数
输出参数应符合表47和表48的要求,接口请求及响应示例见附录B.14.2。
| 序号 | 字段 | 字段代码 | 字段类型 | 字段长度(byte) | 是否必填 | 是否加密 | 描述及要求 |
| 1 | 响应状态 | code | Integer | 3 | 是 | 否 | 响应状态:200:成功;400:输入参数错误;401:认证失败;403:无权限访问;429:请求过于频繁;500:服务器内部错误 |
| 2 | 描述 | msg | String | - | 是 | 否 | 返回信息描述 |
| 3 | 飞行活动编号数据 | data | JSON | - | 是 | 否 | 按照表48 飞行活动申请编号数据 |
| 序号 | 字段 | 字段代码 | 字段类型 | 字段长度(byte) | 是否必填 | 是否加密 | 描述及要求 |
| 1 | 飞行活动编号 | planId | String | - | 是 | 否 | 飞行活动申请id |
长期/场内飞行活动申请接口
10.6.1 通讯协议
接口应采用https通信协议。
10.6.2 数据传输
数据传输应满足如下要求:
a) 使用 RESTful API 方式,以 JSON 作为数据交换格式;M
b) 请求方式: post;
c) 请求头: Content-Type: application/json; charset=utf-8;
d) 请求频率:相同的请求参数请求频率不超过五秒每次。
10.6.3 输入参数
输入参数应符合表49的要求, 接口请求及响应示例见附录B.15.1和B.15.2。
| 序号 | 字段 | 字段代码 | 字段类型 | 字段长度(byte) | 是否必填 | 是否加密 | 描述及要求 |
| 1 | 申请时间 | applyTime | String | 19 | 是 | 否 | 长期/场内飞行活动申请时间,格式:"yyyy-MM-dd HH:mm:ss" |
| 2 | 用户类型 | userType | String | 1 | 是 | 否 | 申请飞行活动的用户类型:2:单位只有单位用户可申请 |
| 3 | 申请人 | userName | String | - | 是 | 否 | 申请单位名称 |
| 序号 | 字段 | 字段代码 | 字段类型 | 字段长度(byte) | 是否必填 | 是否加密 | 描述及要求 |
| 4 | 单位类型 | deptType | String | 6 | 是 | 否 | 申请单位类型:010101:营利法人;010201:事业单位;010202:社会团体;010203:基金会;010204:社会服务机构;010205:其他;010301:机关法人;010302:农村集体经济组织法人;010303:城镇农村的合作经济组织法人;010304:基层群众性自治组织法人;010401:非法人组织;0201:国内无人机生产厂商;0202:国外无人机生产厂商 |
| 5 | 统一社会信用代码 | deptCode | String | 18 | 是 | 否 | 申请单位统一社会信用代码 |
| 6 | 联系人 | contactPerson | String | - | 是 | 是 | 申请单位联系人姓名 |
| 7 | 手机号码 | phone | String | - | 是 | 是 | 申请单位联系人手机号码 |
| 8 | 电子邮箱 | String | - | 是 | 是 | 申请单位联系人电子邮箱 | |
| 9 | 飞行活动申请类型 | planType | String | 2 | 是 | 否 | 飞行活动申请类型:21-长期飞行活动申请31-场内飞行活动申请 |
| 10 | 预计飞行最大高度 | maxHeight | Integer | - | 是 | 否 | 真高,单位:m |
| 11 | 预计开始时刻 | planBeg | String | 19 | 是 | 否 | 飞行活动预计开始时刻,格式:"yyyy-MM-dd HH:mm:ss" |
| 12 | 预计结束时刻 | planEnd | String | 19 | 是 | 否 | 飞行活动预计结束时刻,格式:"yyyy-MM-dd HH:mm:ss" |
| 13 | 通信联络方法 | txll | String | - | 是 | 是 | 进行飞行活动时的联系人联系方式 |
| 序号 | 字段 | 字段代码 | 字段类型 | 字段长度 (byte) | 是否必填 | 是否加密 | 描述及要求 |
| 14 | 任务性质 | taskType | String | 3 | 是 | 否 | 任务性质:载客类(101-102)101:短途运输;102:包机飞行;载人类(111-115)111:石油服务;112:无人机引航;113:航空医疗救护;114:空中游览;115:跳伞飞行服务;其他类(121-138)121:航空护林;122:城市消防;123:机外载荷飞行;124:人工影响天气;125:航空探矿;126:航空摄影;127:海洋监测;128:渔业飞行;129:空中巡查;130:电力作业;131:航空喷洒(撒);132:空中拍照;133:空中广告;134:科学实验;135:气象探测;136:表演飞行;137:其他;载货类(140)140:载货类;培训类(150)150:培训类; |
| 15 | 操控模式 | optType | String | 1 | 是 | 否 | 操控模式:1:遥控飞行;2:自主飞行 |
| 16 | 飞行模式 | flyType | String | 1 | 是 | 否 | 飞行模式:0:超视距;1:视距内 |
| 17 | 起降备降场地 | remarkQjbj | String | - | 是 | 否 | 起降备降场地地址,格式示例:“起飞地址|起飞点经度,起飞点纬度|降落地址|降落点经度,降落点纬度|备降地址|备降点经度,备降点纬度”。若无固定起降备降点,以“无|0,0|无|0,0|无|0,0”的格式传输 |
| 18 | 应急处置程序 | remarkYjcz | String | - | 是 | 否 | 应急处置程序说明 |
| 19 | 特殊飞行保障需求 | remarkTsxq | String | - | 是 | 否 | 说明特殊飞行保障需求 |
| 20 | 通导和被监视能力 | remarkTdjn | String | - | 是 | 否 | 通信、导航和被监视能力 |
| 序号 | 字段 | 字段代码 | 字段类型 | 字段长度(byte) | 是否必填 | 是否加密 | 描述及要求 |
| 21 | 飞行速度和进出空域方法 | remarkFxhx | String | - | 是 | 否 | 说明飞行速度和进出空域方法 |
| 22 | 指挥控制链路无线电频率以及占用带宽 | remarkZhkz | String | - | 是 | 否 | 说明指挥控制链路无线电频率以及占用带宽,若没有相关信息可填"无" |
| 23 | 二次雷达应答机或者有关自动监视设备代码 | remarkEcld | String | - | 是 | 否 | 说明二次雷达应答机或者有关自动监视设备代码,若没有相关信息可填"无" |
| 24 | 其他 | remarkQtxx | String | - | 否 | 否 | 其他需要补充的必要信息 |
| 25 | 涉及的特殊飞行活动 | involvedSpecialPlan | String | 5 | 否 | 否 | 以5位String类型的字符串传输,按下述1-5的顺序通过"0"或者"1"表示,其中:0:不涉及相关飞行活动;1:涉及相关飞行活动涉及的特殊飞行活动包括,第1类:通过通信基站或者互联网进行无人驾驶航空器中继飞行;第2类:运载危险品或者投放物品(常规农用无人驾驶航空器作业飞行活动除外);第3类:飞越集会人群上空;第4类:在移动的交通工具上操控无人驾驶航空器;第5类:实施分布式操作或者集群飞行。示例:"00000"代表不涉及,"11000"代表涉及第1类和第2类特殊飞行活动,以此类推 |
| 26 | 空域列表 | spaces | JSON数组 | - | 是 | 否 | 按照表45 空域数据。长期飞行活动支持多空域申请 |
| 27 | 任务审批文件 | files | JSON数组 | - | 否 | 否 | 若涉及特殊飞行活动,必须上传任务审批文件;若飞行任务性质为航空摄影,必须上传测绘资质证明。格式按照表46 任务审批文件数据。数组长度不大于5 |
| 28 | 预审状态 | preAuditSts | String | - | 是 | 否 | 预审状态:0:未授权;1:通过;2;未通过默认"0",未授权。若多方参与预审,依次在字符串中拼接预审状态,示例三方参与预审:"112" |
| 序号 | 字段 | 字段代码 | 字段类型 | 字段长度(byte) | 是否必填 | 是否加密 | 描述及要求 |
| 29 | 预审意见 | preAuditDesc | String | - | 是 | 否 | 预审意见。默认"无"。预审意见按"单位:意见说明"的形式描述。根据预审状态的字符串组装顺序,依次描述各方预审意见,用"|"分隔,示例:"单位1:同意|单位2:同意|单位3:不同意" |
10.6.4 输出参数
输出参数应符合表50的要求,接口请求及响应示例见附录B.15.3。
| 序号 | 字段 | 字段代码 | 字段类型 | 字段长度 (byte) | 是否必填 | 是否加密 | 描述及要求 |
| 1 | 响应状态 | code | Integer | 3 | 是 | 否 | 响应状态:200:成功;400:输入参数错误;401:认证失败;403:无权限访问;429:请求过于频繁;500:服务器内部错误 |
| 2 | 描述 | msg | String | - | 是 | 否 | 返回信息描述 |
| 3 | 飞行活动编号数据 | data | JSON | - | 是 | 否 | 按照表48 飞行活动申请编号数据 |
长期飞行活动备案接口
10.7.1 通讯协议
接口应采用https通信协议。
10.7.2 数据传输
数据传输应满足如下要求:
a) 使用 RESTful API 方式,以 JSON 作为数据交换格式;
b) 请求方式:post;
c) 请求头:Content-Type: application/json; charset=utf-8;
d) 请求频率:相同的请求参数请求频率不超过五秒每次。
10.7.3 输入参数
输入参数应符合表51的要求,接口请求及响应示例见附录B.16.1。
| 序号 | 字段 | 字段代码 | 字段类型 | 字段长度(byte) | 是否必填 | 是否加密 | 描述及要求 |
| 1 | 长期飞行活动编号 | planId | String | - | 是 | 否 | 长期飞行活动申请id |
| 2 | 航空器和操控员列表 | uavAndDriver | JSON数组 | - | 是 | 否 | 按照表44 航空器和操控员数据 |
| 3 | 预计起飞时间 | planBeg | String | 19 | 是 | 否 | 预计起飞时间,格式:"yyyy-MM-dd HH:mm:ss" |
| 4 | 预计结束时间 | planEnd | String | 19 | 是 | 否 | 预计结束时间,格式:"yyyy-MM-dd HH:mm:ss" |
| 5 | 空域编码 | spcCode | String | - | 否 | 否 | 空域编码,编码规则为:空域名称-当前时间(格式:yyyyMMddHHmmss)-4位随机码(数字或字母均可),示例:测试空域-20251105172500-45DF。若长期飞行活动申请中含多个空域,在备案时,需要选择其中一个空域备案申请,该字段必填 |
10.7.4 输出参数
输出参数应符合表52和表53的要求,接口请求及响应示例见附录B.16.2。
| 序号 | 字段 | 字段代码 | 字段类型 | 字段长度(byte) | 是否必填 | 是否加密 | 描述及要求 |
| 1 | 响应状态 | code | Integer | 3 | 是 | 否 | 响应状态:200:成功;400:输入参数错误;401:认证失败;403:无权限访问;429:请求过于频繁;500:服务器内部错误 |
| 2 | 描述 | msg | String | - | 是 | 否 | 返回信息描述 |
| 3 | 长期飞行活动备案编号数据 | data | JSON | - | 是 | 否 | 按照表53 长期飞行活动备案编号数据 |
| 序号 | 字段 | 字段代码 | 字段类型 | 字段长度(byte) | 是否必填 | 是否加密 | 描述及要求 |
| 1 | 长期飞行活动备案编号 | planId | 数组 | - | 是 | 否 | 长期飞行活动备案id |
飞行活动申请撤回接口
10.8.1 通讯协议
接口应采用https通信协议。
10.8.2 数据传输
数据传输应满足如下要求:
a) 使用 RESTful API 方式,以 JSON 作为数据交换格式;
b) 请求方式:post;
c) 请求头:Content-Type: application/json; charset=utf-8;
d) 请求频率:相同的请求参数请求频率不超过五秒每次。
10.8.3 输入参数
输入参数应符合表54的要求,接口请求及响应示例见附录B.17.1。
| 序号 | 字段 | 字段代码 | 字段类型 | 字段长度(byte) | 是否必填 | 是否加密 | 描述及要求 |
| 1 | 飞行活动编号 | planId | String | - | 是 | 否 | 一般、紧急、特别紧急、长期、场内飞行活动申请id |
10.8.4 输出参数
输出参数应符合表55和表56的要求,接口请求及响应示例见附录B.17.2。
| 序号 | 字段 | 字段代码 | 字段类型 | 字段长度(byte) | 是否必填 | 是否加密 | 描述及要求 |
| 1 | 响应状态 | code | Integer | 3 | 是 | 否 | 响应状态:200:成功;400:输入参数错误;401:认证失败;403:无权限访问;429:请求过于频繁;500:服务器内部错误 |
| 2 | 描述 | msg | String | - | 是 | 否 | 返回信息描述 |
| 3 | 飞行活动申请撤回数据 | data | JSON | - | 是 | 否 | 按照表56 飞行活动申请撤回数据 |
| 序号 | 字段 | 字段代码 | 字段类型 | 字段长度(byte) | 是否必填 | 是否加密 | 描述及要求 |
| 1 | M撤回状态 | withdrawSts | Integer | 1 | 是 | 否 | H响0批行1::应活或撤撤状动不回回态)予失成:;受败功理(,若则飞无行法活撤动回已该被审飞 |
飞行活动审批状态查询接口
10.9.1 通讯协议
接口应采用https通信协议。
10.9.2 数据传输
数据传输应满足如下要求:
a) 使用 RESTful API 方式,以 JSON 作为数据交换格式;
b) 请求方式:post;
c) 请求头:Content-Type: application/json; charset=utf-8;
d) 请求频率:相同的请求参数请求频率不超过一分钟每次。
10.9.3 输入参数
输入参数应符合表57的要求,接口请求及响应示例见附录B.18.1。
| 序号 | 字段 | 字段代码 | 字段类型 | 字段长度(byte) | 是否必填 | 是否加密 | 描述及要求 |
| 1 | 飞行活动编号集合 | planIdList | 数组 | - | 是 | 否 | 一般、紧急、特别紧急、长期、场内飞行活动申请id和长期飞行活动备案id集合 |
10.9.4 输出参数
输出参数应符合表58和表59的要求,接口请求及响应示例见附录B.18.2。
| 序号 | 字段 | 字段代码 | 字段类型 | 字段长度(byte) | 是否必填 | 是否加密 | 描述及要求 |
| 1 | 响应状态 | code | Integer | 3 | 是 | 否 | 响应状态:200:成功;400:输入参数错误;401:认证失败;403:无权限访问;429:请求过于频繁;500:服务器内部错误 |
| 2 | 描述 | msg | String | - | 是 | 否 | 返回信息描述 |
| 3 | 审批结果 | data | JSON数组 | - | 是 | 否 | 审批结果集,按照表59 飞行活动申请审批结果数据 |
| 序号 | 字段 | 字段代码 | 字段类型 | 字段长度(byte) | 是否必填 | 是否加密 | 描述及要求 |
| 1 | 飞行活动编号 | planId | String | - | 是 | 否 | 一般、紧急、特别紧急、长期、场内飞行活动申请id和长期飞行活动备案id |
| 2 | 审批状态 | auditSts | String | 1 | 是 | 否 | 审批状态:1:批准;2:不予批准;3:审批中;4:不予受理 |
| 3 | 审批意见 | auditDesc | String | - | 否 | 否 | 审批意见 |
| 4 | 审批时间 | auditTime | String | 19 | 否 | 否 | 飞行活动的审批时间,格式:"yyyy-MM-dd HH:mm:ss" |
| 5 | 飞行活动申请验证链接 | qrCodeVoucher | String | - | 否 | 否 | 飞行活动申请验证链接。仅批准的飞行活动有值 |
| 6 | 起飞确认审批状态 | takeoffAuditSts | String | 1 | 是 | 否 | 起飞确认审批状态:0:未提交;1:允许起飞;2:不允起飞;3:确认中 |
| 7 | 起飞确认审批意见 | takeoffAuditDesc | String | - | 否 | 否 | 起飞确认审批意见说明 |
| 8 | 起飞确认审批时间 | takeoffAuditTime | String | 19 | 否 | 否 | 起飞确认的审批时间,格式:"yyyy-MM-dd HH:mm:ss" |
| 9 | 空域编码 | spcCode | String | - | 否 | 否 | 若长期飞行活动申请中含多个空域,则审批状态与空域编码关联,该字段有值。长期飞行活动申请多空域,在审批时,会存在部分空域不予批准,需结合空域编码判断 |
飞行活动申请数据获取接口
10.10.1 通讯协议
通过消息队列获取。
10.10.2 数据传输
请求方式:通过订阅消息主题获取数据。
10.10.3 推送参数
推送参数应符合表60至表64的要求,示例见附录B.19.1和B.19.2。
| 序号 | 字段 | 字段代码 | 字段类型 | 字段长度 (byte) | 是否必填 | 是否加密 | 描述及要求 |
| 1 | 数据格式类型 | msgType | String | 1 | 是 | 否 | 用于标识所采用的消息格式。1:飞行活动申请新增;2:审批状态变更;3:起飞确认状态变更;4:降落报告状态变更 |
| 2 | 数据内容 | data | JSON | - | 是 | 否 | 根据数据格式类型区分数据内容。当数据格式类型为“1:飞行活动申请数据”时,按照表61飞行活动申请数据;当数据格式类型为“2:飞行审批审批状态数据、3:起飞确认状态变更、4:降落报告状态变更”时,按照表63飞行活动审批、起飞确认、降落报告状态变更数据 |
| 3 | 发送时间 | timeStamp | String | 19 | 是 | 否 | 发送时间,格式:“yyyy-MM-dd HH:mm:ss” |
| 序号 | 字段 | 字段代码 | 字段类型 | 字段长度(byte) | 是否必填 | 是否加密 | 描述及要求 |
| 1 | 申请时间 | applyTime | String | 19 | 是 | 否 | 申请时间,格式:"yyyy-MM-dd HH:mm:ss" |
| 2 | 用户类型 | userType | String | 1 | 是 | 否 | 申请活动的用户类型:1:个人;2:单位 |
| 3 | 申请人 | userName | String | - | 是 | 否 | 申请活动的个人姓名/单位名称 |
| 序号 | 字段 | 字段代码 | 字段类型 | 字段长度(byte) | 是否必填 | 是否加密 | 描述及要求 |
| 4 | 证件类型 | personCardType | String | 1 | 否 | 否 | 申请活动的个人证件类型:0:身份证;1:港澳居民往来内地通行证;2:台湾居民往来大陆通行证;3:护照;4:外国人永久居留身份证;5:港澳居民居住证;6:台湾居民居住证;7:其他证件申请用户为个人用户时该字段必填 |
| 5 | 证件号码 | personCardNo | String | - | 否 | 是 | 申请活动的个人证件号码。申请用户为单位用户时该字段必填 |
| 6 | 单位类型 | deptType | String | 6 | 否 | 否 | 申请活动的单位类型:010101:营利法人;010201:事业单位;010202:社会团体;010203:基金会;010204:社会服务机构;010205:其他;010301:机关法人;010302:农村集体经济组织法人;010303:城镇农村的合作经济组织法人;010304:基层群众性自治组织法人;010401:非法人组织;0201:国内无人机生产厂商;0202:国外无人机生产厂商申请用户为单位用户时该字段必填 |
| 7 | 统一社会信用代码 | deptCode | String | 18 | 否 | 否 | 申请活动的单位统一社会信用代码。申请用户为单位用户时该字段必填 |
| 8 | 联系人 | contactPerson | String | - | 是 | 是 | 申请活动的单位联系人/个人姓名 |
| 9 | 手机号码 | phone | String | - | 是 | 是 | 申请活动的单位联系人/个人手机号码 |
| 10 | 电子邮箱 | String | - | 是 | 是 | 申请活动的单位联系人/个人电子邮箱 | |
| 11 | 预计飞行最大高度 | maxHeight | Integer | - | 是 | 否 | 真高,单位:m |
| 序号 | 字段 | 字段代码 | 字段类型 | 字段长度 (byte) | 是否必填 | 是否加密 | 描述及要求 |
| 12 | 飞行活动申请类型 | planType | String | 2 | 是 | 否 | 飞行活动申请类型:11:一般飞行活动申请;12:紧急飞行活动申请;13:特别紧急飞行活动申请;21:长期飞行活动申请;22:长期飞行活动备案;31:场内飞行活动申请;32:场内飞行活动起飞确认 |
| 13 | 飞行活动编号 | planId | String | - | 是 | 否 | 一般飞行活动申请、紧急飞行活动申请、特别紧急飞行活动申请、长期飞行活动申请、长期飞行活动备案、场内飞行活动申请、场内飞行活动起飞确认id |
| 14 | 长期、场内飞行活动编号 | relPlanId | String | - | 否 | 否 | 当飞行活动申请类型为22(长期飞行活动备案)时,关联所依据的长期飞行活动申请id;当飞行活动申请类型为32(场内飞行活动起飞确认)时,关联所依据的场内飞行活动申请id |
| 15 | 预计开始时刻 | planBeg | String | 19 | 是 | 否 | 飞行活动预计开始时刻,格式:“yyyy-MM-dd HH:mm:ss” |
| 16 | 预计结束时刻 | planEnd | String | 19 | 是 | 否 | 飞行活动预计结束时刻,格式:“yyyy-MM-dd HH:mm:ss” |
| 17 | 通信联络方法 | txll | String | - | 否 | 是 | 飞行活动中的联系方式。申请用户为单位用户时该字段必填 |
| 序号 | 字段 | 字段代码 | 字段类型 | 字段长度(byte) | 是否必填 | 是否加密 | 描述及要求 |
| 18 | 任务性质 | taskType | String | 3 | 是 | 否 | 任务性质,单位用户可申请:载客类(101-102)101:短途运输;102:包机飞行;载人类(111-115)111:石油服务;112:无人机引航;113:航空医疗救护;114:空中游览;115:跳伞飞行服务;其他类(121-138)121:航空护林;122:城市消防;123:机外载荷飞行;124:人工影响天气;125:航空探矿;126:航空摄影;127:海洋监测;128:渔业飞行;129:空中巡查;130:电力作业;131:航空喷洒(撒);132:空中拍照;133:空中广告;134:科学实验;135:气象探测;136:表演飞行;137:其他;载货类(140)140:载货类;培训类(150)150:培训类;任务性质,个人用户可申请:8:个人娱乐 |
| 19 | 操控模式 | optType | String | 1 | 否 | 否 | 操控模式:1:遥控飞行;2:自主飞行申请用户为单位用户时该字段必填 |
| 20 | 飞行模式 | flyType | String | 1 | 否 | 否 | 飞行模式:0:超视距;1:视距内申请用户为单位用户时该字段必填 |
| 序号 | 字段 | 字段代码 | 字段类型 | 字段长度 (byte) | 是否必填 | 是否加密 | 描述及要求 |
| 21 | 起降备降场地 | remarkQjbj | String | - | 否 | 否 | 起降备降场地地址,格式示例:“起飞地址|起飞点经度,起飞点纬度|降落地址|降落点经度,降落点纬度|备降地址|备降点经度,备降点纬度”。若无固定起降备降点,以“无|0,0|无|0,0|无|0,0”的格式传输。申请用户为单位用户时该字段必填 |
| 22 | 应急处置程序 | remarkYjcz | String | - | 否 | 否 | 应急处置程序说明。申请用户为单位用户时该字段必填 |
| 23 | 特殊飞行保障需求 | remarkTsxq | String | - | 否 | 否 | 说明特殊飞行保障需求。申请用户为单位用户时该字段必填 |
| 24 | 通导和被监视能力 | remarkTdjn | String | - | 否 | 否 | 通信、导航和被监视能力。申请用户为单位用户时该字段必填 |
| 25 | 飞行速度和进出空域方法 | remarkFxhx | String | - | 否 | 否 | 说明飞行速度和进出空域方法。申请用户为单位用户时该字段必填 |
| 26 | 指挥控制链路无线电频率以及占用带宽 | remarkZhkz | String | - | 否 | 否 | 说明指挥控制链路无线电频率以及占用带宽,若没有相关信息可填“无”。申请用户为单位用户时该字段必填 |
| 27 | 二次雷达应答机或者有关自动监视设备代码 | remarkEcld | String | - | 否 | 否 | 说明二次雷达应答机或者有关自动监视设备代码,若没有相关信息可填“无”。申请用户为单位用户时该字段必填 |
| 28 | 其他 | remarkQtxx | String | - | 否 | 否 | 其他需要补充的必要信息。申请用户为单位用户时该字段必填 |
| 序号 | 字段 | 字段代码 | 字段类型 | 字段长度(byte) | 是否必填 | 是否加密 | 描述及要求 |
| 29 | 涉及的特殊飞行活动 | involvedSpecialPlan | String | 5 | 否 | 否 | 以5位String类型的字符串传输,按下述1-5的顺序通过"0"或者"1"表示,其中:0:不涉及相关飞行活动;1:涉及相关飞行活动涉及的特殊飞行活动包括,第1类:通过通信基站或者互联网进行无人驾驶航空器中继飞行;第2类:运载危险品或者投放物品(常规农用无人驾驶航空器作业飞行活动除外);第3类:飞越集会人群上空;第4类:在移动的交通工具上操控无人驾驶航空器;第5类:实施分布式操作或者集群飞行。示例:"00000"代表不涉及,"11000"代表涉及第1类和第2类特殊飞行活动,以此类推 |
| 30 | 航空器列表 | uavs | JSON数组 | - | 否 | 否 | 按照表62 实名登记数据 |
| 31 | 操控员列表 | drivers | JSON数组 | - | 否 | 否 | 按照表17 操控员数据 |
| 32 | 空域列表 | spaces | JSON数组 | - | 是 | 否 | 按照表45 空域数据 |
| 33 | 任务审批文件 | files | JSON数组 | - | 否 | 否 | 若涉及特殊飞行活动,必须上传任务审批文件。若飞行任务性质为航空摄影,必须上传测绘资质证明。格式按照表46 任务审批文件。数组长度不大于5 |
| 34 | 航空器与操控员关联关系 | uavAndDriverRelation | 数组 | - | 是 | 否 | 关联航空器和操控员,格式[[实名登记标识,执照编号],[实名登记标识,执照编号]],示例:[[uas,licenseNo],[uas, licenseNo],[uas,licens eNo]] |
| 序号 | 字段 | 字段代码 | 字段类型 | 字段长度(byte) | 是否必填 | 是否加密 | 描述及要求 |
| 1 | 登记状态 | uavState | String | 2 | 是 | 否 | 登记状态:0:正常;3:注销;99:无记录 |
| 2 | 用户类型 | uavUserType | String | 1 | 是 | 否 | 无人机拥有者用户类型:0:个人;1:单位 |
| 序号 | 字段 | 字段代码 | 字段类型 | 字段长度 (byte) | 是否必填 | 是否加密 | 描述及要求 |
| 3 | 无人机类型 | uavType | String | 1 | 是 | 否 | 无人机类型:0:固定翼;1:旋翼航空器;2:多桨或多轴航空器;3:复合翼航空器;4:飞艇;5:其他 |
| 4 | 实名登记标志 | uas | String | 11 | 是 | 否 | 实名登记标志 |
| 5 | 唯一产品识别码/产品序列号 | upicMsn | String | 20 | 是 | 否 | 若没有唯一产品识别码,则使用产品序列号 |
| 6 | 产品名称 | uavName | String | - | 是 | 否 | 产品名称 |
| 7 | 产品型号 | uavModel | String | - | 是 | 否 | 产品型号 |
| 8 | 厂商名称 | uavManufacturer | String | - | 是 | 否 | 生产厂商名称 |
| 9 | 空机重量 | uavEmptyWeight | String | - | 是 | 否 | 空机重量(单位:kg) |
| 10 | 最大起飞重量 | uavMaxWeight | String | - | 是 | 否 | 最大起飞重量(单位:kg) |
| 11 | 姓名 | uavPersonName | String | - | 是 | 否 | 个人拥有者姓名 |
| 12 | 证件类型 | uavPersonCardType | String | 1 | 是 | 否 | 个人拥有者证件类型:0:身份证;1:港澳居民往来内地通行;2:台湾居民往来大陆通行证;3:护照;4:外国人永久居留身份证;5:港澳居民居住证;6:台湾居民居住证;7:其他证件 |
| 13 | 证件号码 | uavPersonCardNum | String | - | 是 | 是 | 个人拥有者证件号码 |
| 14 | 手机号码 | uavPersonPhone | String | - | 是 | 是 | 个人拥有者手机号码 |
| 15 | 统一社会信用代码 | uavUscCode | String | 18 | 是 | 否 | 单位拥有者统一社会信用代码 |
| 16 | 单位类型 | uavUnitType | String | 6 | 是 | 否 | 单位拥有者类型:010101:营利法人;010201:事业单位;010202:社会团体;010203:基金会;010204:社会服务机构;010205:其他;010301:机关法人;010302:农村集体经济组织法人;010303:城镇农村的合作经济组织法人;010304:基层群众性自治组织法人;010401:非法人组织;0201:国内无人机生产厂商;0202:国外无人机生产厂商 |
| 17 | 单位名称 | uavUnit | String | - | 是 | 否 | 单位拥有者名称 |
| 18 | 单位联系人 | uavUnitContact | String | - | 是 | 否 | 单位拥有者联系人姓名 |
| 19 | 手机号码 | uavUnitPhone | String | - | 是 | 是 | 单位拥有者联系人手机号码 |
| 序号 | 字段 | 字段代码 | 字段类型 | 字段长度(byte) | 是否必填 | 是否加密 | 描述及要求 |
| 1 | 飞行活动编号 | planId | String | - | 是 | 否 | 一般、紧急、特别紧急、长期、场内飞行活动申请id和长期飞行活动备案id |
| 2 | 审批状态 | auditSts | String | 1 | 是 | 否 | 审批状态:1:批准;2:不予批准;3:审批中;4:不予受理 |
| 3 | 审批意见 | auditDesc | String | - | 否 | 否 | 审批意见 |
| 4 | 审批时间 | auditTime | String | 19 | 否 | 否 | 飞行活动的审批时间,格式:"yyyy-MM-dd HH:mm:ss" |
| 5 | 飞行活动申请验证链接 | qrCodeVoucher | String | - | 否 | 否 | 飞行活动申请验证链接。仅批准的飞行活动有值 |
| 6 | 空域编码 | spcCode | String | - | 否 | 否 | 若长期飞行活动申请中含多个空域,则审批状态与空域编码关联,该字段有值。长期飞行活动申请多空域,在审批时,会存在部分空域不予批准,需结合空域编码判断 |
| 7 | 起飞确认和降落报告 | takeoffs | JSON数组 | - | 否 | 否 | 按照表64 起飞确认和降落报告数据 |
| 序号 | 字段 | 字段代码 | 字段类型 | 字段长度(byte) | 是否必填 | 是否加密 | 描述及要求 |
| 1 | 起飞确认审批状态 | takeoffAuditSts | String | 1 | 是 | 否 | 起飞确认审批状态:0:未提交;1:允许起飞;2:不允起飞;3:确认中 |
| 2 | 起飞确认审批意见 | takeoffAuditDesc | String | - | 否 | 否 | 起飞确认审批意见 |
| 3 | 起飞确认审批时间 | takeoffAuditTime | String | 19 | 否 | 否 | 起飞确认的审批时间,格式:"yyyy-MM-dd HH:mm:ss" |
| 4 | 预计起飞时刻 | takeoffTime | String | 19 | 是 | 否 | 预计起飞时刻,格式:"yyyy-MM-dd HH:mm:ss" |
| 5 | 起飞准备情况 | takeoffRemark | String | - | 是 | 否 | 描述起飞前的各项准备,如天气条件、周围环境安全、电池电量等状况 |
| 6 | 降落报告状态 | landSts | String | 1 | 是 | 否 | 降落报告状态:0:未报告;1:已报告 |
| 7 | 降落报告时间 | landTime | String | 19 | 否 | 否 | 降落报告时间,格式:"yyyy-MM-dd HH:mm:ss" |
一般/紧急/长期飞行活动起飞确认接口
10.11.1 通讯协议
接口应采用https通信协议。
10.11.2 数据传输
数据传输应满足如下要求:
a) 使用 RESTful API 方式,以 JSON 作为数据交换格式;
b) 请求方式:post;
c) 请求头:Content-Type: application/json; charset=utf-8;
d) 请求频率:相同的请求参数请求频率不超过五秒每次。
10.11.3 输入参数
输入参数应符合表65的要求,接口请求及响应示例见附录B.20.1。
| 序号 | 字段 | 字段代码 | 字段类型 | 字段长度 (byte) | 是否必填 | 是否加密 | 描述及要求 |
| 1 | 飞行活动编号 | planId | String | - | 是 | 否 | 一般、紧急、特别紧急飞行活动申请id和长期飞行活动备案id |
| 2 | 预计起飞时刻 | takeoffTime | String | 19 | 是 | 否 | 预计起飞时刻,格式:“yyyy-MM-dd HH:mm:ss” |
| 3 | 起飞准备情况 | takeoffRemark | String | 19 | 是 | 否 | 说明起飞准备情况 |
| 4 | 起飞确认预审状态 | preTakeoffAuditSts | String | - | 是 | 否 | 起飞确认预审状态:0:未授权;1:通过;2:未通过默认“0”,未授权。若多方参与预审,依次在字符串中拼接预审状态,示例三方参与预审:“112” |
| 5 | 起飞确认预审意见 | preTakeoffAuditDesc | String | - | 是 | 否 | 起飞确认预审意见。默认“无”。预审意见按“单位:意见说明”的形式描述,根据预审状态的字符串组装顺序,依次描述各方预审意见,用“|”分隔。示例:“单位1:同意|单位2:同意|单位3:不同意” |
| 序号 | 字段 | 字段代码 | 字段类型 | 字段长度(byte) | 是否必填 | 是否加密 | 描述及要求 |
| 1 | 响应状态 | code | Integer | 3 | 是 | 否 | 响应状态:200:成功;400:输入参数错误;401:认证失败;403:无权限访问;429:请求过于频繁;500:服务器内部错误 |
| 2 | 描述 | msg | String | - | 是 | 否 | 返回信息描述 |
| 3 | 飞行活动编号数据 | data | JSON | - | 是 | 否 | 按照表48 飞行活动申请编号数据 |
场内飞行活动起飞确认接口
10.12.1 通讯协议
接口应采用https通信协议。
10.12.2 数据传输
数据传输应满足如下要求:
a) 使用 RESTful API 方式,以 JSON 作为数据交换格式;
b) 请求方式:post;
c) 请求头:Content-Type: application/json; charset=utf-8;
d) 请求频率:相同的请求参数请求频率不超过五秒每次。
10.12.3 输入参数
输入参数应符合表67的要求,接口请求及响应示例见附录B.21.1。
| 序号 | 字段 | 字段代码 | 字段类型 | 字段长度(byte) | 是否必填 | 是否加密 | 描述及要求 |
| 1 | 飞行活动编号 | planId | String | - | 是 | 否 | 飞行活动申请id |
| 2 | 航空器和操控员列表 | uavAndDriver | JSON数组 | - | 是 | 否 | 按照表44 航空器和操控员数据 |
| 3 | 预计起飞时间 | planBeg | String | 19 | 是 | 否 | 预计起飞时间,格式:"yyyy-MM-dd HH:mm:ss" |
| 4 | 预计结束时间 | planEnd | String | 19 | 是 | 否 | 预计结束时间,格式:"yyyy-MM-dd HH:mm:ss" |
| 5 | 起飞确认预审状态 | preTakeoffAuditSts | String | - | 是 | 否 | 起飞确认预审状态:0:未授权;1:通过;2:未通过默认"0" ,未授权。若多方参与预审,依次在字符串中拼接预审状态,示例三方参与预审:"112" |
| 6 | 起飞确认预审意见 | preTakeoffAuditDesc | String | - | 是 | 否 | 起飞确认预审意见。默认"无"。预审意见按"单位:意见说明"的形式描述,根据预审状态的字符串组装顺序,依次描述各方预审意见,用"|"分隔。示例:"单位1:同意|单位2:同意|单位3:不同意" |
| 7 | 起飞准备情况 | takeoffRemark | String | - | 是 | 否 | 起飞准备情况说明 |
| 8 | 预计起飞时刻 | takeoffTime | String | 19 | 是 | 否 | 预计起飞时刻,用于明确预计起飞的具体时间,格式: " yyyy-MM-dd HH:mm:ss" |
10.12.4 输出参数
输出参数应符合表68的要求,接口请求及响应示例见附录B.21.2。
| 序号 | 字段 | 字段代码 | 字段类型 | 字段长度(byte) | 是否必填 | 是否加密 | 描述及要求 |
| 1 | 响应状态 | code | Integer | 3 | 是 | 否 | 响应状态:200:成功;400:输入参数错误;401:认证失败;403:无权限访问;429:请求过于频繁;500:服务器内部错误 |
| 2 | 描述 | msg | String | - | 是 | 否 | 返回信息描述 |
| 3 | 飞行活动编号数据 | data | JSON | - | 是 | 否 | 按照表48 飞行活动申请编号数据 |
飞行活动降落报告接口
10.13.1 通讯协议
接口应采用https通信协议。
10.13.2 数据传输
数据传输应满足如下要求:
a) 使用 RESTful API 方式,以 JSON 作为数据交换格式;
b) 请求方式:post;
c) 请求头 Content-Type: appli cation/json; charset=utf-8;
d) 请求频率:相同的请求参数请求频率不超过五秒每次。
10.13.3 输入参数
输入参数应符合表69的要求,接口请求及响应示例见附录B.22.1。
| 序号 | 字段 | 字段代码 | 字段类型 | 字段长度(byte) | 是否必填 | 是否加密 | 描述及要求 |
| 1 | 飞行活动编号 | planId | String | - | 是 | 否 | 一般、紧急、特别紧急、场内飞行活动申请id和长期飞行活动备案id |
| 2 | 降落时间 | landingTime | String | 19 | 是 | 否 | 降落时间,格式:"yyyy-MM-dd HH:mm:ss" |
10.13.4 输出参数
输出参数应符合表70的要求,接口请求及响应示例见附录B.22.2。
| 序号 | 字段 | 字段代码 | 字段类型 | 字段长度(byte) | 是否必填 | 是否加密 | 描述及要求 |
| 1 | 响应状态 | code | Integer | 3 | 是 | 否 | 响应状态:200:成功;400:输入参数错误;401:认证失败;403:无权限访问;429:请求过于频繁;500:服务器内部错误 |
| 2 | 描述 | msg | String | - | 是 | 否 | 返回信息描述 |
| 3 | 飞行活动编号数据 | data | JSON | - | 是 | 否 | 按照表48 飞行活动申请编号数据 |
网络式运行识别信息获取接口
10.14.1 通讯协议
通过消息队列获取。
10.14.2 数据传输
请求方式:通过订阅消息主题获取数据。
10.14.3 推送参数
网络式运行识别信息推送参数应符合表71至表74的要求,示例见附录B.23。
| 序号 | 字段 | 字段代码 | 字段类型 | 字段长度(byte) | 是否必填 | 是否加密 | 描述及要求 |
| 1 | 飞行记录编号 | orderId | String | - | 是 | 否 | UPIC_MSN-8位起飞日期(yyyyMMdd)-8位随机码(数字或字母均可),示例:1581F5FHD25G100CTEST-20240320-owvGyLqe |
| 2 | 唯一产品识别码/产品序列号 | upicMsn | String | - | 是 | 否 | 唯一产品识别码/产品序列号,若没有唯一产品识别码,则使用产品序列号。 |
| 3 | 生产厂商统一社会信用代码 | uscCode | String | 18 | 是 | 否 | 生产厂商统一社会信用代码 |
| 4 | 实名登记标志 | uas | String | 11 | 是 | 否 | 实名登记标志,若无实名登记标识,默认值"UAS-DEFAULT" |
| 5 | 时间戳 | timeStamp | String | 14 | 是 | 否 | 无人机飞行时间,格式:yyyyMMddHHmmss,未知或不可用时取(默认值)"19691231235959",示例:"20240124095001" |
| 6 | 产品型号 | uasModel | String | - | 是 | 否 | 产品型号 |
| 7 | 坐标系类型 | coordinate | Integer | 1 | 是 | 否 | 运行识别功能使用的坐标系类型:1:WGS-84;2:CGCS2000;3~15:预留 |
| 8 | 民用无人驾驶航空器位置 | uavLonLat | String | 30 | 是 | 否 | 无人机位置的经度与纬度,单位:度,格式:经度|纬度,西经、南纬以负值表示,精确到小数点后7位,乘10的7次方后传输,对于未知或不可用时取值(默认值)-10000000|-10000000 |
| 9 | 相对高度 | height | Integer | 10 | 否 | 否 | 无人机基于起飞地的高度,单位:m,精确到小数点后1位,乘10以后传输,未知或不可用时编码值取"-999999" |
| 序号 | 字段 | 字段代码 | 字段类型 | 字段长度 (byte) | 是否必填 | 是否加密 | 描述及要求 |
| 10 | 气压高度 | pressureHeight | Integer | 10 | 否 | 否 | 无人机基于以101.325kPa为参考面的标准气压高度,单位:m,精确到小数点后1位,乘10以后传输,未知或不可用时编码值取“-999999” |
| 11 | 垂直速度 | vs | Integer | 10 | 否 | 否 | 无人机基于当前坐标系的上升或下降速度,当无人驾驶航空器上升时为正数,下降时为负数,单位:m/s,精确到小数点后1位,乘10以后传输,未知或不可用时编码值取“-999999” |
| 12 | 地速 | gs | Integer | 10 | 是 | 否 | 无人机与地面的相对速度,单位:m/s,精确到小数点后1位,乘10后传输,未知或不可用时编码值取“-999999” |
| 13 | 航迹角 | course | Integer | 10 | 是 | 否 | 从真北顺时针测量的航迹角,单位:度,精确到小数点后1位,乘10后传输,范围[0,3599],未知或不可用时编码值取“-999999” |
| 14 | 民用无人驾驶航空器系统运行类别 | uavOptCategory | Integer | 1 | 否 | 否 | 无人机的运行类别:0:未定义;1:开放类;2:特定类;3:审定类;4~15:预留 |
| 15 | 民用无人驾驶航空器分类 | uavCategory | Integer | 1 | 是 | 否 | 无人机的分类:0:微型无人驾驶航空器;1:轻型无人驾驶航空器;2:小型无人驾驶航空器;3:中型无人驾驶航空器;4:大型无人驾驶航空器;5~15:预留 |
| 16 | 民用无人驾驶航空器遥控站位置类型 | uavControlStationSiteType | Integer | 1 | 是 | 否 | 无人机遥控站位置类型:0:起飞点位置;1:遥控站位置:2~15:预留 |
| 17 | 民用无人驾驶航空器遥控站位置 | uavControlStationSite | String | 30 | 是 | 否 | 无人机遥控站位置的经度与纬度,单位:度,格式:经度|纬度,西经、南纬以负值表示,精确到小数点后7位,乘10的7次方后传输,对于未知或不可用时取值(默认值)-10000000|-10000000 |
| 序号 | 字段 | 字段代码 | 字段类型 | 字段长度(byte) | 是否必填 | 是否加密 | 描述及要求 |
| 18 | 民用无人驾驶航空器遥控站高度 | uavControlStationSiteHeight | Integer | 10 | 是 | 否 | 无人机遥控站基于当前坐标系的大地高度,单位:m,精确到小数点后1位,乘10以后传输,未知或不可用时编码值取" -999999" |
| 19 | 大地高度 | geodeticHeight | Integer | 10 | 是 | 否 | 无人机基于当前坐标系的大地高度,单位:m,精确到小数点后1位,乘10以后传输,未知或不可用时编码值取"-999999" |
| 20 | 水平精度 | horizontalAccuracy | Integer | 1 | 是 | 否 | 水平位置精度。置信度为95%,取值范围为:0:大于等于18.52 km(10 n mile)或未知;1:小于18.52 km(10 n mile);2:小于7.41 km(4 n mile);3:小于3.70 km(2 n mile);4:小于1852 m(1 n mile);5:小于926 m(0.5 n mile);6:小于556 m(0.3 n mile);7:小于185 m(0.1 n mile);8:小于92.6 m(0.05 n mile);9:小于30 m;10:小于10 m;11:小于3 m;12:小于1 m;13~15:预留 |
| 21 | 垂直精度 | verticalAccuracy | Integer | 1 | 是 | 否 | 垂直位置精度。置信度为95%,取值范围为:0:大于等于150 m或未知;1:小于150 m;2:小于45 m;3:小于25 m;4:小于10 m;5:小于3 m;6:小于1 m;7~15:预留 |
| 序号 | 字段 | 字段代码 | 字段类型 | 字段长度 (byte) | 是否必填 | 是否加密 | 描述及要求 |
| 22 | 速度精度 | speedAccuracy | Integer | 1 | 是 | 否 | 速度精度。置信度为95%,取值范围为:0:大于等于10 m/s或未知;1:小于10 m/s;2:小于3 m/s;3:小于1 m/s;4:小于0.3 m/s;5~15:预留 |
| 23 | 时间戳精度 | timeStampAccuracy | Integer | 1 | 是 | 否 | 编入时间戳的时刻与真实时刻的精度范围,包括授时精度与授时信号编入信息的时间。取值范围为:0:大于0.5s或未知;1:小于或等于0.5s;2:小于或等于0.4s;3:小于或等于0.3s;4:小于或等于0.2s;5:小于或等于0.1s;6:小于或等于50ms;7:小于或等于20ms;8:小于或等于10ms;9~15:预留 |
| 24 | 运行状态 | operatingStatus | Integer | 1 | 是 | 否 | 无人机运行状态:0:未报告;1:地面;2:空中;3:民用无人驾驶航空器为紧急状态;4:运行识别发送功能失效(民用无人驾驶航空器为非紧急状态);5:运行识别发送功能失效(民用无人驾驶航空器为紧急状态);6~15:预留 |
| 25 | 真高 | tHeight | Integer | 10 | 否 | 否 | 无人机相对于当前位置的真高,单位:m,精确到小数点后1位,乘10以后传输 |
| 26 | 实名登记数据 | uavAuthInfo | JSON对象体 | - | 否 | 否 | 按照表72 实名登记数据,无人机没有实名登记数据,相关字段为空值 |
| 序号 | 字段 | 字段代码 | 字段类型 | 字段长度(byte) | 是否必填 | 是否加密 | 描述及要求 |
| 1 | 登记状态 | uavState | String | 2 | 是 | 否 | 登记状态:0:正常;3:注销;99:无记录 |
| 2 | 无人机类型 | uavType | String | 1 | 是 | 否 | 无人机类型:0:固定翼;1:旋翼航空器;2:多桨或多轴航空器;3:复合翼航空器;4:飞艇;5:其他 |
| 3 | 产品类别 | uavCategory | String | 1 | 是 | 否 | 产品类别:0:微型;1:轻型;2:小型;3:中型;4:大型 |
| 4 | 实名登记标志 | uas | String | 11 | 是 | 否 | 实名登记标志 |
| 5 | 产品名称 | uavName | String | - | 是 | 否 | 产品名称 |
| 6 | 产品型号 | uavModel | String | - | 是 | 否 | 产品型号 |
| 7 | 厂商名称 | uavManufacturer | String | - | 是 | 否 | 生产厂商名称 |
| 8 | 空机重量 | uavEmptyWeight | String | - | 是 | 否 | 空机重量(单位:kg) |
| 9 | 最大起飞重量 | uavMaxWeight | String | - | 是 | 否 | 最大起飞重量(单位:kg) |
| 10 | 用户类型 | uavUserType | String | 1 | 是 | 否 | 无人机拥有者用户类型:0:个人;1:单位 |
| 11 | 个人用户数据 | uavPerson | JSON | - | 否 | 否 | 按照表73 个人用户数据。用户类型为"个人"时,表73个人用户信息有值 |
| 12 | 单位用户数据 | uavUnit | JSON | - | 否 | 否 | 按照表74 单位用户数据。用户类型为"单位"时,表74 单位用户信息有值 |
| 序号 | 字段 | 字段代码 | 字段类型 | 字段长度(byte) | 是否必填 | 是否加密 | 描述及要求 |
| 1 | 姓名 | uavPersonName | String | - | 是 | 否 | 个人拥有者姓名 |
| 2 | 证件类型 | uavPersonCardType | String | 1 | 是 | 否 | 个人拥有者证件类型:0:身份证;1:港澳居民往来内地通行;2:台湾居民往来大陆通行证;3:护照;4:外国人永久居留身份证;5:港澳居民居住证;6:台湾居民居住证;7:其他证件 |
| 3 | 证件号码 | uavPpersonCardNum | String | - | 是 | 是 | 个人拥有者证件号码 |
| 4 | 手机号码 | uavPersonPhone | String | - | 是 | 是 | 个人拥有者手机号码 |
| 序号 | 字段 | 字段代码 | 字段类型 | 字段长度(byte) | 是否必填 | 是否加密 | 描述及要求 |
| 1 | 统一社会信用代码 | uavUscCode | String | 18 | 是 | 否 | 单位拥有者统一社会信用代码 |
| 2 | 单位类型 | uavUnitType | String | 6 | 否 | 否 | 单位拥有者类型:010101:营利法人;010201:事业单位;010202:社会团体;010203:基金会;010204:社会服务机构;010205:其他;010301:机关法人;010302:农村集体经济组织法人;010303:城镇农村的合作经济组织法人;010304:基层群众性自治组织法人;010401:非法人组织;0201:国内无人机生产厂商;0202:国外无人机生产厂商 |
| 3 | 单位名称 | uavUnitName | String | - | 是 | 否 | 单位拥有者名称 |
| 4 | 单位联系人 | uavUnitContact | String | - | 是 | 否 | 单位拥有者联系人姓名 |
| 5 | 手机号码 | uavUnitPhone | String | - | 是 | 是 | 单位拥有者联系人手机号码 |
10.15 广播式运行识别信息报送接口
10.15.1 通讯协议
接口应采用https通信协议。
10.15.2 数据传输
数据传输应满足如下要求:
a) 使用 RESTful API 方式, 以 JSON 作为数据交换格式,UTF-8 编码;
b) 请求方式:post;
c) 请求头:Content-Type: application/json; charset=utf-8;
d) 请求频率:数据报送频率不低于一秒每次。
10.15.3 输入参数
输入参数应符合表75和表76的要求,接口请求及响应示例见附录B.24.1。
| 序号 | 字段 | 字段代码 | 字段类型 | 字段长度(byte) | 是否必填 | 是否加密 | 描述及要求 |
| 1 | 广播式运行识别信息集合 | ridData | JSON数组 | - | 是 | 否 | 按照表76 广播式运行识别信息 |
| 2 | 发送时间 | sendTime | String | 19 | 是 | 否 | 发送运行识别数据的时间,格式:"yyyy-MM-dd HH:mm:ss" |
| 序号 | 字段 | 字段代码 | 字段类型 | 字段长度(byte) | 是否必填 | 是否加密 | 描述及要求 |
| 1 | 飞行记录编号 | orderId | String | - | 是 | 否 | UPIC_MSN-8位起飞日期(yyyyMMdd)-8位随机码(数字或字母均可),示例:1581F5FHD25G100CTEST-20240320-owvGyLqe |
| 2 | 唯一产品识别码/产品序列号 | upicMsn | String | - | 是 | 否 | 唯一产品识别码/产品序列号,若没有唯一产品识别码,则使用产品序列号。 |
| 3 | 生产厂商统一社会信用代码 | uscCode | String | 18 | 是 | 否 | 生产厂商统一社会信用代码 |
| 4 | 实名登记标志 | uas | String | 11 | 是 | 否 | 实名登记标志,若无实名登记标识,默认值"UAS-DEFAULT" |
| 5 | 时间戳 | timeStamp | String | 14 | 是 | 否 | 无人机飞行时间,格式:yyyyMMddHHmmss,,未知或不可用时取(默认值)"19691231235959",示例:"20240124095001" |
| 6 | 产品型号 | uasModel | String | - | 是 | 否 | 产品型号 |
| 7 | 坐标系类型 | coordinate | Integer | 1 | 是 | 否 | 运行识别功能使用的坐标系类型:1:WGS-84;2:CGCS2000;3~15:预留 |
| 8 | 民用无人驾驶航空器位置 | uavLonLat | String | 30 | 是 | 否 | 无人机位置的经度与纬度,单位:度,格式:经度|纬度,西经、南纬以负值表示,精确到小数点后7位,乘10的7次方后传输,对于未知或不可用时取值(默认值)-10000000|-10000000 |
| 9 | 相对高度 | height | Integer | 10 | 否 | 否 | 无人机基于起飞地的高度,单位:m,精确到小数点后1位,乘10以后传输,未知或不可用时编码值取"-999999" |
| 10 | 气压高度 | pressureHeight | Integer | 10 | 否 | 否 | 无人机基于以101.325kPa为参考面的标准气压高度,单位:m,精确到小数点后1位,乘10以后传输,未知或不可用时编码值取"-999999" |
| 11 | 垂直速度 | vs | Integer | 10 | 否 | 否 | 无人机基于当前坐标系的上升或下降速度,当无人驾驶航空器上升时为正数,下降时为负数,单位:m/s,精确到小数点后1位,乘10以后传输,未知或不可用时编码值取" -999999" |
| 序号 | 字段 | 字段代码 | 字段类型 | 字段长度 (byte) | 是否必填 | 是否加密 | 描述及要求 |
| 12 | 地速 | gs | Integer | 10 | 是 | 否 | 无人机与地面的相对速度,单位:m/s,精确到小数点后1位,乘10后传输,未知或不可用时编码值取“-999999” |
| 13 | 航迹角 | course | Integer | 10 | 是 | 否 | 从真北顺时针测量的航迹角,单位:度,精确到小数点后1位,乘10后传输,范围[0,3599],未知或不可用时编码值取“-999999” |
| 14 | 民用无人驾驶航空器系统运行类别 | uavOptCategory | Integer | 1 | 否 | 否 | 无人机的运行类别:0:未定义;1:开放类;2:特定类;3:审定类;4~15:预留 |
| 15 | 民用无人驾驶航空器分类 | uavCategory | Integer | 1 | 是 | 否 | 无人机的分类:0:微型无人驾驶航空器;1:轻型无人驾驶航空器;2:小型无人驾驶航空器;3:中型无人驾驶航空器;4:大型无人驾驶航空器;5~15:预留 |
| 16 | 民用无人驾驶航空器遥控站位置类型 | uavControlStationSiteType | Integer | 1 | 是 | 否 | 无人机遥控站位置类型:0:起飞点位置;1:遥控站位置;2~15:预留 |
| 17 | 民用无人驾驶航空器遥控站位置 | uavControlStationSite | String | 30 | 是 | 否 | 无人机遥控站位置的经度与纬度,单位:度,格式:经度|纬度,西经、南纬以负值表示,精确到小数点后7位,乘10的7次方后传输,对于未知或不可用时取值(默认值)-10000000|-10000000 |
| 18 | 民用无人驾驶航空器遥控站高度 | uavControlStationSiteHeight | Integer | 10 | 是 | 否 | 无人机遥控站基于当前坐标系的大地高度,单位:m,精确到小数点后1位,乘10以后传输,未知或不可用时编码值取“-999999” |
| 19 | 大地高度 | geodeticHeight | Integer | 10 | 是 | 否 | 无人机基于当前坐标系的大地高度,单位:m,精确到小数点后1位,乘10以后传输,未知或不可用时编码值取“-999999” |
| 序号 | 字段 | 字段代码 | 字段类型 | 字段长度(byte) | 是否必填 | 是否加密 | 描述及要求 |
| 20 | 水平精度 | horizontalAccuracy | Integer | 1 | 是 | 否 | 水平位置精度。置信度为95%,取值范围为:0:大于等于18.52 km(10 n mile)或未知;1:小于18.52 km(10 n mile);2:小于7.41 km(4 n mile);3:小于3.70 km(2 n mile);4:小于1852 m(1 n mile);5:小于926 m(0.5 n mile);6:小于556 m(0.3 n mile);7:小于185 m(0.1 n mile);8:小于92.6 m(0.05 n mile);9:小于30 m;10:小于10 m;11:小于3 m;12:小于1 m;13~15:预留 |
| 21 | 垂直精度 | verticalAccuracy | Integer | 1 | 是 | 否 | 垂直位置精度。置信度为95%,取值范围为:0:大于等于150 m或未知;1:小于150 m;2:小于45 m;3:小于25 m;4:小于10 m;5:小于3 m;6:小于1 m;7~15:预留 |
| 22 | 速度精度 | speedAccuracy | Integer | 1 | 是 | 否 | 速度精度。置信度为95%,取值范围为:0:大于等于10 m/s或未知;1:小于10 m/s;2:小于3 m/s;3:小于1 m/s;4:小于0.3 m/s;5~15:预留 |
| 序号 | 字段 | 字段代码 | 字段类型 | 字段长度 (byte) | 是否必填 | 是否加密 | 描述及要求 |
| 23 | 时间戳精度 | timeStampAccuracy | Integer | 1 | 是 | 否 | 编入时间戳的时刻与真实时刻的精度范围,包括授时精度与授时信号编入信息的时间。取值范围为:0:大于0.5s或未知;1:小于或等于0.5s;2:小于或等于0.4s;3:小于或等于0.3s;4:小于或等于0.2s;5:小于或等于0.1s;6:小于或等于50ms;7:小于或等于20ms;8:小于或等于10ms;9~15:预留 |
| 24 | 运行状态 | operatingStatus | Integer | 1 | 是 | 否 | 无人机运行状态:0:未报告;1:地面;2:空中;3:民用无人驾驶航空器为紧急状态;4:运行识别发送功能失效(民用无人驾驶航空器为非紧急状态);5:运行识别发送功能失效(民用无人驾驶航空器为紧急状态);6~15:预留 |
| 25 | 真高 | tHeight | Integer | 10 | 否 | 否 | 无人机相对于当前位置的真高,单位:m,精确到小数点后1位,乘10以后传输 |
| 序号 | 字段 | 字段代码 | 字段类型 | 字段长度(byte) | 是否必填 | 是否加密 | 描述及要求 |
| 1 | 响应状态 | code | Integer | 3 | 是 | 否 | 响应状态:200:成功;400:输入参数错误;401:认证失败;403:无权限访问;429:请求过于频繁;500:服务器内部错误 |
| 2 | 描述 | msg | String | - | 是 | 否 | 返回信息描述 |
| 3 | 广播式运行识别信息报送结果信息 | data | JSON | - | 是 | 否 | 按照表78 广播式运行识别信息报送结果信息 |
| 序号 | 字段 | 字段代码 | 字段类型 | 字段长度(byte) | 是否必填 | 是否加密 | 描述及要求 |
| 1 | 报送结果 | reportSts | Integer | 1 | 是 | 否 | 响应状态:0:报送失败;1:报送成功 |
11 心跳探测数据接口
通讯协议
接口应采用https通信协议。
数据传输
数据传输应满足如下要求:
a) 使用 RESTful API 方式,以 JSON 作为数据交换格式;
b) 请求方式:post;
c) 请求头:Content-Type: application/json; charset=utf-8;
d) 请求频率:心跳发送频率不低于一分钟每次。
输入参数
输入参数应符合表79的要求,接口请求及响应示例见附录B.25.1。
| 序号 | 字段 | 字段代码 | 字段类型 | 字段长度(byte) | 是否必填 | 是否加密 | 描述及要求 |
| 1 | 单位id | id | String | 36 | 是 | 否 | 单位id |
| 2 | 随机码 | randomCode | String | 6 | 是 | 否 | 6位随机字符串 |
| 3 | 请求时间 | timeStamp | String | 19 | 是 | 否 | 发送请求的时间,格式:"yyyy-MM-dd HH:mm:ss" |
输出参数
输出参数应符合表80的要求,接口请求及响应示例见附录B.25.2。
| 序号 | 字段 | 字段代码 | 字段类型 | 字段长度(byte) | 是否必填 | 是否加密 | 描述及要求 |
| 1 | 响应状态 | code | Integer | 3 | 是 | 否 | 响应状态:200:成功;400:输入参数错误;401:认证失败;403:无权限访问;429:请求过于频繁;500:服务器内部错误 |
| 2 | 描述 | msg | String | - | 是 | 否 | 返回信息描述 |
附录 A(资料性) 加密、解密示例
A.1 加密过程
A.1.1 请求方对实名登记、操控员资质、运营许可各接口中的请求参数进行SM4加密,将加密后的密文作为统一请求参数的body字段值进行数据交换。
A.1.2 请求方对运行管理各接口中的敏感字段(参数说明列表中“是否加密”项为是的字段)进行SM 4加密,再将加密后的整体数据根据字段名的自然顺序进行排序(注:需排除NULL值的属性)并转成JS ON字符串。使用ussKey对JSON字符串中除了签名字段“sign”以外的所有字段进行SM3散列值计算得到散列值。使用ussKey对得到的散列值进行SM4加密得到sign,并将sign赋值给统一报文格式中的sign字段。
A.2 解密过程
A.2.1 接收方得到实名登记、操控员资质、运营许可各接口请求体后通过 SM4 解密得到明文,将得到明文解析成JSON数据格式进行数据交换。
A.2.2 接收方得到运行管理各接口请求体后取出统一报文格式中sign属性内容,使用ussKey对sign进行SM4解密得到发送方的散列值。对除sign外的整体数据根据字段名的自然顺序进行排序 (注:需排除NULL值的属性) 并转成JSON字符串。使用ussKey对JSON字符串进行SM3散列值计算得到散列值(对两者的散列值进行比对,判断数据是否合法并完整)。M
A.3 加密类型说明
SM4加密统一采用CBC模式进行加密。
A.4 数据加密、 解密示例
A.4.1 SM4工具示例如下。
import lombok.extern.slf4j.Slf4j;
import org.apache.commons.codec.binary.Hex;
import org.bouncycastle.jce.provider.BouncyCastleProvider;
import org.bouncycastle.pqc.math.lineargebra.ByteUtils;
import javax.crypto.Cipher;
import javax.crypto.KeyGenerator;
import javax.crypto.spec.IvParameterSpec;
import javax.crypto.spec.SecretKeySpec;
import java.security.*;
import java.util.Arrays;
import java.util.HashMap;
@Slf4j
public class Sm4Util {
static {
Security.addProvider(new BouncyCastleProvider());
}
private static final String ENCODING = "UTF-8";
public static final String ALGORITHM_NAME = "SM4";
// 加密算法/分组加密模式/分组填充方式
// 定义分组加密模式使用:PKCS7Padding
public static final String ALGORITHM_NAME_ECB_PADDING = "SM4/CBC/PKCS7PADDING";
public static final byte[] iv = {0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0};
// 128-32 位 16 进制; 256-64 位 16 进制
public static final int DEFAULT_KEY_SIZE = 128;
/**
* 自动生成密钥
*
* @return
* @explain
*/
public static String generateKey() {
try {
return new String(Hex.encodeHex(generateKey(DEFAULT_KEY_SIZE), false));
} catch (Exception e) {
log.error("自动生成密钥出现异常",e);
}
return null;
}
/**
* @param keySize
* @return
* @throws Exception
* @explain
*/
public static byte[] generateKey(int keySize) throws Exception {
KeyGenerator kg = KeyGenerator.getInstance(ALGORITHM_NAME, BouncyCastleProvider.PROVIDER_NAME);
kg.init(keySize, new SecureRandom());
return kg.generateKey().getEncoded();
}
/**
* sm4 加密
*
* @param hexKey 16 进制密钥 (忽略大小写)
* @param paramStr 待加密字符串
* @return 返回 16 进制的加密字符串
* @explain 加密模式: CBC
*/
public static String encryptEcb(String hexKey, String paramStr) {
try {
String cipherText = "";
// 16 进制字符串-->byte[]
byte[] keyData = ByteUtils.fromHexString(hexKey);
// String-->byte[]
byte[] srcData = paramStr.getBytes(ENCODING);
// 加密后的数组
byte[] cipherArray = encryptPadding(keyData, srcData);
// byte[]-->hexdigest
cipherText = ByteUtils.toHexString(cipherArray);
return cipherText;
} catch (Exception e) {
log.error("sm4 加密出现异常, paramStr="+paramStr + ", hexKey="+hexKey,e);
return paramStr;
}
}
/**
* @param cipherText 16 进制的加密字符串(忽略大小写)
* @param hexKey 16 进制密钥
* @return 解密后的字符串
* @throws Exception
* @explain 解密模式:采用 CBC
*/
public static String decryptEcb(String hexKey, String cipherText) {
// 用于接收解密后的字符串
String decryptStr = "";
// hexString-->byte[]
byte[] keyData = ByteUtils.fromHexString(hexKey);
// hexString-->byte[]
byte[] cipherData = ByteUtils.fromHexString(cipherText);
// 解密
byte[] srcData = new byte[0];
try {
srcData = decryptPadding(keyData, cipherData);
// byte[]-->String
decryptStr = new String(srcData, ENCODING);
} catch (Exception e) {
log.error("sm4 解密出现异常,cipherText="+cipherText+", hexKey="+hexKey,e);
}
return decryptStr;
}
/**
* 生成 CBC 暗号
*
* @param algorithmName 算法名称
* @param mode 模式
* @param key
* @return
* @throws Exception
* @explain CBC 模式
*/
private static Cipher generateEcbCipher(String algorithmName, int mode, byte[] key) throws Exception {
Cipher cipher = Cipher.getInstance(algorithmName, BouncyCastleProvider.PROVIDER_NAME);
SecretKeySpec sm4Key = new SecretKeySpec(key, 0, 16, ALGORITHM_NAME);
IvParameterSpec ivSpec = new IvParameterSpec(iv, 0, 16);
cipher.init(mode, sm4Key, ivSpec);
return cipher;
}
/**
* 加密模式
*
* @param key
* @param data
* @return
* @throws Exception
* @explain
*/
private static byte[] encryptPadding(byte[] key, byte[] data) throws Exception {
Cipher cipher = generateEcbCipher(ALGORITHM_NAME_ECB_PADDING, Cipher.ENCRYPT_MODE, key);
return cipher.doFinal(data);
}
/**
* 解密模式
*
* @param key
* @param cipherText
* @return
* @throws Exception
* @explain
*/
private static byte[] decryptPadding(byte[] key, byte[] cipherText) throws Exception {
Cipher cipher = generateEcbCipher(ALGORITHM_NAME_ECB_PADDING, Cipher.DECRYPT_MODE, key);
return cipher.doFinal(cipherText);
}
/**
* 校验加密前后的字符串是否为同一数据
*
* @param hexKey 16 进制密钥(忽略大小写)
* @param cipherText 16 进制加密后的字符串
* @param paramStr 加密前的字符串
* @return 是否为同一数据
* @throws Exception
* @explain
*/
public static boolean verifyEcb(String hexKey, String cipherText, String paramStr) throws Exception {
// 用于接收校验结果
boolean flag = false;
// hexString-->byte[]
byte[] keyData = ByteUtils.fromHexString(hexKey);
// 将 16 进制字符串转换成数组
byte[] cipherData = ByteUtils.fromHexString(cipherText);
// 解密
byte[] decryptData = decryptPadding(keyData, cipherData);
// 将原字符串转换成 byte[]
byte[] srcData = paramStr.getBytes(ENCODING);
// 判断 2 个数组是否一致
flag = Arrays.equals(decryptData, srcData);
return flag;
A.4.2 SM3工具示例如下。
import org.bouncycastle.crypto.digests.SM3Digest;
import org.bouncycastle.crypto.macs.HMac;
import org.bouncycastle.crypto.params.KeyParameter;
import org.bouncycastle.pqc.math.lineargebra.ByteUtils;
import java.io.BufferedReader;
import java.io.FileWriter;
import java.security.MessageDigest;
import java.util.Arrays;
/**
* @author rookie li
* @date 2023/6/15 17:00
*/
public class SM3Util {
/**
* 校验源数据与加密数据是否一致
*
* @param src 源数据
* @param sm3HexStr 16 进制的加密数据
* @return
* @throws Exception
*/
public static boolean verify(String src, String sm3HexStr) throws Exception {
byte[] sm3HashCode = ByteUtils.fromHexString(sm3HexStr);
byte[] newHashCode = getEncryptBySrcByte(src.getBytes(ENCODING));
return Arrays.equals(newHashCode, sm3HashCode);
}
/**
* SM3 加密方式之:不提供密钥的方式 SM3 加密,返回加密后长度为 64 位的 16 进制字符串
*
* @param src 明文
* @return
*/
public static String encrypt(String src) {
return ByteUtils.toHexString(getEncryptBySrcByte(src.getBytes()));
}
/**
* 返回长度为 32 位的加密后的 byte 数组
*
* @param srcByte
* @return
*/
public static byte[] getEncryptBySrcByte(byte[] srcByte) {
SM3Digest sm3 = new SM3Digest();
sm3.update(srcByte, 0, srcByte.length);
byte[] encryptByte = new byte[sm3.getDigestSize()];
sm3.doFinal(encryptByte, 0);
return encryptByte;
}
/**
* 利用源数据+密钥校验与密文是否一致
*
* @param src 源数据
* @param key 密钥
* @param sm3HexStr 密文
* @return
* @throws Exception
*/
public static boolean verify(String src, String key, String sm3HexStr) throws Exception {
byte[] sm3HashCode = ByteUtils.fromHexString(sm3HexStr);
byte[] newHashCode = getEncryptByKey(src, key);
return Arrays.equals(newHashCode, sm3HashCode);
}
private static final String ENCODING = "UTF-8";
/**
* 加密
*
* @param src 明文
* @param key 密钥
* @return
* @throws Exception
*/
public static String encrypt(String src, String key) throws Exception {
return ByteUtils.toHexString(getEncryptByKey(src, key));
}
/**
* SM3 加密方式之: 根据自定义密钥进行加密, 返回加密后长度为 32 位的 16 进制字符串
*
* @param src 源数据
* @param key 密钥
* @return
* @throws Exception
*/
public static byte[] getEncryptByKey(String src, String key) throws Exception {
byte[] srcByte = src.getBytes(ENCODING);
byte[] keyByte = key.getBytes(ENCODING);
ParamParameter keyParameter = new ParamParameter(keyByte);
SM3Digest sm3 = new SM3Digest();
HMac hMac = new HMac(sm3);
hMac.init(keyParameter);
hMac.update(srcByte, 0, srcByte.length);
byte[] result = new byte[hMac.getMacSize()];
hMac.doFinal(result, 0);
return result;
}
A.4.3 加密与解密代码示例如下。
String id = "123456";
String ussKey = "75c72c1781ccbbad58eebe0fd2210742";
//统一报文格式实体类
USSCheckBody defUSSCheckBody = USSCheckBody.getDefUSSCheckBody();
defUSSCheckBody.setId (id);
PlanInfo planInfo = new PlanInfo();
//敏感信息 SM4 加密
planInfo.setPsnCardno(Sm4Util.encryptEcb(ussKey, "510125188611112114"));
defUSSCheckBody.setBizContent(planInfo);
//加密数据整体进行 SM3 散列值,FASTJSON 默认去除值为 NULL 的属性
String s = JSONObject.toJSONString(defUSSCheckBody, SerializerFeature.MapSortField);
String hash_sign = SM3Util.encrypt(s, ussKey);
//对散列值进行 SM4 加密
String sign = Sm4Util.encryptEcb(ussKey, hash_sign);
//获取 SM4 加密后的字符串赋值到 sign
defUSSCheckBody.setSign(sign);
//解密过程
//得到请求体中的 json 数据
String body = JSON.toJSONString(defUSSCheckBody);
//获取除 sign 外的 json 串
JSONObject jsonObject = JSONObject.parseObject(body);
sign = (String) jsonObject.remove("sign");
//进行 SM4 解密得到发送方 sm3 散列值
hash_sign = Sm4Util.decryptEcb(ussKey, sign);
//通过 SM3 得到接收数据的散列值
String ss = JSONObject.toJSONString(jsonObject, SerializerFeature.MapSortField);
String new_hash_sign = SM3Util.encrypt(ss, ussKey);
//比较散列值, 一样验证通过, 不一致数据不完整, 抛弃
if (new_hash_sign.equals(hash_sign)) {
//可通过 SM4 解密得到明文数据
String o = (String) ((JSONObject) jsonObject.get("bizContent")).get("psnCardno");
String s1 = Sm4Util.decryptEcb(ussKey, o);
System.out.println(s1);
}

附录 B(资料性) B.1 根据 UAS 码和 UPIC_MSN 码校验实名登记状态接口
B.1.1 根据UAS码和UPIC_MSN码校验实名登记状态接口输入参数示例如下。
输入参数中的 body 需要进行加密,下面是加密前和加密后的示例,正常传递需要用加密后的参数进行请求:
加密前输入参数:
{
"id": "0f6a6bcb-84bd-4c33-9f7e-55edc26d6a12",
"body": "{{uas" : "UAS026185XX","upicMsn" : "3N3BJ7M01200FXX"}}
}
加密后输入参数:
{
"id": "0f6a6bcb-84bd-4c33-9f7e-55edc26d6a12",
"body":
"1d01a1441900c20547c63d2e83a318ce1d99b2e09492454bbbe57d43c4867ce12a21b2594b72d354a5741ac5ec7404cd57b7f179dd431beec60cdb7e7f1156aa0a8e26050e08af7bef7c2793ebc0f58774cddabc9500eb3e5bacaeaf4496785dc9ab6b66c0d39fa1cfecee1dcb007ec7524f95f1bdfe91d45d2ae72e82161276d01bba49c6bb53724bfb366733cd98f4"
}
B.1.2 根据UAS码和UPIC_MSN码校验实名登记状态接口输出参数示例如下。
返回失败示例:
{
"msg":"解密后得到的参数不合法",
"code":"401"
}
返回成功示例:
{
"code":"200",
"msg":"校验完成",
"data":{
"uavState":"0"
}
}
B.2 根据 UAS 码和 UPIC_MSN 码查询实名登记数据接口
B.2.1 根据UAS码和UPIC_MSN码查询实名登记数据接口输入参数示例如下。
输入参数中的 body 需要进行加密,下面是加密前和加密后的示例,正常传递需要用加密后的参数进行请求:
加密前输入参数:
{
"id": "0f6a6bcb-84bd-4c33-9f7e-55edc26d6a12",
"body": "{{uas" : "UAS026185XX","upicMsn" : "3N3BJ7M01200FXX"}"
}
加密后输入参数:
{
"id": "0f6a6bcb-84bd-4c33-9f7e-55edc26d6a12",
"body":
"91ca6ad3610f89e1e9439eb17a6b4b8fe1854f87a96cc20e739eb2331c8ecfde96087ff1e9a07bf422024a781b0418fd1013a389afb933f15996275ad5c6b386"
}
注:该接口输入参数中的 planId 为可选参数,如果您需要通过该飞行活动申请 id 查询,需要将该参数按照上述 JSON格式进行拼接加密后,形成新的查询体,再对接口进行请求,示例如下。
加密前输入参数:
{
"id": "0f6a6bcb-84bd-4c33-9f7e-55edc26d6a12",
"body": "{{"uas" : "UAS026185XX","upicMsn" : "3N3BJ7M01200FXX","planId" : "xxxxxxxxxxxx"}
}
加密后输入参数:
{
"id": "0f6a6bcb-84bd-4c33-9f7e-55edc26d6a12",
"body":
"91ca6ad3610f89e1e9439eb17a6b4b8fe1854f87a96cc20e739eb2331c8ecfde96087ff1e9a07bf422024a781b0418fd1013a389afb933f15996275ad5c6b386xxxxxx"
}
B.2.2 根据UAS码和UPIC_MSN码查询实名登记数据接口输出参数示例如下。
返回示例(data 加密):
{
"code":"200",
"msg":"查询完成",
"data":"d8fc7ac1318d46d9-861afbe5f1db7ab5 9a966c5edb99-4cd6a8ca7689626ddf37"
}
data 解密后:
{
"uavState":"0",
"uavUserType":"0",
"uavType":"1",
"uas":"UAS026185XX",
"uavName":"无人机",
"uavModel":"xxxxx",
"uavManufacturer":"XXXXX",
"uavEmptyWeight":"4",
"uavMaxWeight":"7",
"uavPersonName":"XXX",
"uavPersonCardType":"3",
"uavPersonCardNum":"111111XXXXXXXXX",
"uavPersonPhone":"130XXXXXXXXX",
"uavUscCode":"310XXXXXXXXXXXXXXXXX",
"uavUnitType":"010101",
"uavUnit":"XXXXXX",
"uavUnitContact":"XXXXXX",
"uavUnitPhone":"XXXXXX"
}
B.3 根据 UPIC_MSN 码和生产厂商统一社会信用代码查询实名登记数据接口
B. 3. 1 根据UPIC_MSN码和生产厂商统一社会信用代码查询实名登记数据接口输入参数示例如下。
输入参数中的 body 需要进行加密,下面是加密前和加密后的示例,正常传递需要用加密后的参数进行请求:
加密前输入参数:
{
"id": "0f6a6bcb-84bd-4c33-9f7e-55edc26d6a12",
"body": "{\" uscCode" : "44030601240XXXXXXXX","upicMsn" : "3N3BJ7M01200FXX"}
}
加密后输入参数:
{
"id": "0f6a6bcb-84bd-4c33-9f7e-55edc26d6a12",
"body":
"12457658ca6ad3610f891249eb17a6b4b8fe185jtey3246cc20e739eb2331c8ecfde96087ff1e9a07bf422024a781b041834613a389afb933f15996212425ad5c6b386"
}
B.3.2 根据UPIC_MSN码和生产厂商统一社会信用代码查询实名登记数据接口输出参数示例如下。
返回示例(data 加密):
{
"code":"200",
"msg":"查询完成",
"data":"12437ac1318d46d9-861afbesdga 9a-966c5ed123421453456df37"
}
data 解密后:
{
"uavState":"0",
"uavUserType":"0",
"uavType":"1",
"uas":"UAS026185XX",
"uavName":"无人机",
"uavModel":"xxxxx",
"uavManufacturer":"XXXXX",
"uavEmptyWeight":"4",
"uavMaxWeight":"7",
"uavPersonName":"XXX",
"uavPersonCardType":"3",
"uavPersonCardNum":"111111XXXXXXXXX",
"uavPersonPhone":"130XXXXXXXXX",
"uavUscCode":"310XXXXXXXXXXXXXXXXX",
"uavUnitType":"010101",
"uavUnit":"XXXXXX",
"uavUnitContact":"XXXXXX",
"uavUnitPhone":"XXXXXX"
}
B.4 操控员执照数据校验接口
B.4.1 操控员执照数据校验接口输入参数示例如下。
输入参数中的 body 需要进行加密,下面是加密前和加密后的示例,正常传递需要用加密后的参数进行请求:
加密前输入参数:
{
"id": "xxxxxxx",
"body": "{"uavrpName": " 杨 扬 ","uavrpCertNo": "3623212xxxx1294339","licenseType": "0","classRating": "2","licenseRating": "0","bvlosRating": " ","instructorRating": " "}"
}
加密后输入参数:
{
"id": "xxxxxxx",
"body": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
}
B.4.2 操控员执照数据校验接口输出参数示例如下。
{
"code":"200",
"msg":"查询完成",
"data":{
"state":"1"
}
}
B.5 操控员执照数据查询接口
B.5.1 操控员执照数据查询接口输入参数示例如下。
输入参数中的 body 需要进行加密,下面是加密前和加密后的示例,正常传递需要用加密后的参数进行请求:
加密前输入参数:
{
"id": "xxxxxxx",
"body": "{\"uavrpName": "杨扬","uavrpCertNo": "3623212xxxx1294339","licenseType": "0",
"classRating": "2","licenseRating": "0","bvlosRating": " ","instructorRating": " "}"
}
加密后输入参数:
{
"id": "xxxxxxx",
"body": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
}
注:该接口输入参数中的 planId 为可选参数,如果您需要通过该飞行活动申请 id 查询,需要将该参数按照上述 JSON
格式进行拼接加密后,形成新的查询体,再对接口进行请求,示例如下。
加密前输入参数:
{
"id": "xxxxxxx",
"body": "{\"uavrpName": "杨扬","uavrpCertNo": "3623212xxxx1294339","licenseType": "0","classRating":
"2","licenseRating": "0","bvlosRating": " ","instructorRating": " ","planId": "xxxxxxxxxxxx"}
}
加密后输入参数:
{
"id": "xxxxxxx",
"body": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
}
B.5.2 操控员执照数据查询接口输出参数示例如下。
返回示例(data 加密)
{
"code":"200",
"msg":"查询完成",
"data":
"sda15s4d5a4d5ad15adas1d1a1sda3s1d3asdas5d64s4d9a8s7d98q798we4q611sd2a1c1z56aasd46a4x54c54as15czx1c15q4654qw4e1asxc1z12xc1as3s12d5a64d68q4d8qw511d3z1xc3215g5rg6dt45fh4gtf48b1cv1b31tr56th4h46fg51vb1vc1b56grn46gf4n89fm8f84ng16f65g13"
}
data 解密后:
{
"state":"1",
"uavrpName":"杨扬",
"licenseNo": "362321xxxx11294339",
"issueDate": "2018-08-01 00:00:00",
"updateDate": "2022-09-05 00:00:00",
"invalidDate": "2024-09-05 00:00:00",
"levelList": [
{
"licenseType": "0",
"classRating": "1",
"licenseRating": "1",
"bvlosRating": "",
"instructorRating": ""
}
]
}
B.6 理论合格证数据校验接口
B.6.1 理论合格证数据校验接口输入参数示例如下。
输入参数中的 body 需要进行加密,下面是加密前和加密后的示例,正常传递需要用加密后的参数进行请求:
加密前输入参数:
{
"id": "xxxxxxx",
"body": "{ "name": "杨扬","certNo": "362321xxxx11294339"}
}
加密后输入参数:
{
"id": "xxxxxxx",
"body":"xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
}
B.6.2 理论合格证数据校验接口输出参数示例如下。
返回示例:
{
"code":"200",
"msg":"查询完成",
"data":{
"state":"1"
}
}
B.7 理论合格证数据查询接口
B.7.1 理论合格证数据查询接口输入参数示例如下。
输入参数中的 body 需要进行加密,下面是加密前和加密后的示例,正常传递需要用加密后的参数进行请求:
加密前输入参数:
{
"id": "xxxxxxx",
"body": "{ "name": "杨扬","certNo": "362321xxxx11294339"}
}
加密后输入参数:
{
"id": "xxxxxxx",
"body":"xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
}
注:该接口输入参数中的 planId 为可选参数,如果您需要通过该飞行活动申请 id 查询,需要将该参数按照上述 JSON 格式进行拼接加密后,形成新的查询体,再对接口进行请求,示例如下。
加密前输入参数:
{
"id": "xxxxxxx",
"body": "{" "name": "杨扬","certNo": "362321xxxx11294339","planId" : "xxxxxxxxxxxx"}
}
加密后输入参数:
{
"id": "xxxxxxx",
"body": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
}
B.7.2 理论合格证数据查询接口输出参数示例如下。
输出参数示例(data 加密):
{
"code":"200",
"msg":"查询完成",
"data":
"sda15s4d5a4d5ad15adas1d1a1sda3s1d3asdas5d64s4d9a8s7d98q798we4q611sd2a1c1z56aasd46a4x54c54as15czx1c15q4654qw4e1asxc1z12xc1as3s12d5a64d68q4d8qw511d3z1xc3215g5rg6dt45fh4gtf48b1cv1b31tr56th4h46fg51vb1vc1b56gn46gf4n89fm8f84ng16f65g13"
}
data 解密后:
{
"state":"XXXX",
"name":"XXXX",
"gender":"XXXX",
"certNo":"XXXX",
"licenseClass":"XXXX",
"licenseNo":"XXXX",
"issueDate":"XXXX",
"invalidDate":"XXXX",
}
B.8 运营合格证数据校验接口
B.8.1 运营合格证数据校验接口输入参数示例如下。
输入参数中的 body 需要进行加密,下面是加密前和加密后的示例,正常传递需要用加密后的参数进行请求:
加密前输入参数:
{
"id": "0f6a6bcb-84bd-4c33-9f7e-55edc26d6a12",
"body": "{"uavUnitName":"xxxxxxxxxxx","uavUscCode":"xxxxxxxxxxx"}"
}
加密后输入参数:
{
"id": "0f6a6bcb-84bd-4c33-9f7e-55edc26d6a12",
"body":
"1d01a1441900c20547c63d2e83a318ce1d9962e09492454bbbe5743c4867ce12a2162594672d354a5741ac5ec7404cd57b7f179dd431beec60cdb7e7f1156aa0a8e26050e08af7bef7c2793ebc0f58774cddabc9500eb3e5bacaeaf4496785dc9ab6b66c0d39fa1cfecee1dcb007ec7524f95f1bdfe91d45d2ae72e"
}
B.8.2 运营合格证数据校验接口输出参数示例如下。
输出参数示例:
{
"code":"200",
"msg":"查询完成",
"data":{
"state":"1"
}
}
B.9 运营合格证数据查询接口
B.9.1 运营合格证数据查询接口输入参数示例如下。
输入参数中的 body 需要进行加密,下面是加密前和加密后的示例,正常传递需要用加密后的参数进行请求:
加密前输入参数:
{
"id": "0f6a6bcb-84bd-4c33-9f7e-55edc26d6a12",
"body": "{"uavUnitName":"xxxxxxxxxxx","uavUscCode":"xxxxxxxxxxx"}"
}
加密后输入参数:
{
"id": "0f6a6bcb-84bd-4c33-9f7e-55edc26d6a12",
"body": "1d01a1441900c20547c63d2e83a318ce1d9962e09492454bbbe5743c4867ce12a2162594672d354a5741ac5ec7404cd57b7f179dd431beec60cdb7e7f1156aa0a8e26050e08af7bef7c2793ebc0f58774cddabc9500eb3e5bacaeaf4496785dc9ab6b66c0d39fa1cfeceeldcb007ec7524f95f1bdfe91d45d2ae72e"
}
注:该接口输入参数中的 planId 为可选参数,如果您需要通过该飞行活动申请 id 查询,需要将该参数按照上述 JSON格式进行拼接加密后,形成新的查询体,再对接口进行请求,示例如下。
加密前输入参数:
{
"id": "xxxxxxxx",
"body": "{"uavUnitName":"xxxxxxxxxxx","uavUscCode":"xxxxxxxxxxx","planId":"xxxxxxxxxxx"}"
}
加密后输入参数:
{
"id": "xxxxxxxx",
"body": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
B.9.2 运营合格证数据查询接口输出参数示例如下。
输出参数示例(data 加密):
{
"code":"200",
"msg":"查询成功",
"data":"DF4J3486JKC9ERDTSDF23DG49CVDFKJK345JK2340DFE"
}
data 解密后:
{
"state":"1",
"certNumber":"CAAC_HB_xxxxxxxxxxxxx",
"certOperator":"运营人名称 1111",
"certAddress":"运营人地址 1111",
"certPrincipalBase":"主运行基地 1111",
"certContactPerson":"运行管理联系人1111",
"certCategory":"1,2",
"certCommercial":"2,3",
"certIssuedDate":"2024-01-01 00:00:00",
"certReissuedDate":"2024-10-31 00:00:00",
"certAuthority":"中国民用航空局"
}
B.10 适飞空域查询接口
B.10.1 适飞空域查询接口输入参数示例如下。
{
"id": "6f6a6fcb-84bd-6y99-7f5a-88edc26cda12",
"format": "JSON",
"sign":
"3a5d9c0897e3cdsc5445682ee4f8ee7a7f344b588df1b412898f9cafe5b7d0e399ddf7cb09975e15032bb0cade3775872670e61e1d797c6aa2744ab0c5a3ee6f2b7e63efa70031579603571d4f43fggr",
"timeStamp": "2024-01-24 09:35:15",
"version": "1.0",
"type": "1",
"bizContent": {
"distCode": "440300"
},
"charset": "utf-8",
"signType": "SM3"
}
B.10.2 适飞空域查询接口输出参数示例如下。
{
"id": "6f6a6fcb-84bd-6y99-7f5a-88edc26cda12",
"format": "JSON",
"sign": "6gy89c0897e3cdsc5445682ee4f8ee7a7f344b588df1b412898f9cafe5b7d0e399ddf7cb09975e15032bb0cad
e3775872670e61e1d797c6aa2744ab0c5a3ee6f2b7e63efa70031579603571d4f43fggr",
"timeStamp": "2024-01-24 09:35:26",
"version": "1.0",
"type": "1",
"bizContent": {
"code": "200",
"msg": "操作成功",
"data": [{
"flyableAirspace":
"114.433594, 22.675781|114.433594, 22.719727|114.477539, 22.719727|114.477539, 22.675780;114.341583, 22.767
792|114.341583, 22.769165|114.342957, 22.769165|114.342957, 22.767792;114.301758, 22.758179|114.301758, 22.
763672|114.307251, 22.763672|114.307251, 22.758179"
}
]
},
"charset": "utf-8",
"signType": "SM3"
}
B.11 临时管制空域需求申请接口
B.11.1 临时管制空域需求申请接口输入参数示例如下。
输入参数中的 bizContent 部分字段需要进行加密,下面是加密前和加密后的示例,正常传递需要用加密后的参数进行请求:
加密前的输入参数:
{
"id": "6f6a6fcb-84bd-6y99-7f5a-88edc26cda12",
"format": "JSON",
"sign":
"a9fa6a6ed19df61a524cae2ccf212d2493b8e94d14921c0e76bd4bb8d00d6a23f7589c4bdff511ea0586511a30a63365558a6c2998d655cd05f48cbb4db368fa2b7e63efa70031579603571d4f43faae",
"timeStamp": "2024-01-24 09:39:54",
"version": "1.0",
"type": "2",
"bizContent": {
"reqDesc": "灭火",
"areaList": [{
"areaData":
"116.07268275, 34.10641615|116.14229161, 34.10734881|116.15602872, 34.03684195|116.01316282, 34.05731773",
"areaType": 1
}],
"applyTime": "2024-02-18 16:06:30",
"startTime": "2024-02-19 16:06:30",
"endTime": "2024-02-20 16:06:30",
"applicantUnit": "消防局",
"uscc": "914403007954257495",
"phone": "XXXXXXXXXX"
"files": null
},
"charset": "utf-8",
"signType": "SM3"
}
加密后的输入参数:
{
"id": "6f6a6fcb-84bd-6y99-7f5a-88edc26cda12",
"format": "JSON",
"sign":
"a9fa6a6ed19df61a524cae2ccf212d2493b8e94d14921c0e76bd4bb8d00d6a23f7589c4bdff511ea0586511a30a63365558a6c2998d655cd05f48cbb4db368fa2b7e63efa70031579603571d4f43faae",
"timeStamp": "2024-01-24 09:39:54",
"version": "1.0",
"type": "2",
"bizContent": {
"reqDesc": "灭火",
"areaList": [{
"areaData":
"85224c3eab5e0a225e811d6d1dab265028df70e462d51614d72e39f36cd5c73c5c0dd0fc4475ea966413834cda008bf6dd4a79c0dc7ea88991554cae56c77cce11101896acdf9198fb3e2871cce04499533e7430c947e14dc4d9f3eabe0cc25207b85cc78d344fbc322e4d8a75dde0f3a150534666c318fd692294c06310ab9d5f76f09878e6742b924859b820bf0d66",
"areaType": 1
}],
"applyTime": "2024-02-18 16:06:30",
"startTime": "2024-02-19 16:06:30",
"endTime": "2024-02-20 16:06:30",
"applicantUnit": "消防局",
"uscc": "914403007954257495",
"phone": "31c2ed387c4cd114c574921824cf17d0"
"files": null
},
"charset": "utf-8",
"signType": "SM3"
B.11.2 临时管制空域需求申请接口输出参数示例如下。
{
"id": "6f6a6fcb-84bd-6y99-7f5a-88edc26cda12",
"format": "JSON",
"sign":
"aac020c5bc1c0a3ee5a59ad649a9f67b02a5fc9b36988185f7e8b109984ce8e68a4bab397857e2bea01755bc58e2cb5dad12d402e808998ae72f0f360873c4952b7e63efa70031579603571d4f43faae",
"timeStamp": "2024-01-24 09:45:16",
"version": "1.0",
"type": "2",
"bizContent": {
"code": "200",
"msg": "操作成功",
"data": {
"tempControlReqId": "23"
}
},
"charset": "utf-8",
"signType": "SM3"
}
B.12 临时管制空域需求申请状态查询接口
B.12.1 临时管制空域需求申请状态查询接口输入参数示例如下。
{
"id": "6f6a6fcb-84bd-6y99-7f5a-88edc26cda12",
"format": "JSON",
"sign":
"c94a24df9d6f936bd28ed9854adc607683ff00dc87dc70710875cc6abaeaa2425dc47f41f47c8a46d06c613e4ef5abda0d1070142c3194eebd2637289b0040842b7e63efa70031579603571d4f43faae",
"timeStamp": "2024-01-24 09:48:26",
"version": "1.0",
"type": "3",
"bizContent": {
"tempControlReqId":"1"
}
"charset": "utf-8",
"signType": "SM3"
}
B.12.2 临时管制空域需求申请状态查询接口输出参数示例如下。
{
"id": "6f6a6fcb-84bd-6y99-7f5a-88edc26cda12",
"format": "JSON",
"sign":
"c63762bc066fbff58a5bc24d0de0244f9ae1cdf10c575af9cc2fa2d1fe0422149571648625d7c4790a9e0abfd7ac7dbb7d8f1fb17efb3bfbdc9f8eaf2ae0ed292b7e63efa70031579603571d4f43faae",
"timeStamp": "2024-01-24 09:54:25",
"version": "1.0",
"type": "3",
"bizContent": {
"code": "200",
"msg": "操作成功",
"data": {
"tempControlReqId": "1",
"applySts": "1",
"auditSts": "1",
"auditDesc": "通过",
"auditTime": "2025-10-28 16:47:25"
}
},
"charset": "utf-8",
"signType": "SM3"
}
B.13 临时管制空域需求申请变更/取消接口
B.13.1 临时管制空域需求申请变更接口输入参数示例如下。
输入参数中的bizContent部分字段需要进行加密,下面是加密前和加密后的示例,正常传递需要用加密后的参数进行请求:
加密前的输入参数:
{
"id": "6f6a6fcb-84bd-6y99-7f5a-88edc26cda12",
"format": "JSON",
"sign":
"c63762bc066fbff58a5bc24d0de0244f9ae1cdf10c575af9cc2fa2d1fe0422149571648625d7c4790a9e0abfd7ac7dbb7d8f1fb17efb3bfbdc9f8eaf2ae0ed292b7e63efa70031579603571d4f43faae",
"timeStamp": "2025-12-04 12:02:30",
"version": "1.0",
"type": "4",
"bizContent": {
"tempControlReqId":"1"
"optType":0
"reqDesc":"灭火"
"changeTime":"2025-12-04 12:02:30"
"startTime":""
"endTime":""
"applicantUnit":""
"uscc":""
"phone":"XXXXXXXXX"
"reason":"变更原因"
"files":null
},
"charset": "utf-8",
"signType": "SM3",
}
加密后输入参数:
{
"id": "6f6a6fcb-84bd-6y99-7f5a-88edc26cda12",
"format": "JSON",
"sign":
"c63762bc066fbff58a5bc24d0de0244f9ae1cdf10c575af9cc2fa2d1fe0422149571648625d7c4790a9e0abfd7ac7dbb7d8f1fb17efb3bfbdc9f8eaf2ae0ed292b7e63efa70031579603571d4f43faae",
"timeStamp": "2025-12-04 12:02:30",
"version": "1.0",
"type": "4",
"bizContent": {
"tempControlReqId":"1"
"optType":0
"reqDesc":"灭火"
"changeTime":"2025-12-04 12:02:30"
"startTime":""
"endTime":""
"applicantUnit":""
"uscc":""
"phone":"31c2ed387c4cd114c574921824cf17d0"
"reason":"变更原因"
"files":null
},
"charset": "utf-8",
"signType": "SM3"
}
B.13.2 临时管制空域需求申请变更接口输出参数示例如下。
{
"id": "6f6a6fcb-84bd-6y99-7f5a-88edc26cda12",
"format": "JSON",
"sign":
"82fdaf49b23b1a4c0ef90d9882541bf3482ee6201617a5388862ebbdd58e96962d9e4b1d2db06b7d44b5e91e640f50b4b35915209d2127455a1076d4227441ae2b7e63efa70031579603571d4f43faae",
"timeStamp": "2025-10-28 16:47:25",
"version": "1.0",
"type": "4",
"bizContent": {
"code": "200",
"msg": "操作成功",
"data": {
"tempControlReqId": "1"
}
}
"charset": "utf-8",
"signType": "SM3",
}
B.13.3 临时管制空域需求申请取消接口输入参数示例如下。
{
"id": "6f6a6fcb-84bd-6y99-7f5a-88edc26cda12",
"format": "JSON",
"sign":
"9ec9abf35d353990064f6b6122c8f599fb5905b5d52c42c5314fcb6d7a55f9f07bbbcf062a72b5d1297c9737f25ffc746706db24654be30d71bcb42030581fae2b7e63efa70031579603571d4f43faae ",
"timeStamp": "2025-12-04 12:02:30",
"version": "1.0",
"type": "4",
"bizContent": {
"tempControlReqId":"1"
"optType":1
"changeTime":"2025-12-04 12:02:30"
"reason":"取消原因"
"files":null
},
"charset": "utf-8",
"signType": "SM3"
}
B.13.4 临时管制空域需求申请取消接口输出参数示例如下。
"id": "6f6a6fcb-84bd-6y99-7f5a-88edc26cda12",
"format": "JSON",
"sign": "6FF83ACFB5AAB7F4B0335E74AAC8B1FA",
"timeStamp": "2025-10-28 16:47:25",
"version": "1.0",
"type": "4",
"bizContent": {
"code": "200",
"msg": "操作成功",
"data": {
"tempControlReqId": "1"
}
},
"charset": "utf-8",
"signType": "SM3"
}
B.14 一般/紧急飞行活动申请接口
B.14.1 一般/紧急飞行活动申请接口输入参数示例如下。
输入参数中的 bizContent 部分字段需要进行加密,下面是加密前和加密后的示例,正常传递需要用加密后的参数进行请求:
加密前的输入参数:
{
"id": "6f6a6fcb-84bd-6y99-7f5a-88edc26cda12",
"format": "JSON",
"sign":
"49d6babac066d90888efd2a22115afae96d80e97c5a80563024ba54906cd9329dcc7c393a0e87f339680e587d33a80f3aa36e00eaef317dfbeb92498c6de8c102b7e63efa70031579603571d4f43faae",
"timeStamp": "2024-01-24 10:25:48",
"type": "5",
"version": "1.0"
"bizContent": {
"applyTime": "2024-01-14 10:30:21",
"userType": "1",
"userName": "xxx",
"personCardType": "1",
"personCardNo": "xxxxxxxxxxxxxxxxxxxx",
"deptType": "",
"deptCode": "",
"contactPerson": "xxx",
"phone": "xxxxxxxxxx",
"email": "xxxxxxxxxx@qq.com",
"planType": "11",
"maxHeight": "120",
"planBeg": "2024-01-15 00:00:00",
"planEnd": "2024-01-15 10:00:00",
"tx11": "某某|xxxxxxxxxx",
"taskType": "8",
"optType": "1",
"flyType": "1",
"remarkQjbj": "无",
"remarkYjcz": "无",
"remarkTsxq": "无",
"remarkTdjn": "遥控传输,数据链路,惯性导航,卫星导航,没有被监视能力",
"remarkFxhx": "无",
"remarkZhkz": "无,无",
"remarkEcld": "无",
"remarkQtxx": "无",
"involvedSpecialPlan": "00000",
"uavAndDriver": [{
"upicMsn": "xxxxxxxxxxxxxx",
"uas": "UASxxxxxxxx",
"uavrpNam": "xxxxxx",
"uavrpCertNo": "xxxxxxxxxxxxxxxxxxxxx"
}]
"space": [{
"spcShape": "1",
"location":
"116.07268275, 34.10641615|116.14229161, 34.10734881|116.15602872, 34.03684195|116.01316282, 34.05731773",
"spcBottom": 1,
"spcTop": 180,
"spcCode": null
}],
"files": [],
"preAuditSts": "112",
"preAuditDesc": "单位1: 同意|单位2: 同意|单位3: 不同意"
}
"charset": "utf-8",
"signType": "SM3"
}
加密后输入参数:
{
"id": "6f6a6fcb-84bd-6y99-7f5a-88edc26cda12",
"format": "JSON",
"sign":
"49d6babac066d90888efd2a22115afae96d80e97c5a80563024ba54906cd9329dcc7c393a0e87f339680e587d33a80f3aa36e00eaef317dfbeb92498c6de8c102b7e63efa70031579603571d4f43faae",
"timeStamp": "2024-01-24 10:25:48",
"type": "5",
"version": "1.0"
"bizContent": {
"applyTime": "2024-01-14 10:30:21",
"userType": "1",
"userName": "xxx",
"personCardType": "1",
"personCardNo": "2e62d5d20e031b4c7b7b4436916986696c15c6f6bf40dcb8d1d6060c9f584d7d",
"deptType": "",
"deptCode": "",
"contactPerson": "b72d83d2d9de9d15b99860e412e721c1",
"phone": "376718b9c433d853e1785d4dba7e6765",
"email": "c0a52fd3a287f1fb3307650e8fc1a944c1358ea50c9c47737a461ec534ea0629",
"planType": "11",
"maxHeight": "120",
"planBeg": "2024-01-15 00:00:00",
"planEnd": "2024-01-15 10:00:00",
"tx11": "e88f7a73bf18b77f352413aec847028ad5a34d43d0f62f39c8423527bd2e3c87",
"taskType": "8",
"optType": "1",
"flyType": "1",
"remarkQjbj": "无",
"remarkYjcz": "无",
"remarkTsxq": "无",
"remarkTdjn": "遥控传输, 数据链路, 惯性导航, 卫星导航, 没有被监视能力",
"remarkFxhx": "无",
"remarkZhkz": "无,无",
"remarkEcld": "无",
"remarkQtxx": "无",
"involvedSpecialPlan": "00000",
"uavAndDriver": [{
"upicMsn": "xxxxxxxxxxxxxxxx",
"uas": "UASxxxxxxxx",
"uavrpNam": "xxxxxx",
"uavrpCertNo": "6h62d5d20e031bg58v7b44vv86696c15c6f6bf40dcb8d1d6060c9f58f48y"
}],
"space": [{
"spcShape": "1",
"location":
"f1ee82e4f63de4e57e60aa33d74f1df44abb6b32b222c9bd53f16b4ac1acdbe01298e0e0d104038a4c100e0817e0d0794a231dcfe31092d7d6270612edfca64c4360be444da6977640072aa1458288efd79de52fdafe01b370bc12f1fb75256f62f1852f3c4f581433d738dab0ffde58",
"spcBottom": 1,
"spcTop": 180,
"spcCode": null
}],
"files": [],
"preAuditSts": "112",
"preAuditDesc": "单位1: 同意|单位2: 同意|单位3: 不同意"
},
"charset": "utf-8",
"signType": "SM3",
}
B.14.2 一般/紧急飞行活动申请接口请输出参数示例如下。
{
"id": "6f6a6fcb-84bd-6y99-7f5a-88edc26cda12",
"format": "JSON",
"sign":
"58f01e4338dcdf777f5da1c6aff0d83309d5d60c102bbe4a0c17e34b987e62dc73623a14090530fe11343a7557fab69d8737f68200a359566b839f9b8155a0b12b7e63efa70031579603571d4f43faae",
"timeStamp": "2024-01-24 09:50:01",
"version": "1.0",
"type": "5",
"bizContent": {
"code": "200",
"msg": "操作成功",
"data": {
"planId": "732"
}
}
"charset": "utf-8",
"signType": "SM3",
}
B.15 长期/场内飞行活动申请接口
B.15.1 长期飞行活动申请输入参数示例如下。
输入参数中的 bizContent 部分字段需要进行加密,下面是加密前和加密后的示例,正常传递需要用加密后的参数进行请求:
加密前输入参数:
{
"id": "6f6a6fcb-84bd-6y99-7f5a-88edc26cda12",
"format": "JSON",
"sign":
"58f01e4338dcdf777f5da1c6aff0d83309d5d60c102bbe4a0c17e34b987e62dc73623a14090530fe11343a7557fab69d8737f
68200a359566b839f9b8155a0b12b7e63efa70031579603571d4f43faae",
"type": "6",
"version": "1.0",
"bizContent": {
"applyTime": "2024-01-24 08:00:00",
"userType": "2"
"userName": "xxx",
"deptType": "010101",
"deptCode": "xxxxxxxxxxx",
"contactPerson": "xxx",
"phone": "xxxxxxxxxxx",
"email": "xxxxxxxx@qq.com",
"planType": "21",
"maxHeight": 200,
"planBeg": "2024-01-25 08:00:00",
"planEnd": "2024-02-12 18:00:00",
"tx11": "某某|xxxxxxxxxxx",
"taskType": "140",
"optType": "1",
"flyType": "1",
"remarkQjbj": "无",
"remarkYjcz": "无",
"remarkTsxq": "无",
"remarkTdjn": "遥控传输,数据链路,惯性导航,卫星导航,有被监视能力",
"remarkFxhx": "无",
"remarkZhkz": "无,无",
"remarkEcld": "无",
"remarkQtxx": "无",
"involvedSpecialPlan": "00000",
"spaces": [{
"spcShape": "1",
"location":
"116.07268275, 34.10641615|116.14229161, 34.10734881|116.15602872, 34.03684195|116.01316282, 34.05731773",
"spcBottom": 1,
"spcTop": 180,
"spcCode": "测试空域-20251105181200-2154"
}],
"files": [],
"preAuditSts": "112",
"preAuditDesc": "单位1: 同意|单位2: 同意|单位3: 不同意"
}
"charset": "utf-8",
"signType": "SM3",
}
加密后输入参数:
{
"id": "6f6a6fcb-84bd-6y99-7f5a-88edc26cda12",
"format": "JSON",
"sign":
"b21975d3f89896893f8a6e82a0b6bc7db9eb98c0f6c83c1313fcac0b8fc8db670e8e1d45050cadf42c3290e60116abea3f15a
843b8815f807f647e8b24ea6f672b7e63efa70031579603571d4f43faae",
"timeStamp": "2024-01-24 10:25:38"
"version": "1.0",
"type": "6",
"bizContent": {
"applyTime": "2024-01-24 08:00:00",
"userType": "2"
"userName": "xxx",
"deptType": "010101",
"deptCode": "xxxxxxxxxxxx",
"contactPerson": "b72d83d2d9de9d15b99860e412e721c1",
"phone": "376718b9c433d853e1785d4dba7e6765",
"email": "c0a52fd3a287f1fb3307650e8fc1a944c1358ea50c9c47737a461ec534ea0629",
"planType": "21",
"maxHeight": 200,
"planBeg": "2024-01-25 08:00:00",
"planEnd": "2024-02-12 18:00:00",
"tx11": "e88f7a73bf18b77f352413aec847028ad5a34d43d0f62f39c8423527bd2e3c87",
"taskType": "140",
"optType": "1",
"flyType": "1",
"remarkQjbj": "无",
"remarkYjcz": "无",
"remarkTsxq": "无",
"remarkTdjn": "遥控传输,数据链路,惯性导航,卫星导航,有被监视能力",
"remarkFxhx": "无",
"remarkZhkz": "无,无",
"remarkEcld": "无",
"remarkQtxx": "无",
"involvedSpecialPlan": "00000",
"spaces": [{
"spcShape": "1",
"location":
"flee82e4f63de4e57e60aa33d74f1df44abb6b32b222c9bd53f16b4ac1acdbe01298e0e0d104038a4c100e0817e0d0794a231dcfe31092d7d6270612edfca64c4360be444da6977640072aa1458288efd79de52fdafe01b370bc12f1fb75256f62f1852f3c4f581433d738dab0ffde58",
"spcBottom": 1,
"spcTop": 180,
"spcCode": "测试空域-20251105181200-2154"
}],
"files": [],
"preAuditSts": "112",
"preAuditDesc": "单位1:同意|单位2:同意|单位3:不同意"
},
"charset": "utf-8",
"signType": "SM3"
}
B.15.2 场内飞行活动申请输入参数示例如下。
输入参数中的 bizContent 部分字段需要进行加密,下面是加密前和加密后的示例,正常传递需要用加密后的参数进行请求:
加密前输入参数:
{
"id":"6f6a6fcb-84bd-6y99-7f5a-88edc26cda12",
"format": "JSON",
"sign": "ef5682cb7533d142a7d1a44de6a3bab875b4c662e32b07054aba363b48e77840f82d99120dfb48309046fdbf73facd1baa2805efafbccfd9b1add0ce1b15c69f2b7e63efa70031579603571d4f43faae",
"timeStamp": "2024-01-24 10:25:38"
"version": "1.0",
"type": "6",
"bizContent":{
"applyTime": "2024-01-24 08:00:00",
"userType": "2"
"userName": "xxx",
"deptType": "010101",
"deptCode": "xxxxxxxxxxxx",
"contactPerson": "xxx",
"phone": "xxxxxxxxxxxx",
"email": "xxxxxxxx@qq.com",
"planType":"31",
"maxHeight": 200,
"planBeg": "2024-01-25 08:00:00",
"planEnd": "2024-02-12 18:00:00",
"tx11": "某某|xxxxxxxxxxxx",
"taskType": "137",
"optType": "1",
"flyType": "1",
"remarkQjbj": "无",
"remarkYjcz": "无",
"remarkTsxq": "无",
"remarkTdjn": "遥控传输,数据链路,惯性导航,卫星导航,有被监视能力",
"remarkFxhx": "无",
"remarkZhkz": "无,无",
"remarkEcld": "无",
"remarkQtxx": "无",
"involvedSpecialPlan": "00000",
"spaces": [{
"spcShape": "1",
"location": "116.07268275,34.10641615|116.14229161,34.10734881|116.15602872,34.03684195|116.01316282,34.05731773",
"spcBottom": 1,
"spcTop": 180,
"spcCode": null
}],
"files": [],
"preAuditSts": "112",
"preAuditDesc": "单位1:同意|单位2:同意|单位3:不同意"
},
"charset":"utf-8",
"signType":"SM3",
}
B.15.3 长期/场内飞行活动申请接口输出参数示例
{
"id": "6f6a6fcb-84bd-6y99-7f5a-88edc26cda12",
"format": "JSON",
"sign":
"58f01e4338dcdf777f5da1c6aff0d83309d5d60c102bbe4a0c17e34b987e62dc73623a14090530fe11343a7557fab69d8737f68200a359566b839f9b8155a0b12b7e63efa70031579603571d4f43faae",
"timeStamp": "2024-01-24 09:49:59",
"version": "1.0",
"type": "6",
"bizContent": {
"code": "200",
"msg": "操作成功",
"data": {
"planId":"732"
}
}
"charset": "utf-8",
"signType": "SM3",
}
B.16 长期飞行活动备案接口
B.16.1 长期飞行活动备案接口输入参数示例如下。
输入参数中的 bizContent 部分字段需要进行加密,下面是加密前和加密后的示例,正常传递需要用加密后的参数进行请求:
加密前输入参数:
{
"id": "6f6a6fcb-84bd-6y99-7f5a-88edc26cda12",
"format": "JSON",
"sign":
"58f01e4338dcdf777f5da1c6aff0d83309d5d60c102bbe4a0c17e34b987e62dc73623a14090530fe11343a7557fab69d8737f68200a359566b839f9b8155a0b12b7e63efa70031579603571d4f43faae",
"timeStamp": "2024-01-24 09:49:32",
"version": "1.0",
"type": "7",
"bizContent": {
"planId":"732",
"uavAndDriver": [{
"upicMsn": "xxxxxxxxxxxxxxxx"
"uas": "UASxxxxxxxx",
"uavrpName": "xxx",
"uavrpCertNo": "xxxxxxxxxxxxxxxxxxxx"
}],
"planBeg":"2024-07-11 09:44:54",
"planEnd":"2024-07-11 20:44:54",
"spcCode":"测试空域-20251105181200-2154"
},
"charset": "utf-8",
"signType": "SM3"
}
加密后输入参数:
{
"id": "6f6a6fcb-84bd-6y99-7f5a-88edc26cda12",
"format": "JSON",
"sign":
"f0ce64e4e0d0ad120eaa56ccd2a676daba53677814d46f890b19b03cc4058c3767bae03cc51ae61d5a3ec078614e5ed46bdaba4a2eafbd4912de8ca614ab88aa2b7e63efa70031579603571d4f43faae",
"timeStamp": "2024-01-24 09:49:32",
"version": "1.0",
"type": "7",
"bizContent": {
"planId":"732",
"uavAndDriver": [{
"upicMsn": "xxxxxxxxxxxxxxxx",
"uas": "UASxxxxxxxx",
"uavrpName": "xxx",
"uavrpCertNo": "6h62d5d20e031bg58v7b44vv86696c15c6f6bf40dcb8d1d6060c9f58f48y"
}],
"planBeg":"2024-07-11 09:44:54",
"planEnd":"2024-07-11 20:44:54",
"spcCode":"测试空域-20251105181200-2154"
},
"charset": "utf-8",
"signType": "SM3"
}
B.16.2 长期飞行活动备案接口输出参数示例如下。
{
"id": "6f6a6fcb-84bd-6y99-7f5a-88edc26cda12",
"format": "JSON",
"sign":
"de252ea6016309f4171c94e8b85076a757904465a38fba9ed56564daa0a7fa3b4e452a338b886f70d9bf35ba66703ba35849edcd0234799db1a75cef50d30ab74b5beb0f40a9c792ff396bee4198e50956dd95f6952ccb3ae07821e39683300",
"timeStamp": "2024-01-24 09:49:59",
"version": "1.0",
"type": "7",
"bizContent": {
"code": "200",
"msg": "操作成功",
"data": {
"planId":"732"
}
}
"charset": "utf-8",
"signType": "SM3",
}
B.17 飞行活动申请撤回接口M
B.17.1 飞行活动申请撤回接口输入参数示例如下。
{
"id": "6f6a6fcb-84bd-6y99-7f5a-88edc26cda12",
"format": "JSON",
"sign":
"01ca048f2de27d91d20bc5e66c10da40a91ed04db007fdb096e4accb46661c6ca174724a42f2b75002f3e446e006e290149835d9063704b232ead6a9428e2f2b2b7e63efa70031579603571d4f43faae",
"timeStamp": "2024-01-24 09:52:59",
"version": "1.0",
"type": "8",
"bizContent": {
"planId": "101"
},
"charset": "utf-8",
"signType": "SM3"
}
B.17.2 飞行活动申请撤回接口输出参数示例如下。
{
"id": "6f6a6fcb-84bd-6y99-7f5a-88edc26cda12",
"format": "JSON",
"sign":
"de252ea6016309f4171c94e8b85076a757904465a38fba9ed56564daa0a7fa3b4e452a338b886f70d9bf35ba66703ba35849edcd0234799db1a75cef50d30ab74b5beb0f40a9c792ff396bee4198e50956dd95f6952ccb3ae07821e39683300",
"timeStamp": "2024-01-24 09:49:59",
"version": "1.0",
"type": "8",
"bizContent": {
"code": "200",
"msg": "操作成功",
"data": {
"withdrawSts": "1"
}
}
"charset": "utf-8",
"signType": "SM3"
}
B.18 飞行活动审批状态查询接口
B.18.1 飞行活动审批状态查询接口输入参数示例如下。
{
"id": "6f6a6fcb-84bd-6y99-7f5a-88edc26cda12",
"format": "JSON",
"sign":
"01ca048f2de27d91d20bc5e66c10da40a91ed04db007fdb096e4accb46661c6ca174724a42f2b75002f3e446e006e290149835d9063704b232ead6a9428e2f2b2b7e63efa70031579603571d4f43faae",
"timeStamp": "2024-01-24 09:52:59",
"version": "1.0",
"type": "9",
"bizContent": {
"planIdList": "101"
},
"charset": "utf-8",
"signType": "SM3"
}
B.18.2 飞行活动审批状态查询接口输出参数示例如下。
{
"id": "6f6a6fcb-84bd-6y99-7f5a-88edc26cda12",
"format": "JSON",
"sign":
"a73ccc4falceed3ecf18e87549d1ce746f1690ea0534bf3db6497c25793b73d101f0bdf50d046dfcea8fab64a360a2875b80e395e78aa1532ce3b7b6bf1f9ad42b7e63efa70031579603571d4f43faae",
"timeStamp": "2024-01-24 09:49:59",
"version": "1.0",
"type": "9",
"bizContent": {
"code": "200",
"msg": "操作成功",
"data": [{
"planId": "101",
"auditSts": "1",
"auditDesc": "无",
"auditTime": "2024-01-24 08:32:10",
"qrCodeVoucher": "https://uom.caac.gov.cn/web_pub/plan Detail/b2e48g95628fba8286bdb2",
"takeoffAuditSts": "0",
"takeoffAuditDesc": null,
"takeoffAuditTime": "2024-01-24 08:45:10",
"spcCode":"测试空域-20240124081200-2154"
}]
}
"charset": "utf-8",
"signType": "SM3"
}
B.19 飞行活动申请数据获取接口
B.19.1 飞行活动申请数据获取示例如下。
输出参数中的 data 部分字段进行了加密,下面是解密前和解密后的示例。
输出参数解密前示例:
{
"msgType": "1",
"timeStamp": "2024-04-18 14:02:41",
"data": {
"applyTime": "2024-06-06 13:22:34",
"userType": "1",
"userName": "田**",
"personCardType": "0",
"personCardNo": "2e62d5d20e031b4c7b7b4436916986696c15c6f6bf40dcb8d1d6060c9f584d7d",
"deptType": null,
"deptCode": null,
"contactPerson": "b72d83d2d9de9d15b99860e412e721c1",
"phone": "376718b9c433d853e1785d4dba7e6765",
"email": "c0a52fd3a287f1fb3307650e8fc1a944c1358ea50c9c47737a461ec534ea0629",
"planType": "11",
"maxHeight": "180",
"relPlanId": null,
"planBeg": "2024-06-08 00:00:00",
"planEnd": "2024-06-08 23:59:59",
"tx11": "e88f7a73bf18b77f352413aec847028ad5a34d43d0f62f39c8423527bd2e3c87",
"taskType": "8",
"optType": "1",
"flyType": "1",
"remarkQjbj": "无",
"remarkYjcz": "无",
"remarkTsxq": "无",
"remarkTdjn": "遥控传输,惯性导航,没有被监视能力",
"remarkFxhx": "无",
"remarkZhkz": "无,无",
"remarkEcld": "无",
"remarkQtxx": "无",
"involvedSpecialPlan": "00000",
"uavs": [
{
"uavState": "0",
"uavuserType": "0",
"uavType": "2",
"uas": "UASXXXXXXXXX",
"upicMsn": "XXXXXXXXXXXXXXXXX",
"uavName": "DJI",
"uavModel": "L1P / L1Z",
"uavManufacturer": "大疆",
"uavEmptyWeight": "0.905",
"uavMaxWeight": "0.907",
"uavPersonName": "XXX",
"uavPersonCardType": "0",
"uavPersonCardNum": "fgrd5d20e031b4c7b7b443692567865127c15c6f6b575b8d1d6060c9f5875g9",
"uavPersonPhone": "c21bfd5b477d5acf4dd2aee08687f0c6de4960c5b8b386970af9",
"uavUscCode": null,
"uavUnitType": null,
"uavUnit": null,
"uavUnitContact": null,
"uavUnitPhone": null
}
],
"drivers": [
{
"state": "1",
"uavrpName": "XXX",
"licenseNo": "XXXXXXXXXXXXXXXXX",
"issueDate": "2019-04-16 00:00:00",
"updateDate": null
"invalidDate": "2099-01-01 00:00:00",
"licenseType": "1",
"classRating": "2",
"licenseRating": "0",
"bvlosRating": "2",
"instructorRating": "2",
}
],
"spaces": [
{
"spcShape": "2",
"location":
"ebf4e934960a8a65e4840bc8e733109f5a9e265f928801b7367f40272133072aeb0649195f07add7744e7cce506aa3696d1fd9ae2b468d306531b1c9754ce96de3b17c34e3b1898ae32b59593a",
"spcBottom": "1",
"spcTop": "180",
"spcCode": null
}
],
"files": null,
"planId": "1510",
"uavAndDriverRelation": [
[
"xxxxxxxxxxxxxx",
"xxxxxxxxxxxxxxxxx"
]
]
}
}
输出参数解密后示例:
{
"msgType": "1",
"timeStamp": "2024-04-18 14:02:41",
"data": {
"applyTime": "2024-06-06 13:22:34",
"userType": "1",
"userName": "田**",
"personCardType": "0",
"personCardNo": "130432********1316",
"deptType": null,
"deptCode": null,
"contactPerson": "田**",
"phone": "150****5688",
"email": "XXXXXXXXXX@qq.com",
"planType": "11",
"maxHeight": "180",
"relPlanId": null,
"planBeg": "2024-06-08 00:00:00",
"planEnd": "2024-06-08 23:59:59",
"tx11": "XXX|XXXXXXXXXX",
"taskType": "8",
"optType": "1",
"flyType": "1",
"remarkQjbj": "无",
"remarkYjcz": "无",
"remarkTsxq": "无",
"remarkTdjn": "遥控传输,惯性导航,没有被监视能力",
"remarkFxhx": "无",
"remarkZhkz": "无,无",
"remarkEcld": "无",
"remarkQtxx": "无",
"involvedSpecialPlan": "00000",
"uavs": [
{
"uavState": "0",
"uavUserType": "0",
"uavType": "2",
"uas": "UASXXXXXXXXX",
"upicMsn": "XXXXXXXXXXXXXXXXX",
"uavName": "DJI",
"uavModel": "L1P / L1Z",
"uavManufacturer": "大疆",
"uavEmptyWeight": "0.905",
"uavMaxWeight": "0.907",
"uavPersonName": "田**",
"uavPersonCardType": "0",
"uavPersonCardNum": "130432********1316",
"uavPersonPhone": "150****5688",
"uavUscCode": null,
"uavUnitType": null,
"uavUnit": null,
"uavUnitContact": null,
"uavUnitPhone": null
}
],
"drivers": [
{
"state": "1",
"uavrpName": "田**",
"licenseNo": "130432********1316",
"issueDate": "2019-04-16 00:00:00",
"updateDate": null
"invalidDate": "2099-01-01 00:00:00",
"licenseType": "1",
"classRating": "2",
"licenseRating": "0",
"bvlosRating": "2",
"instructorRating": "2"
}
],
"spaces": [
{
"spcShape": "2",
"location": "117.298058,31.776241,2651.83",
"spcBottom": "1",
"spcTop": "180",
"spcCode": null
}
],
"files": null,
"planId": "1510",
"uavAndDriverRelation": [
[
"xxxxxxxxxxxxxxxx",
"xxxxxxxxxxxxxxxx"
]
]
}
}
B.19.2 飞行活动审批、起飞确认、降落报告状态变更数据获取示例如下。
{
"msgType": "4",
"timeStamp": "2024-04-18 14:05:59",
"data": {
"planId": "101",
"auditSts": "1",
"auditDesc": "无",
"auditTime": "2024-01-24 08:32:10",
"qrCodeVoucher": "https://uom.caac.gov.cn/web_pub/planDetail/b2e48g9562812458286bdb2",
"spcCode": "测试空域-20240124081200-2154",
"takeoffs": [
{
"takeoffAuditSts": "1",
"takeoffAuditDesc": "测试-起飞确认-通过",
"takeoffAuditTime": "2024-06-07 18:40:04",
"takeoffTime": "2024-06-08 19:00:00",
"takeoffRemark": "准备就绪",
"landSts": "1",
"landTime": "2024-06-08 19:40:04",
}
]
}
}
B.20 一般/紧急/长期飞行活动起飞确认接口
B.20.1 一般/紧急/长期飞行活动起飞确认接口输入参数示例如下。
{
"id":"6f6a6fcb-84bd-6y99-7f5a-88edc26cda12",
"format":"JSON",
"sign":
"cf53c333c9e46c74b6f2cf8350b625a9b8df4be1a95406353b59542038e70d1fd1db8fc19d543da0c9d0f70461d5de43b3a530fddcd07d34784096b5868785ad2b7e63efa70031579603571d4f43faae",
"timeStamp":"2024-01-12 09:49:08",
"version": "1.0",
"type":"11",
"bizContent":{
"planId":"649",
"takeoffTime":"2024-01-13 00:00:00",
"takeoffRemark":"起飞前校验完成",
{
"id": "6f6a6fcb-84bd-6y99-7f5a-88edc26cda12",
"format": "JSON",
"sign":
"7097156408a7b82aa373c1b6b772d180b7bd4a8e7025e8b436302678a0e0392560784cabef78697ad40029ea0cfb48a1937f6fdd6ebb263ed6e508feb1a3eb642b7e63efa70031579603571d4f43faae",
"timeStamp": "2024-01-24 09:49:59",
"version": "1.0",
"type": "11",
"bizContent": {
"code": "200",
"msg": "操作成功",
"data": {
"planId":"649"
}
}
"charset": "utf-8",
"signType": "SM3"
}
}
B.21 场内飞行活动起飞确认接口
B.21.1 场内飞行活动起飞确认接口输入参数示例如下。
输入参数中的 bizContent 部分字段需要进行加密,下面是加密前和加密后的示例,正常传递需要用加密后的参数进行请求:
加密前输入参数:
{
"id":"6f6a6fcb-84bd-6y99-7f5a-88edc26cda12",
"format":"json",
"sign":"7262633b3124f32013d9ec3d5aee1a008389a9960ce067379b7b7d0e82abee4818c5e91e1fe5987bcee0cca5c7d554f404f49e10bb9a5f38a000cd65d39ca64d2b7e63efa70031579603571d4f43faae",
"timeStamp":"2024-01-24 09:49:59",
"version": "1.0",
"type":"12",
"bizContent":{
"planId": "661",
"uavAndDriver":[{
"upicMsn":"xxxxxxxxxxxxxx",
"uas":"UASxxxxxxxx",
"uavrpNam":"xxxxxx",
"uavrpCertNo":"xxxxxxxxxxxxxxxxxxxxxx"
}],
"planBeg":"2024-01-14 07:00:00",
"planEnd":"2024-01-14 18:00:00",
"preTakeoffAuditSts":"0",
"preTakeoffAuditDesc":"无",
"takeoffRemark":"确认起飞",
"takeoffTime":"2024-01-14 08:00:00",
},
"preTakeoffAuditSts":"0",
"preTakeoffAuditDesc":"无",
},
"charset":"utf-8",
"signType":" SM3"
}
B.20.2 一般/紧急/长期飞行活动起飞确认接口输出参数示例如下。
"charset":"utf-8",
"signType":" SM3"
}
加密后输入参数:
{
"id":"6f6a6fcb-84bd-6y99-7f5a-88edc26cda12",
"format":"json",
"sign":"7262633b3124f32013d9ec3d5aee1a008389a9960ce067379b7b7d0e82abee4818c5e91e1fe5987bcee0cca5c7d554f404f49e10bb9a5f38a000cd65d39ca64d2b7e63efa70031579603571d4f43faae",
"timeStamp":"2024-01-24 09:49:59",
"version": "1.0",
"type":"12",
"bizContent":{
"planId": "661",
"uavAndDriver":[{
"upicMsn":"xxxxxxxxxxxxxxxx",
"uas":"UASxxxxxxxx",
"uavrpNam":"xxxxxx",
"uavrpCertNo":"6h62d5d20e031bg58v7b44vv86696c15c6f6bf40dcb8d1d6060c9f58f48y"
}],
"planBeg":"2024-01-24 11:00:00",
"planEnd":"2024-01-24 18:00:00",
"preTakeoffAuditSts":"0",
"preTakeoffAuditDesc":"无",
"takeoffRemark":"确认起飞",
"takeoffTime":"2024-01-24 12:00:00",
},
"charset":"utf-8",
"signType":" SM3"
}
B.21.2 场内飞行活动起飞确认接口输出参数示例如下。
{
"id": "6f6a6fcb-84bd-6y99-7f5a-88edc26cda12",
"format": "JSON",
"sign":
"87fc9ba9dbc1e983f5869c2190dfd765ee5db3b912da111379ae110906770b202324554146457556da9e9d11281796a2fc2a9d944af81c5c7de688b0952a9d2d2b7e63efa70031579603571d4f43faae",
"timeStamp": "2024-01-24 09:49:59",
"version": "1.0",
"type": "12",
"bizContent": {
"code": "200",
"msg": "操作成功",
"data": {
"planId": "661"
}
}
"charset": "utf-8",
"signType": "SM3",
}
B.22 飞行活动降落报告接口
B.22.1 飞行活动降落报告接口输入参数示例如下。
"id": "6f6a6fcb-84bd-6y99-7f5a-88edc26cda12",
"format": "JSON",
"sign":
"62d8a75980cdddd4058d4f0564806e9c1178afd9d907f0aa47ae1fff9c4288920040a39e80923d2d90ccd2f38238b902c549c0bebf89ae9fc67db9c88c4ef22f2b7e63efa70031579603571d4f43faae",
"timeStamp": "2024-01-24 09:12:59",
"version": "1.0",
"type":"13",
"bizContent": {
"planId": "101",
"landingTime": "2024-01-24 09:12:00"
},
"charset": "utf-8",
"signType": " SM3"
}
B.22.2 飞行活动降落报告接口输出参数示例如下。
{
"id": "6f6a6fcb-84bd-6y99-7f5a-88edc26cda12",
"format": "JSON",
"sign": "39b8daea8e5b4985132abe9c8230957837ff5086f90c0c6de7ee836b2aaf37ad12d1236a338143ce2b07995f31b35f36eeb3c64176e3a931c25fc67313a92ab82b7e63efa70031579603571d4f43faae",
"timeStamp": "2024-01-24 09:49:59",
"version": "1.0",
"type": "13",
"bizContent": {
"code": "200",
"msg": "操作成功",
"data": {
"planId": "101"
}
},
"charset": "utf-8",
"signType": "SM3"
}
B.23 网络式运行识别信息获取接口
推送参数解密前示例:
{
"orderId":"ZTU25VA2204FSUHXT-20240204-1707032956",
"upicMsn":"ZTU25VA2204FSUHXT",
"uscCode":"91310106575864243X",
"uas":"UAS12345678",
"timeStamp":"20260325161800",
"uasModel":"ZT-25",
"coordinate":"1",
"uavLonLat":"1040852616|308172816",
"height":"1200",
"pressureHeight":"1200",
"vs":"10",
"gs":"25",
"course":"2600",
"uavOptCategory":"0",
"uavCategory":"2",
"uavControlStationSiteType":"0",
"uavControlStationSite":"1040852616|308172816",
"uavControlStationSiteHeight":"1200",
"geodeticHeight":"1200",
"horizontalAccuracy":"0",
"verticalAccuracy":"0",
"speedAccuracy":"0",
"timeStampAccuracy":"0",
"operatingStatus":"1",
"tHeight":"1200",
"uavAuthInfo":{
"uavState":"0",
"uavType":"1",
"uavCategory":"2",
"uas":"UAS25184756",
"uavName":"xx",
"uavModel":"xx",
"uavManufacturer":"xx",
"uavEmptyWeight":"1.0",
"uavMaxWeight":"1.5",
"uavuserType":"0",
"uavPerson":{
"uavPersonName":"xx",
"uavPersonCardType":"0",
"uavPersonCardNum":"2e62d5d20e031b4c7b7b4436916986696c15c6f6bf40dcb8d1d6060c9f584d7d",
"uavPersonPhone":"376718b9c433d853e1785d4dba7e6765"
},
"uavUnit":null
}
}
推送参数解密后示例:
{
"orderId":"ZTU25VA2204FSUHXT-20240204-1707032956",
"upicMsn":"ZTU25VA2204FSUHXT",
"uscCode":"91310106575864243X",
"uas":"UAS12345678",
"timeStamp":"20260325161800",
"uasModel":"ZT-25",
"coordinate":"1",
"uavLonLat":"1040852616|308172816",
"height":"1200",
"pressureHeight":"1200",
"vs":"10",
"gs":"25",
"course":"2600",
"uavOptCategory":"0",
"uavCategory":"2",
"uavControlStationSiteType":"0",
"uavControlStationSite":"1040852616|308172816",
"uavControlStationSiteHeight":"1200",
"geodeticHeight":"1200",
"horizontalAccuracy":"0",
"verticalAccuracy":"0",
"speedAccuracy":"0",
"timeStampAccuracy":"0",
"operatingStatus":"1",
"tHeight":"1200",
"uavAuthInfo":{
"uavState":"0",
"uavType":"1",
"uavCategory":"2",
"uas":"UAS25184756",
"uavName":"xx",
"uavModel":"xx",
"uavManufacturer":"xx",
"uavEmptyWeight":"1.0",
"uavMaxWeight":"1.5",
"uavuserType":"0",
"uavPerson":{
"uavPersonName":"xx",
"uavPersonCardType":"0",
"uavPersonCardNum":"xxxxxxxxxxxxxxxxxxxx",
"uavPersonPhone":"xxxxxxxxxx",
},
"uavUnit":null
}
}
B.24 广播式运行识别信息报送接口
{
"id": "6f6a6fcb-84bd-6y99-7f5a-88edc26cda12",
"format": "JSON",
"sign":
"62d8a75980cdddd4058d4f0564806e9c1178afd9d907f0aa47ae1fff9c4288920040a39e80923d2d90ccd2f38238b902c549c0bebf89ae9fc67db9c88c4ef22f2b7e63efa70031579603571d4f43faae",
"timeStamp": "2024-01-24 09:12:59",
"version": "1.0",
"type":"15",
"bizContent": {
"ridData":[{
"orderId":"ZTU25VA2204FSUHXT-20240204-1707032956",
"upicMsn":"ZTU25VA2204FSUHXT",
"uscCode":"91310106575864243X",
"uas":"UAS12345678",
"timeStamp":"20260325161800",
"uasModel":"ZT-25",
"coordinate":"1",
"uavLonLat":"1040852616|308172816",
"height":"1200",
"pressureHeight":"1200",
"vs":"10",
"gs":"25",
"course":"2600",
"uavOptCategory":"0",
"uavCategory":"2",
"uavControlStationSiteType":"0",
"uavControlStationSite":"1040852616|308172816",
"uavControlStationSiteHeight":"1200",
"geodeticHeight":"1200",
"horizontalAccuracy":"0",
"verticalAccuracy":"0",
"speedAccuracy":"0",
"timeStampAccuracy":"0",
"operatingStatus":"1",
"tHeight":1200
}],
"sendTime":"2025-11-25 19:11:28"
},
"charset": "utf-8",
"signType": " SM3"
}
B.24.2 广播式运行识别信息报送接口输出参数示例如下。
{
"id": "6f6a6fcb-84bd-6y99-7f5a-88edc26cda12",
"format": "JSON",
"sign":
"bddd4ea3b3bb6d38de3b567d5450e856f809e551771bca3b90dd746e0638f1b3b4af79ce7865690e3d4c3b3abdb4b1572015ada15b778b9306badd204dbb99242b7e63efa70031579603571d4f43faae",
"timeStamp": "2025-11-25 19:12:00",
"version": "1.0",
"type": "15",
"bizContent": {
"code": "200",
"msg": "操作成功",
"data": {
"reportSts": "1"
}
},
"charset": "utf-8",
"signType": "SM3"
}
B.25 心跳探测数据接口
B.25.1 心跳探测接口输入参数示例如下。
"id": "6f6a6fcb-84bd-6y99-7f5a-88edc26cda12",
"randomCode":"147258",
"timeStamp": "2024-04-23 15:54:11"
B.25.2 心跳探测数据接口输出参数示例如下。
{
"code": "200",
"msg": "操作成功"
}

评论