MH-T 3036-2024 民航綜合辦公平臺(tái)接口規(guī)范

35.240.60CCS

L

67MH中華人民共和國(guó)民用航空行業(yè)標(biāo)準(zhǔn)MH/T

3036—2024民航綜合辦公平臺(tái)接口規(guī)范The

interface

for

civil

office

中國(guó)民用航空局 發(fā)

布MH/T

3036—2024 前言

.................................................................................

II1

...............................................................................

12 規(guī)范性引用文件

.....................................................................

13 術(shù)語(yǔ)和定義

.........................................................................

14

...............................................................................

15 數(shù)據(jù)要素

...........................................................................

1人員信息數(shù)據(jù)要素

...............................................................

1組織機(jī)構(gòu)數(shù)據(jù)要素

...............................................................

2消息待辦數(shù)據(jù)要素

...............................................................

2電子公文數(shù)據(jù)要素

...............................................................

3行政審批事項(xiàng)數(shù)據(jù)要素

...........................................................

36 基礎(chǔ)數(shù)據(jù)對(duì)接要求

...................................................................

4接入流程

.......................................................................

4接口方式

.......................................................................

5接口服務(wù)說(shuō)明

...................................................................

57 業(yè)務(wù)數(shù)據(jù)對(duì)接要求

...................................................................

7消息待辦對(duì)接要求

...............................................................

7電子公文交換對(duì)接要求

...........................................................

8行政審批事項(xiàng)交換對(duì)接要求

......................................................

11附錄

A（規(guī)范性） JSON

網(wǎng)頁(yè)令牌（JWT）生成方法

........................................

14附錄

B（資料性） 公文包元數(shù)據(jù)

................................................

15附錄

C（資料性） 回執(zhí)信息元數(shù)據(jù)

XML

示例..............................................

17附錄

D（資料性） 發(fā)送數(shù)據(jù)文件示例....................................................

18附錄

E（資料性） 接收數(shù)據(jù)文件示例....................................................

19MH/T

3036—2024本文件按照GB/T

1.1—2020《標(biāo)準(zhǔn)化工作導(dǎo)則

第1部分：標(biāo)準(zhǔn)化文件的結(jié)構(gòu)和起草規(guī)則》的規(guī)定起草。請(qǐng)注意本文件的某些內(nèi)容可能涉及專利。本文件的發(fā)布機(jī)構(gòu)不承擔(dān)識(shí)別專利的責(zé)任。本文件由中國(guó)民用航空局綜合司提出。本文件由中國(guó)民航科學(xué)技術(shù)研究院歸口。本文件起草單位：中國(guó)民用航空局信息中心。本文件主要起草人：李欣瑩、馬秋俠、丁盛舟、龐湃、劉陽(yáng)。IIMH/T

3036—20241 范圍非涉密系統(tǒng)接口的接入規(guī)范及要求。公平臺(tái)通過(guò)非涉密網(wǎng)絡(luò)對(duì)接的系統(tǒng)（以下簡(jiǎn)稱“外部系統(tǒng)”）。2規(guī)范性引用文件文件。GB/T

11457—2006 信息技術(shù)

軟件工程術(shù)語(yǔ)GB

18030 信息技術(shù)

中文編碼字符集3 術(shù)語(yǔ)和定義GB/T

11457—2006界定的以及下列術(shù)語(yǔ)和定義適用于本文件。電子公文 electronic

document以數(shù)字形式存儲(chǔ)于磁盤(pán)、光盤(pán)等媒體，依賴計(jì)算機(jī)系統(tǒng)閱讀、處理并可在通信網(wǎng)絡(luò)上傳輸?shù)墓?。[來(lái)源：GB/T

—，基礎(chǔ)數(shù)據(jù)foundational

涉及民航綜合辦公平臺(tái)組織機(jī)構(gòu)信息和人員信息的數(shù)據(jù)。業(yè)務(wù)數(shù)據(jù)

民航綜合辦公平臺(tái)生成的公文，以及涉及事項(xiàng)提醒和行政審批事項(xiàng)的數(shù)據(jù)。4通則民航綜合辦公平臺(tái)對(duì)接分為基礎(chǔ)數(shù)據(jù)對(duì)接和業(yè)務(wù)數(shù)據(jù)對(duì)接兩類。按照人員信息數(shù)據(jù)要素和組織機(jī)構(gòu)數(shù)據(jù)要素的約束要求進(jìn)行參數(shù)定義，并按照本文件規(guī)定的接入流程和接口方式實(shí)現(xiàn)基礎(chǔ)數(shù)據(jù)的對(duì)接。求進(jìn)行參數(shù)定義，并按照本文件規(guī)定的接入流程要求實(shí)現(xiàn)各業(yè)務(wù)數(shù)據(jù)的對(duì)接。基礎(chǔ)數(shù)據(jù)和業(yè)務(wù)數(shù)據(jù)的字符應(yīng)符合GB

180305 數(shù)據(jù)要素人員信息數(shù)據(jù)要素規(guī)范中文名稱和含義。人員信息數(shù)據(jù)要素應(yīng)符合表

1

的規(guī)定。userId

IduserNameuserCode姓的命名規(guī)則，例如

sex

表示男，

officePhone辦公號(hào)碼，支持填寫(xiě)區(qū)號(hào)和手機(jī)號(hào)emailcreateTime用戶賬號(hào)的創(chuàng)建時(shí)間，格式：2020-01-01

zwId用戶職務(wù)（黨組書(shū)記、副局長(zhǎng)、黨組成員等，且支持填入兼職、非領(lǐng)導(dǎo)職務(wù)等描述）isValid用戶賬號(hào)的狀態(tài)，

10deptId

Id11updateTime該用戶在系統(tǒng)中最后一次修改時(shí)間，格式：2020-01-01

09:30:3012sortdeptId

IddeptNameparentIdsortisValid部門(mén)的開(kāi)啟狀態(tài)，

updateTime該機(jī)構(gòu)在系統(tǒng)中最后修改時(shí)間，格式：2020-01-0109:30:30deptLevel

表示司局

createTime部門(mén)在系統(tǒng)中的創(chuàng)建時(shí)間，格式：2020-01-0109:30:30appNameagreementTypehttp

MH/T

3036—2024表1表1 人員信息數(shù)據(jù)要素的規(guī)范中文名稱和含義。組織機(jī)構(gòu)數(shù)據(jù)要素應(yīng)符合表

2

表2表2 組織機(jī)構(gòu)數(shù)據(jù)要素范中文名稱和含義。消息待辦數(shù)據(jù)要素應(yīng)符合表

3

的規(guī)定。表3表3 消息待辦數(shù)據(jù)要素senderIdsenderNamesenderDesreceiverIdreceiverNamereceiverDessecrecyLevelemergencyLevelsendCode10receiveCode11title12content

base64

13fwId14otherOfc15attachName16attachExtName17attachSize

Byte

100M18attachContent

base64

19docId20receiptContent21receiptMemo22receiptTime23otherRet

對(duì)應(yīng)參數(shù)ipAddressIP

ip

appPorttypeitemNameitemPath

ipitemNumPath待辦數(shù)字接口路徑

ip

itemPicture10userGroupMH/T

3036—2024表

表

3消息待辦數(shù)據(jù)要素（續(xù)）字段的規(guī)范中文名稱和含義。電子公文數(shù)據(jù)要素應(yīng)符合表

4

的規(guī)定。表4表4電子公文數(shù)據(jù)要素行政審批事項(xiàng)數(shù)據(jù)要素描述實(shí)現(xiàn)行政審批事項(xiàng)交換時(shí)需提供的主要信息，分別規(guī)定了行政審批辦應(yīng)符合表

5

的規(guī)定，行政審批辦理結(jié)果數(shù)據(jù)要素應(yīng)符合表

6

的規(guī)定。projectNOprojectTypedealNamedealStartTime

2020-01-01

09:30:30dealEndTime

2020-01-01

09:30:30proResult(0

表示不予批準(zhǔn)，

表示轉(zhuǎn)

proSeason不予批準(zhǔn)或終止辦件理由（不予批準(zhǔn)或終止辦件時(shí)需contentId

ID

ID

IDapplyAttachId

ID

ID

ID10remark11isSpecial(0

12specialType

表示除延13specialName14specialReason1516specialDealPerson17

2020-01-01

09:30:3018

2020-01-01

09:30:30projectNOtitleapplicantnumbercontentId

ID

IDapplyAttachId

ID

IDremarkattatchNameattatchFile10attatchName11applyAttachId

ID

ID

12attatchFileMH/T

3036—2024表5行政審批辦件過(guò)程數(shù)據(jù)要素表表5行政審批辦件過(guò)程數(shù)據(jù)要素表6 行政審批辦理結(jié)果數(shù)據(jù)要素接入流程byteupdateTimeString32

yyyy-MM-dd

HH-mm-ssorgIdString32userIdString32userNameString16userCodeString16表7表7人員信息同步服務(wù)接口參數(shù)MH/T

3036—2024圖1 基礎(chǔ)數(shù)據(jù)對(duì)接接入流程應(yīng)用注冊(cè)和接口調(diào)用鑒權(quán)業(yè)務(wù)流程，如圖1所示。a)

供應(yīng)用注冊(cè)，并接收數(shù)據(jù)加解密密鑰，用于接口調(diào)用。b)

ID

JSON

網(wǎng)token

相關(guān)內(nèi)容應(yīng)符合附錄

A

的要求。c)

請(qǐng)求服務(wù)。外部系統(tǒng)將向民航電子政務(wù)綜合辦公平臺(tái)的應(yīng)用支撐平臺(tái)請(qǐng)求服務(wù)，應(yīng)發(fā)送帶有token

的請(qǐng)求頭。d)

服務(wù)鑒權(quán)。應(yīng)用支撐平臺(tái)應(yīng)對(duì)請(qǐng)求中的

token

token

有效并有接口調(diào)用權(quán)限，則進(jìn)行后續(xù)服務(wù)調(diào)用。接口方式民航電子政務(wù)綜合辦公平臺(tái)對(duì)外發(fā)布、請(qǐng)求的服務(wù)統(tǒng)一采用架構(gòu)的服務(wù)。接口類型：POST。接口服務(wù)說(shuō)明6.3.1 人員信息同步服務(wù)體接口調(diào)用方式如下。a)

調(diào)用地址：http://ip:port/cssbase/rest/sorg/getUserByUpdateTime。b)

人員信息同步服務(wù)接口參數(shù)應(yīng)符合表

7

byteupdateTimeString32

yyyy-MM-dd

HH-mm-ssorgIdString32deptIdString32deptNameString[]64組織機(jī)構(gòu)名稱，包括當(dāng)前部門(mén)及子部門(mén)信息parentIdString32sortString部門(mén)排序，數(shù)字序號(hào)由小到大排列isValidString

表示部門(mén)是注銷狀態(tài)，

updateTimeString322020-01-01

09:30:30deptLevelString

表示司局級(jí)，

表示監(jiān)管局級(jí)，

createTimeString322020-01-01

09:30:30URLEncoderJSONbytesexString用戶性別，

officePhoneString[]16emailString[]32createTimeString32zwIdString32isValidString

deptIdString32updateTimeString322020-01-0109:30:30sortString人員排序，數(shù)字序號(hào)由小到大排列URLEncoderJSONMH/T

3036—2024表

7表

7 人員信息同步服務(wù)接口參數(shù)（續(xù)）"Result"

"status":"200",sValid":"1"

","userId":"af5b873ddc084297876238268dfb33a8

"createTime":"2021-06-06

15:30:20","deptId":"5724eed0e2ba42a9a736bc0a61016bab","updateTime":"2020-01-01

6.3.2 組織機(jī)構(gòu)信息同步服務(wù)同步一次。具體接口調(diào)用方式如下。a)

調(diào)用地址：http://ip:port/cssbase/rest/sorg/getOrgByUpdateTime。b)

組織機(jī)構(gòu)信息同步服務(wù)接口參數(shù)應(yīng)符合表

8

表8表8組織機(jī)構(gòu)信息同步服務(wù)接口參數(shù)appNamehttp

agreementTypeIP

ip

ipAddressappPortMH/T

3036—2024"Result":"status":"200","body":[{"deptName":"","deptLevel":"3"

"deptId":"ccb47b50f5fb4a4fb9337b85f738ce82","updateTime":"2022-11-14

10:58:20","sort":"4","parentId":"f6973bc4fce34bca8869480f45445832",

"createTime":"2022-11-14

7業(yè)務(wù)數(shù)據(jù)對(duì)接要求消息待辦對(duì)接要求7.1.1接入流程圖2消息待辦對(duì)接接入流程外部系統(tǒng)接入民航電子政務(wù)綜合辦公平臺(tái)門(mén)戶，配置待辦消息推送的業(yè)務(wù)流程，如圖2所示。a)

用注冊(cè)基本信息包括系統(tǒng)名稱、接口協(xié)議、

地址等參數(shù)。b)

待辦信息配置。外部系統(tǒng)應(yīng)提供待辦信息用于在民航電子政務(wù)綜合辦公平臺(tái)進(jìn)行消息提醒配置，待辦基本信息包括待辦事項(xiàng)類型、名稱、訪問(wèn)路徑等。7.1.2應(yīng)用注冊(cè)配置參數(shù)

9

定。表9 應(yīng)用注冊(cè)配置參數(shù)表9 應(yīng)用注冊(cè)配置參數(shù)

10

的規(guī)定。typeitemName

ipitemPath待辦數(shù)字接口路徑

ip

itemNumPathitemPictureuserGroupMH/T

3036—2024表10表10 待辦接口信息配置參數(shù)7.2.1電子公文發(fā)送對(duì)接要求接入流程圖3電子公文發(fā)送對(duì)接接入流程外部系統(tǒng)將電子公文發(fā)送給民航電子政務(wù)綜合辦公平臺(tái)的業(yè)務(wù)流程，如圖

3

所示。appNameIP

ip

ipAddressappPortinterfaceNameorgIdxmlContentStringresultString

msgString

XMLJSONMH/T

3036—2024a)

應(yīng)用注冊(cè)。外部系統(tǒng)應(yīng)提供注冊(cè)信息，用于在民航電子政務(wù)綜合辦公平臺(tái)進(jìn)行注冊(cè),用系統(tǒng)

ID

及數(shù)據(jù)加解密密鑰，用于接口調(diào)用。b)

ID

JSON

網(wǎng)頁(yè)令JWTtoken

相關(guān)內(nèi)容應(yīng)符合附錄

A

的要求。c)

token

的請(qǐng)求頭。d)

服務(wù)鑒權(quán)。服務(wù)網(wǎng)關(guān)應(yīng)對(duì)請(qǐng)求中的

token

token

應(yīng)有效并有接口調(diào)用權(quán)限，則進(jìn)行后續(xù)服務(wù)調(diào)用。e)

發(fā)送公文數(shù)據(jù)包。外部系統(tǒng)應(yīng)將交換的公文數(shù)據(jù)包使用數(shù)據(jù)加解密密鑰經(jīng)過(guò)國(guó)密算法加密后發(fā)送到民航電子政務(wù)綜合辦公平臺(tái)公文交換系統(tǒng)，公文交換系統(tǒng)應(yīng)返回成功或者失敗的公文發(fā)送狀態(tài)碼給外部系統(tǒng)。f)

公文交換系統(tǒng)應(yīng)將公文接收狀態(tài)碼返回給外部系統(tǒng)，外部系統(tǒng)應(yīng)返回成功或者失敗的狀態(tài)碼給公文交換系統(tǒng)。應(yīng)用注冊(cè)配置參數(shù)應(yīng)用注冊(cè)配置參數(shù)應(yīng)符合表11表11應(yīng)用注冊(cè)配置參數(shù)表11應(yīng)用注冊(cè)配置參數(shù)接口類型：電子公文交換發(fā)送接口統(tǒng)一采用基于協(xié)議的Web

Service接口。 發(fā)送公文數(shù)據(jù)包接口服務(wù)說(shuō)明方式如下。a)

調(diào)用地址：。b)

調(diào)用頻次：應(yīng)不超過(guò)

5

次每秒。c)

發(fā)送公文數(shù)據(jù)包接口參數(shù)應(yīng)符合表

表12 表12 發(fā)送公文數(shù)據(jù)包接口參數(shù)"message":"result":"success","msg":"xmlContentString

resultString

msgString

XMLMH/T

3036—2024d)

容、附件，公文包以

XML

格式進(jìn)行傳輸，示例參見(jiàn)附錄

B。接收狀態(tài)參數(shù)民航電子政務(wù)綜合辦公平臺(tái)業(yè)務(wù)人員將公文接收或退回后，民航電子政務(wù)綜合辦公平臺(tái)公文交換態(tài)業(yè)務(wù)參數(shù)應(yīng)符合表13的規(guī)定。表13 接收狀態(tài)業(yè)務(wù)參數(shù)表13 接收狀態(tài)業(yè)務(wù)參數(shù) 接入流程圖4 電子公文接收對(duì)接接入流程10xmlContentString

resultString

msgStringXMLMH/T

3036—2024外部系統(tǒng)接收來(lái)自于民航電子政務(wù)綜合辦公平臺(tái)公文的業(yè)務(wù)流程，如圖

4

所示。a)

用系統(tǒng)

ID

及數(shù)據(jù)加解密密鑰，用于公文數(shù)據(jù)包加解密使用。b)

接收公文數(shù)據(jù)包。民航電子政務(wù)綜合辦公平臺(tái)公文交換系統(tǒng)應(yīng)通過(guò)注冊(cè)接口將使用數(shù)據(jù)加解密密鑰經(jīng)過(guò)國(guó)密算法加密后的公文數(shù)據(jù)包發(fā)送給外部系統(tǒng)，外部系統(tǒng)應(yīng)返回成功或者失敗的狀態(tài)碼給公文交換系統(tǒng)。c)

密。d)

政務(wù)綜合辦公平臺(tái)公文交換系統(tǒng)，公文交換系統(tǒng)應(yīng)返回成功或者失敗的狀態(tài)碼給外部系統(tǒng)。應(yīng)用注冊(cè)配置參數(shù)外部系統(tǒng)接入前，應(yīng)在民航電子政務(wù)公文交換系統(tǒng)進(jìn)行應(yīng)用注冊(cè)。注冊(cè)信息應(yīng)符合表

的規(guī)定。 接收公文數(shù)據(jù)包接收參數(shù)應(yīng)通過(guò)注冊(cè)接口將公文數(shù)據(jù)包發(fā)送給外部系統(tǒng)，外部系統(tǒng)應(yīng)返回成功或者失敗的狀態(tài)碼給公文交換系統(tǒng)。加密前的公文數(shù)據(jù)包接收參數(shù)應(yīng)符合表

12

的規(guī)定，數(shù)據(jù)包

XML

中標(biāo)簽<>的值為

數(shù)據(jù)包為公文數(shù)據(jù)包。和附件，公文包以

格式進(jìn)行傳輸，示例參見(jiàn)附錄

B。 返回公文狀態(tài)接口服務(wù)說(shuō)明外部系統(tǒng)將公文接收或退回后，外部系統(tǒng)將公文接收狀態(tài)碼返回給民航電子政務(wù)綜合辦公平臺(tái)公文交換系統(tǒng)，公文交換系統(tǒng)返回成功或者失敗的狀態(tài)碼給外部系統(tǒng)，具體接口調(diào)用方式如下。a)

調(diào)用地址：https://ip:port/dataex/services/dataexsys/sendBaseXMLEsbWebService。b)

返回公文狀態(tài)接口參數(shù)應(yīng)符合表

14

的規(guī)定。表14返回公文狀態(tài)接口參數(shù)表14返回公文狀態(tài)接口參數(shù)包以

格式進(jìn)行傳輸，示例參見(jiàn)附錄

C。行政審批事項(xiàng)交換對(duì)接要求7.3.1 行政審批事項(xiàng)發(fā)送對(duì)接要求 接入流程11MH/T

3036—2024圖5 行政審批事項(xiàng)發(fā)送對(duì)接接入流程外部系統(tǒng)將行政審批事項(xiàng)辦件過(guò)程數(shù)據(jù)導(dǎo)入民航電子政務(wù)綜合辦公平臺(tái)的業(yè)務(wù)流程，如圖5所示。a)

確定傳輸密碼。外部系統(tǒng)與民航電子政務(wù)綜合辦公平臺(tái)約定傳輸壓縮包密碼。b)

.zip

格式，之后發(fā)送至民航電子政務(wù)綜合辦公平臺(tái)固定文件路徑下。 辦件過(guò)程數(shù)據(jù)包參數(shù)

XML

文件示例參照附錄

D，

5

的規(guī)定。7.3.2 行政審批事項(xiàng)接收對(duì)接要求 接入流程圖6 行政審批事項(xiàng)接收對(duì)接接入流程外部系統(tǒng)接收民航電子政務(wù)綜合辦公平臺(tái)行政審批事項(xiàng)辦理結(jié)果的業(yè)務(wù)流程，如圖6所示。a)

讀取數(shù)據(jù)包。外部系統(tǒng)定時(shí)從民航電子政務(wù)綜合辦公平臺(tái)固定文件路徑下讀取辦理結(jié)果數(shù)據(jù)包，數(shù)據(jù)包格式為.zip。12MH/T

3036—2024b)

數(shù)據(jù)包解密。外部系統(tǒng)將接收到的數(shù)據(jù)包進(jìn)行解密，解壓密碼提前進(jìn)行約定。 辦理結(jié)果數(shù)據(jù)包參數(shù)民航電子政務(wù)綜合辦公平臺(tái)以標(biāo)準(zhǔn)的辦理結(jié)果數(shù)據(jù)包進(jìn)行傳輸交換。辦理結(jié)果數(shù)據(jù)包的內(nèi)容包括

文件示例參照附錄

E，XML

文件的數(shù)據(jù)要素應(yīng)符合表

6

的規(guī)定。13MH/T

3036—2024附 錄 A（規(guī)范性）JSON

網(wǎng)頁(yè)令牌（JWT）生成方法A.1 JWT

為一組字串，通過(guò)“.”切分成以下三個(gè)

編碼部分：a)

信頭：JWT

的元數(shù)據(jù)，定義了生成簽名的算法以及令牌的類型；b)

載荷：用來(lái)存放實(shí)際需要傳遞的數(shù)據(jù)；c)

簽名：簽名通過(guò)信頭、載荷和密鑰(secret)使用信頭中指定的國(guó)密簽名算法（SM3）生成。A.2 JWT

格式為：xxxxx.yyyyy.zzzzz。其中，xxxxx

為信頭，yyyyy

為載荷，

為簽名。信頭+載荷+形成的字符串密鑰簽名，經(jīng)

編碼生成字符串，最后形成

。JSON

{"alg":"SM3","typ":"JWT"}{"sid":"1234567890""iat":"12684224932""rand"{"signature":"9b0d94c683255fe6760dc4355e43a6964ac78d031deba15be694dc1e70836f43"}14MH/T

3036—2024附 錄 B（資料性）公文包元數(shù)據(jù)

接收和發(fā)送的解密后的電子公文包元數(shù)據(jù)示例如下。<?xml

encoding="GB18030"?>>13b947aab1d74f688efcf9a19ae63c15</</>6e60386547a64c03b9b22ccacfd06241</</

xxxxxxxx

</2022

</.doc</1024</</</</</15MH/T

3036—2024/></</16MH/T

3036—2024附 錄 C（資料性）回執(zhí)信息元數(shù)據(jù)

XML

示例接收和發(fā)送的回執(zhí)信息元數(shù)據(jù)示例如下。<?xml

encoding="GB18030"?>>13b947aab1d74f688efcf9a19ae63c15</>6e60386547a64c03b9b22ccacfd06241</

</

yyyy-MM-dd

HH:m