《MHT3036-2024民航綜合辦公平臺接口規(guī)范》

ICS35.240.60

CCSL67

MH

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

MH/T3036—2024

民航綜合辦公平臺接口規(guī)范

Theinterfacespecificationforcivilaviationintegratedofficeplatform

2024-01-03發(fā)布2024-02-01實施

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

MH/T3036—2024

前言

本文件按照GB/T1.1—2020《標(biāo)準(zhǔn)化工作導(dǎo)則第1部分：標(biāo)準(zhǔn)化文件的結(jié)構(gòu)和起草規(guī)則》的規(guī)定

起草。

請注意本文件的某些內(nèi)容可能涉及專利。本文件的發(fā)布機構(gòu)不承擔(dān)識別專利的責(zé)任。

本文件由中國民用航空局綜合司提出。

本文件由中國民航科學(xué)技術(shù)研究院歸口。

本文件起草單位：中國民用航空局信息中心。

本文件主要起草人：李欣瑩、馬秋俠、丁盛舟、龐湃、劉陽。

II

MH/T3036—2024

民航綜合辦公平臺接口規(guī)范

1范圍

本文件規(guī)定了民航綜合辦公平臺人員信息、組織機構(gòu)、消息待辦、電子公文交換、行政審批事項等

非涉密系統(tǒng)接口的接入規(guī)范及要求。

本文件適用于中國民用航空局（以下簡稱“民航局”）、中國民用航空地區(qū)管理局、中國民用航空

安全監(jiān)督管理局各級行政機關(guān)及民航直屬單位、航空公司、機場等單位建設(shè)的擬與民航電子政務(wù)綜合辦

公平臺通過非涉密網(wǎng)絡(luò)對接的系統(tǒng)（以下簡稱“外部系統(tǒng)”）。

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

下列文件中的內(nèi)容通過文中的規(guī)范性引用而構(gòu)成本文件必不可少的條款。其中，注日期的引用文件，

僅該日期對應(yīng)的版本適用于本文件；不注日期的引用文件，其最新版本（包括所有的修改單）適用于本

文件。

GB/T11457—2006信息技術(shù)軟件工程術(shù)語

GB18030信息技術(shù)中文編碼字符集

3術(shù)語和定義

GB/T11457—2006界定的以及下列術(shù)語和定義適用于本文件。

電子公文electronicofficialdocument

以數(shù)字形式存儲于磁盤、光盤等媒體，依賴計算機系統(tǒng)閱讀、處理并可在通信網(wǎng)絡(luò)上傳輸?shù)墓摹?/p>

[來源：GB/T33476.1—2016，3.1]

基礎(chǔ)數(shù)據(jù)foundationaldata

涉及民航綜合辦公平臺組織機構(gòu)信息和人員信息的數(shù)據(jù)。

業(yè)務(wù)數(shù)據(jù)transactionaldata

民航綜合辦公平臺生成的公文，以及涉及事項提醒和行政審批事項的數(shù)據(jù)。

4通則

民航綜合辦公平臺對接分為基礎(chǔ)數(shù)據(jù)對接和業(yè)務(wù)數(shù)據(jù)對接兩類。

基礎(chǔ)數(shù)據(jù)對接實現(xiàn)了人員信息同步和組織機構(gòu)信息同步服務(wù)。為了實現(xiàn)基礎(chǔ)數(shù)據(jù)對接，外部系統(tǒng)應(yīng)

按照人員信息數(shù)據(jù)要素和組織機構(gòu)數(shù)據(jù)要素的約束要求進(jìn)行參數(shù)定義，并按照本文件規(guī)定的接入流程MH

和接口方式實現(xiàn)基礎(chǔ)數(shù)據(jù)的對接。

業(yè)務(wù)數(shù)據(jù)對接實現(xiàn)了消息待辦、電子公文交換和行政審批事項交換的業(yè)務(wù)需求。為了滿足各業(yè)務(wù)需

求，相應(yīng)外部系統(tǒng)應(yīng)分別按照消息待辦數(shù)據(jù)要素、電子公文數(shù)據(jù)要素、行政審批事項數(shù)據(jù)要素的約束要

求進(jìn)行參數(shù)定義，并按照本文件規(guī)定的接入流程要求實現(xiàn)各業(yè)務(wù)數(shù)據(jù)的對接。

基礎(chǔ)數(shù)據(jù)和業(yè)務(wù)數(shù)據(jù)的字符應(yīng)符合GB18030的規(guī)定。

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

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

人員信息數(shù)據(jù)要素用于描述建立連接的個人用戶的畫像，規(guī)定了人員信息的主要字段，及各字段的

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

1

MH/T3036—2024

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

序號對應(yīng)參數(shù)字段名稱字段解釋

1userId用戶Id人員的唯一標(biāo)識

2userName用戶姓名人員的真實姓名

人員編碼，系統(tǒng)登錄名

3userCode用戶登錄名（真實姓名為兩個字為姓名全拼，三個字及以上為名

字首字母_姓的命名規(guī)則，例如xm_wang）

4sex用戶性別1表示男，2表示女

5officePhone用戶電話辦公號碼，支持填寫區(qū)號和手機號

6email用戶郵箱工作郵箱

7createTime創(chuàng)建時間用戶賬號的創(chuàng)建時間，格式：2020-01-0109:30:30

用戶職務(wù)（黨組書記、副局長、黨組成員等，且支持

8zwId職務(wù)

填入兼職、非領(lǐng)導(dǎo)職務(wù)等描述）

用戶賬號的狀態(tài)，

9isValid用戶狀態(tài)0表示用戶是注銷狀態(tài)，

1表示用戶是開啟狀態(tài)

10deptId機構(gòu)Id用戶所屬部門唯一標(biāo)識

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

11updateTime修改時間

0109:30:30

12sort排序人員排序，整數(shù)型，數(shù)字序號由小到大排列

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

組織機構(gòu)數(shù)據(jù)要素用于描述建立連接的組織機構(gòu)用戶畫像，規(guī)定了組織機構(gòu)的主要字段，及各字段

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

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

序號對應(yīng)參數(shù)字段名稱字段解釋

1deptId機構(gòu)Id組織機構(gòu)的唯一標(biāo)識

2deptName機構(gòu)名稱組織機構(gòu)名稱

3parentId父節(jié)點上級部門唯一標(biāo)識

4sort序號部門排序，整數(shù)型，數(shù)字序號由小到大排列

部門的開啟狀態(tài)，

5isValid部門狀態(tài)0表示部門是注銷狀態(tài)，

1表示部門是開啟狀態(tài)

該機構(gòu)在系統(tǒng)中最后修改時間，格式：2020-01-01

6updateTime修改時間

09:30:30

部門等級，對于民航局1表示民航局級，2表示司局

7deptLevel部門等級級，3表示處級；對于管理局1表示管理局級，3表示

處級；對于監(jiān)管局1表示監(jiān)管局級，3表示處級

部門在系統(tǒng)中的創(chuàng)建時間，格式：2020-01-01

8createTime創(chuàng)建時間

09:30:30

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

消息待辦數(shù)據(jù)要素描述建立消息待辦時需提供的信息，規(guī)定了消息待辦的主要字段，及各字段的規(guī)

范中文名稱和含義。消息待辦數(shù)據(jù)要素應(yīng)符合表3的規(guī)定。

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

序號對應(yīng)參數(shù)字段名稱字段解釋

1appName系統(tǒng)名稱接入待辦系統(tǒng)的名稱

2agreementType接口協(xié)議接入待辦接口的網(wǎng)絡(luò)協(xié)議（http、https等）

2

MH/T3036—2024

表3消息待辦數(shù)據(jù)要素（續(xù)）

序號對應(yīng)參數(shù)字段名稱字段解釋

3ipAddressIP接入系統(tǒng)的固定ip地址

4appPort端口接入系統(tǒng)的端口

5type類型接入的待辦類型（辦文、辦事）

6itemName名稱接入的待辦事項名稱

查看外部系統(tǒng)詳情頁的跳轉(zhuǎn)地址（除去ip、端口后的

7itemPath系統(tǒng)訪問路徑

實際訪問地址）

獲取外部系統(tǒng)待辦數(shù)字的接口路徑（除去ip、端口的

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

實際接口地址），例如待辦公文5個的接口地址

9itemPicture圖片接入待辦在門戶中顯示的圖片

10userGroup所屬機構(gòu)接口的用戶范圍（機構(gòu)的唯一標(biāo)識）

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

電子公文數(shù)據(jù)要素描述實現(xiàn)電子公文交換時需提供的主要信息，規(guī)定了電子公文的主要字段，及各

字段的規(guī)范中文名稱和含義。電子公文數(shù)據(jù)要素應(yīng)符合表4的規(guī)定。

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

序號參數(shù)字段名稱字段解釋

1senderId發(fā)文機關(guān)-身份標(biāo)識發(fā)文機關(guān)的唯一標(biāo)識（注冊系統(tǒng)的機構(gòu)標(biāo)識）

2senderName發(fā)文機關(guān)-身份名稱發(fā)文機關(guān)機構(gòu)名稱

3senderDes發(fā)文機關(guān)-身份描述發(fā)文機關(guān)的身份描述

4receiverId收文機關(guān)-身份標(biāo)識收文機關(guān)的唯一標(biāo)識（注冊系統(tǒng)的機構(gòu)標(biāo)識）

5receiverName收文機關(guān)-身份名稱收文機關(guān)機構(gòu)名稱

6receiverDes收文機關(guān)-身份描述收文機關(guān)的身份描述

7secrecyLevel公文信息-密級公文密級（默認(rèn)都為無）

公文的緊急程度（文件為平件、急件、特急，電報為

8emergencyLevel公文信息-緊急程度

平件、急件、特急、特提）

9sendCode公文信息-發(fā)文機關(guān)發(fā)文機關(guān)的唯一標(biāo)識（注冊系統(tǒng)的機構(gòu)標(biāo)識）

10receiveCode公文信息-收文機關(guān)收文機關(guān)的唯一標(biāo)識（注冊系統(tǒng)的機構(gòu)標(biāo)識）

11title公文信息-公文標(biāo)題公文標(biāo)題

12content公文信息-公文內(nèi)容公文正文內(nèi)容（二進(jìn)制文件流通過base64編碼）

13fwId公文信息-發(fā)件標(biāo)識發(fā)件標(biāo)識（此文件的唯一標(biāo)識）

14otherOfc公文信息-其他公文信息-其他

15attachName附件集-附件名稱附件名稱（未帶后綴名）

16attachExtName附件集-擴展名文件擴展名（默認(rèn)支持所有類型文件）

17attachSize附件集-附件大小附件大?。▎挝籅yte），傳輸上限為100M

18attachContent附件集-附件內(nèi)容附件內(nèi)容（二進(jìn)制文件流通過base64編碼）

19docId回執(zhí)信息-公文標(biāo)識文件的唯一標(biāo)識

MH20receiptContent回執(zhí)信息-回執(zhí)內(nèi)容回執(zhí)內(nèi)容（簽收、退回等）

21receiptMemo回執(zhí)信息-回執(zhí)意見文件簽收或退回時附加的意見信息

22receiptTime回執(zhí)信息-回執(zhí)時間回執(zhí)時間（默認(rèn)取當(dāng)前系統(tǒng)時間）

23otherRet回執(zhí)信息-其他附加信息（OFC為公文信息報文，RET為回執(zhí)）

行政審批事項數(shù)據(jù)要素

行政審批事項數(shù)據(jù)要素描述實現(xiàn)行政審批事項交換時需提供的主要信息，分別規(guī)定了行政審批辦

件過程和行政審批辦理結(jié)果的主要字段，及各字段的規(guī)范中文名稱和含義。行政審批辦件過程數(shù)據(jù)要素

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

3

MH/T3036—2024

表5行政審批辦件過程數(shù)據(jù)要素

序號參數(shù)字段名稱字段解釋

1projectNO行政審批編號行政審批編號（唯一標(biāo)識）

2title標(biāo)題標(biāo)題

3applicant申請來文單位名稱申請來文單位名稱

4number來文編號來文編號

5contentId正文ID關(guān)聯(lián)正文文件的唯一ID

6applyAttachId附件ID關(guān)聯(lián)附件文件的唯一ID

7remark備注備注

8attatchName正文名稱正文文件名稱

9attatchFile正文文件正文文件路徑

10attatchName附件名稱附件文件名稱

11applyAttachId附件ID和辦件信息的附件ID關(guān)聯(lián)

12attatchFile附件文件附件文件路徑

表6行政審批辦理結(jié)果數(shù)據(jù)要素

序號參數(shù)字段名稱字段解釋

1projectNO行政審批編號行政審批編號（唯一標(biāo)識）

2projectType辦件類型辦件類型（限時辦文、呈批件）

3dealName辦理人姓名辦理人姓名

4dealStartTime辦理開始時間辦理開始時間，格式2020-01-0109:30:30

5dealEndTime辦理結(jié)束時間辦理結(jié)束時間，格式2020-01-0109:30:30

辦結(jié)結(jié)果(0表示不予批準(zhǔn)，1表示批準(zhǔn)，2表示轉(zhuǎn)

6proResult辦結(jié)結(jié)果

報，3表示終止辦件)

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

7proSeason不予批準(zhǔn)或終止辦件理由

要填寫）

8contentId正文ID正文ID（一個辦件對應(yīng)一個正文ID）

9applyAttachId附件ID附件ID（一個辦件所有附件對應(yīng)一個附件ID）

10remark備注備注

是否走特殊程序(0表示不走特殊程序，1表示走特殊

11isSpecial特殊程序標(biāo)識

程序)

特殊程序類型，下拉框（1表示延遲審批，2表示除延

12specialType特殊程序類型

長審計之外的情況）

13specialName特殊程序名稱特殊程序名稱

14specialReason特殊程序啟動理由特殊程序啟動理由或依據(jù)

15specialExplain特別程序辦理意見特別程序辦理意見

16specialDealPerson特別程序辦理人特別程序辦理人

17specialStartTime特殊程序開始時間特殊程序開始時間，格式2020-01-0109:30:30

18specialEndTime特殊程序結(jié)束時間特殊程序結(jié)束時間，格式2020-01-0109:30:30

6基礎(chǔ)數(shù)據(jù)對接要求

接入流程

4

MH/T3036—2024

圖1基礎(chǔ)數(shù)據(jù)對接接入流程

應(yīng)用注冊和接口調(diào)用鑒權(quán)業(yè)務(wù)流程，如圖1所示。

a)應(yīng)用注冊。外部系統(tǒng)提出接口調(diào)用申請，用于在民航電子政務(wù)綜合辦公平臺的應(yīng)用支撐平臺提

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

b)接口調(diào)用。外部系統(tǒng)調(diào)用接口時應(yīng)將自身應(yīng)用系統(tǒng)ID、當(dāng)前時間及數(shù)據(jù)加解密密鑰以JSON網(wǎng)

頁令牌（JWT）方式生成服務(wù)調(diào)用令牌（以下簡稱“token”）。JWT相關(guān)內(nèi)容應(yīng)符合附錄A的

要求。

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

token的請求頭。

d)服務(wù)鑒權(quán)。應(yīng)用支撐平臺應(yīng)對請求中的token進(jìn)行判斷，外部系統(tǒng)token有效并有接口調(diào)用

權(quán)限，則進(jìn)行后續(xù)服務(wù)調(diào)用。

接口方式

民航電子政務(wù)綜合辦公平臺對外發(fā)布、請求的服務(wù)統(tǒng)一采用RESTful架構(gòu)的Web服務(wù)。

接口類型：POST。

接口服務(wù)說明

6.3.1人員信息同步服務(wù)

MH在應(yīng)用支撐平臺完成注冊的應(yīng)用，可同步民航電子政務(wù)綜合辦公平臺人員信息，每天同步一次。具

體接口調(diào)用方式如下。

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

b)人員信息同步服務(wù)接口參數(shù)應(yīng)符合表7的規(guī)定。

表7人員信息同步服務(wù)接口參數(shù)

數(shù)據(jù)長度

類別參數(shù)必填數(shù)據(jù)類型說明

byte

updateTime是String32上一次同步的時間，格式為yyyy-MM-ddHH-mm-ss

入?yún)?/p>

orgId是String32同步人員的組織機構(gòu)編碼

userId是String32人員的唯一標(biāo)識

userName是String16人員的真實姓名

出參

人員編碼，系統(tǒng)登錄名（真實姓名為兩個字為姓名全拼，三個

userCode是String16

字及以上為名字首字母_姓的命名規(guī)則）

5

MH/T3036—2024

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

數(shù)據(jù)長度

類別參數(shù)必填數(shù)據(jù)類型說明

byte

sex是String1用戶性別，0表示男，1表示女

officePhone是String[]16辦公號碼，支持填寫區(qū)號和手機號

email是String[]32工作郵箱

createTime是String32用戶賬號的創(chuàng)建時間

zwId是String32用戶職務(wù)（黨組書記、副局長、黨組成員等）

出參

isValid是String1用戶狀態(tài)，0表示用戶是注銷狀態(tài)，1表示用戶是開啟狀態(tài)

deptId是String32用戶所屬部門唯一標(biāo)識

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

updateTime是String32

09:30:30

sort是String8人員排序，數(shù)字序號由小到大排列

注：以上參數(shù)取值，傳遞之前需進(jìn)行URLEncoder轉(zhuǎn)換。返回數(shù)據(jù)類型為JSON類型，詳情見示例。

示例：人員信息同步服務(wù)調(diào)用返回內(nèi)容

{

"Result":

{

"status":"200",

"body":[{"zwId":"","userCode":"sf_zhao","officePhone":"","email":"sf_zhao@","sex":"1","i

sValid":"1","sort":"14","userName":"張三","userId":"af5b873ddc084297876238268dfb33a8",

"createTime":"2021-06-0615:30:20",

"deptId":"5724eed0e2ba42a9a736bc0a61016bab","updateTime":"2020-01-0109:30:30"}]

}

}

6.3.2組織機構(gòu)信息同步服務(wù)

在應(yīng)用支撐平臺完成注冊的應(yīng)用，可同步民航電子政務(wù)綜合辦公平臺組織機構(gòu)及子機構(gòu)信息，每天

同步一次。具體接口調(diào)用方式如下。

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

b)組織機構(gòu)信息同步服務(wù)接口參數(shù)應(yīng)符合表8的規(guī)定。

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

數(shù)據(jù)長度

類別參數(shù)必填數(shù)據(jù)類型說明

byte

updateTime是String32上一次同步的時間，格式為yyyy-MM-ddHH-mm-ss

入?yún)?/p>

orgId是String32同步部門的組織機構(gòu)編碼

deptId是String32組織機構(gòu)的唯一標(biāo)識

deptName是String[]64組織機構(gòu)名稱，包括當(dāng)前部門及子部門信息

parentId是String32上級部門唯一標(biāo)識

sort是String8部門排序，數(shù)字序號由小到大排列

部門的開啟狀態(tài)。

出參isValid是String10表示部門是注銷狀態(tài)，

1表示部門是開啟狀態(tài)

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

部門等級，對于民航局1表示民航局級，2表示司局級，3表

deptLevel是String1示處級；對于管理局1表示管理局級，3表示處級；對于監(jiān)管

局1表示監(jiān)管局級，3表示處級

createTime是String32部門在系統(tǒng)中的創(chuàng)建時間，格式：2020-01-0109:30:30

注：以上參數(shù)取值，傳遞之前需進(jìn)行URLEncoder轉(zhuǎn)換。返回數(shù)據(jù)類型為JSON類型，詳情見示例。

6

MH/T3036—2024

示例：組織機構(gòu)信息同步服務(wù)調(diào)用返回內(nèi)容

{

"Result":

{

"status":"200",

"body":[{"deptName":"機關(guān)人事處","deptLevel":"3","isValid":"1",

"deptId":"ccb47b50f5fb4a4fb9337b85f738ce82","updateTime":"2022-11-1410:58:20","sort":"4",

"parentId":"f6973bc4fce34bca8869480f45445832","createTime":"2022-11-1410:58:20"}]

}

}

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

消息待辦對接要求

7.1.1接入流程

圖2消息待辦對接接入流程

外部系統(tǒng)接入民航電子政務(wù)綜合辦公平臺門戶，配置待辦消息推送的業(yè)務(wù)流程，如圖2所示。

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

用注冊基本信息包括系統(tǒng)名稱、接口協(xié)議、IP地址等參數(shù)。

b)待辦信息配置。外部系統(tǒng)應(yīng)提供待辦信息用于在民航電子政務(wù)綜合辦公平臺進(jìn)行消息提醒配

置，待辦基本信息包括待辦事項類型、名稱、訪問路徑等。

7.1.2應(yīng)用注冊配置參數(shù)

MH外部系統(tǒng)接入，應(yīng)在民航電子政務(wù)綜合辦公平臺進(jìn)行應(yīng)用注冊。應(yīng)用注冊配置參數(shù)應(yīng)符合表9的規(guī)

定。

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

序號字段名稱字段解釋對應(yīng)參數(shù)

1系統(tǒng)名稱接入待辦系統(tǒng)的名稱appName

2接口協(xié)議接入待辦接口的網(wǎng)絡(luò)協(xié)議（http、https等）agreementType

3IP接入系統(tǒng)的ip地址或域名ipAddress

4端口接入系統(tǒng)的端口appPort

7.1.3待辦信息配置參數(shù)

應(yīng)用注冊成功后，應(yīng)提供待辦信息用于配置消息提醒。待辦接口信息配置參數(shù)應(yīng)符合表10的規(guī)定。

7

MH/T3036—2024

表10待辦接口信息配置參數(shù)

序號字段名稱字段解釋對應(yīng)參數(shù)

1類型接入的待辦類型（辦文、辦事）type

2名稱接入的待辦事項名稱itemName

查看外部系統(tǒng)詳情頁的跳轉(zhuǎn)地址（除去ip、端

3系統(tǒng)訪問路徑itemPath

口后的實際訪問地址）

獲取外部系統(tǒng)待辦數(shù)字的接口路徑（除去ip、

4待辦數(shù)字接口路徑端口的實際接口地址），例如待辦公文5個的itemNumPath

接口地址

5圖片接入待辦在門戶中顯示的圖片itemPicture

6所屬機構(gòu)接口的用戶范圍（機構(gòu)的唯一標(biāo)識）userGroup

電子公文交換對接要求

7.2.1電子公文發(fā)送對接要求

接入流程

圖3電子公文發(fā)送對接接入流程

外部系統(tǒng)將電子公文發(fā)送給民航電子政務(wù)綜合辦公平臺的業(yè)務(wù)流程，如圖3所示。

8

MH/T3036—2024

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

用系統(tǒng)ID及數(shù)據(jù)加解密密鑰，用于接口調(diào)用。

b)接口調(diào)用。外部系統(tǒng)調(diào)用接口時應(yīng)將應(yīng)用系統(tǒng)ID、當(dāng)前時間及數(shù)據(jù)加解密密鑰以JSON網(wǎng)頁令

牌（JWT）方式生成服務(wù)調(diào)用令牌（以下簡稱“token”）。JWT相關(guān)內(nèi)容應(yīng)符合附錄A的要求。

c)請求服務(wù)。外部系統(tǒng)向民航電子政務(wù)綜合辦公平臺網(wǎng)關(guān)請求服務(wù)時，應(yīng)發(fā)送帶有token的請求

頭。

d)服務(wù)鑒權(quán)。服務(wù)網(wǎng)關(guān)應(yīng)對請求中的token進(jìn)行判斷，外部系統(tǒng)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)過國密算法加密后

發(fā)送到民航電子政務(wù)綜合辦公平臺公文交換系統(tǒng)，公文交換系統(tǒng)應(yīng)返回成功或者失敗的公文

發(fā)送狀態(tài)碼給外部系統(tǒng)。

f)接收公文狀態(tài)。民航電子政務(wù)綜合辦公平臺將公文接收或退回后，民航電子政務(wù)綜合辦公平臺

公文交換系統(tǒng)應(yīng)將公文接收狀態(tài)碼返回給外部系統(tǒng)，外部系統(tǒng)應(yīng)返回成功或者失敗的狀態(tài)碼

給公文交換系統(tǒng)。

應(yīng)用注冊配置參數(shù)

應(yīng)用注冊配置參數(shù)應(yīng)符合表11的規(guī)定。

表11應(yīng)用注冊配置參數(shù)

序號字段名稱字段解釋對應(yīng)參數(shù)

1系統(tǒng)名稱接入交換系統(tǒng)的名稱appName

2IP接入系統(tǒng)的固定ip地址ipAddress

3端口接入系統(tǒng)的端口appPort

4接口地址接收公文數(shù)據(jù)包的接口地址interfaceName

5機構(gòu)標(biāo)識接入機構(gòu)的唯一標(biāo)識用來發(fā)送接收文件使用orgId

發(fā)送公文數(shù)據(jù)包接口方式

接口類型：電子公文交換發(fā)送接口統(tǒng)一采用基于SOAP協(xié)議的WebService接口。

發(fā)送公文數(shù)據(jù)包接口服務(wù)說明

在公文交換系統(tǒng)完成注冊的應(yīng)用，可以向民航電子政務(wù)綜合辦公平臺發(fā)送公文信息。具體接口調(diào)用

方式如下。

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

b)調(diào)用頻次：應(yīng)不超過5次每秒。

c)發(fā)送公文數(shù)據(jù)包接口參數(shù)應(yīng)符合表12的規(guī)定。

表12發(fā)送公文數(shù)據(jù)包接口參數(shù)

MH類別參數(shù)必填數(shù)據(jù)類型說明

入?yún)mlContent是String加密后的交換數(shù)據(jù)包

result是String返回狀態(tài)。success為成功，failed為失敗

出參

msg是String返回提示

注：XML中標(biāo)簽<其他>的值設(shè)置為OFC。返回數(shù)據(jù)類型為JSON類型，詳情見示例。

示例：發(fā)送公文數(shù)據(jù)包接口服務(wù)返回內(nèi)容

{

"message":

{

"result":"success",

"msg":"數(shù)據(jù)發(fā)送成功！"

}

}

9

MH/T3036—2024

d)公文交換系統(tǒng)以標(biāo)準(zhǔn)的公文包加密進(jìn)行傳輸交換。標(biāo)準(zhǔn)公文包的內(nèi)容包括公文元數(shù)據(jù)、公文內(nèi)

容、附件，公文包以XML格式進(jìn)行傳輸，示例參見附錄B。

接收狀態(tài)參數(shù)

民航電子政務(wù)綜合辦公平臺業(yè)務(wù)人員將公文接收或退回后，民航電子政務(wù)綜合辦公平臺公文交換

系統(tǒng)將公文接收狀態(tài)碼返回給外部系統(tǒng)，外部系統(tǒng)返回成功或者失敗的狀態(tài)碼給公文交換系統(tǒng)。接收狀

態(tài)業(yè)務(wù)參數(shù)應(yīng)符合表13的規(guī)定。

表13接收狀態(tài)業(yè)務(wù)參數(shù)

類別參數(shù)必填數(shù)據(jù)類型說明

入?yún)mlContent是String交換數(shù)據(jù)包，XML字符串類型

result是String返回狀態(tài)。success為成功，failed為失敗

出參

msg是String返回提示

注：XML中標(biāo)簽<其他>的值為RET，代表該數(shù)據(jù)包為公文接收狀態(tài)的數(shù)據(jù)包。<回執(zhí)內(nèi)容>的值代表接收狀態(tài)。

7.2.2電子公文接收對接要求

接入流程

圖4電子公文接收對接接入流程

10

MH/T3036—2024

外部系統(tǒng)接收來自于民航電子政務(wù)綜合辦公平臺公文的業(yè)務(wù)流程，如圖4所示。

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

用系統(tǒng)ID及數(shù)據(jù)加解密密鑰，用于公文數(shù)據(jù)包加解密使用。

b)接收公文數(shù)據(jù)包。民航電子政務(wù)綜合辦公平臺公文交換系統(tǒng)應(yīng)通過注冊接口將使用數(shù)據(jù)加解

密密鑰經(jīng)過國密算法加密后的公文數(shù)據(jù)包發(fā)送給外部系統(tǒng)，外部系統(tǒng)應(yīng)返回成功或者失敗的狀態(tài)碼給

公文交換系統(tǒng)。

c)公文數(shù)據(jù)包解密。外部系統(tǒng)接收到公文數(shù)據(jù)包后，應(yīng)使用數(shù)據(jù)加解密密鑰對公文數(shù)據(jù)包進(jìn)行解

密。

d)返回公文狀態(tài)。外部系統(tǒng)將公文接收或退回后，外部系統(tǒng)應(yīng)將公文接收狀態(tài)碼返回給民航電子

政務(wù)綜合辦公平臺公文交換系統(tǒng)，公文交換系統(tǒng)應(yīng)返回成功或者失敗的狀態(tài)碼給外部系統(tǒng)。

應(yīng)用注冊配置參數(shù)

外部系統(tǒng)接入前，應(yīng)在民航電子政務(wù)公文交換系統(tǒng)進(jìn)行應(yīng)用注冊。注冊信息應(yīng)符合表11的規(guī)定。

接收公文數(shù)據(jù)包接收參數(shù)

應(yīng)用注冊成功后，當(dāng)民航電子政務(wù)綜合辦公平臺業(yè)務(wù)人員將公文發(fā)送給外部單位時，公文交換系統(tǒng)

應(yīng)通過注冊接口將公文數(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)簽<其他>的值為OFC，代表該

數(shù)據(jù)包為公文數(shù)據(jù)包。

公文交換系統(tǒng)以標(biāo)準(zhǔn)的公文包加密后進(jìn)行傳輸交換。標(biāo)準(zhǔn)公文包的內(nèi)容包括公文元數(shù)據(jù)、公文內(nèi)容

和附件，公文包以XML格式進(jìn)行傳輸，示例參見附錄B。

返回公文狀態(tài)接口服務(wù)說明

外部系統(tǒng)將公文接收或退回后，外部系統(tǒng)將公文接收狀態(tài)碼返回給民航電子政務(wù)綜合辦公平臺公

文交換系統(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ù)

類別參數(shù)必填數(shù)據(jù)類型說明

入?yún)mlContent是String交換數(shù)據(jù)包，XML字符串類型

result是String返回狀態(tài)。success為成功，failed為失敗

出參

msg是String返回提示

注：XML中標(biāo)簽<其他>的值設(shè)置為RET，<回執(zhí)內(nèi)容>的值設(shè)置為接收或退回。

c)外部系統(tǒng)以標(biāo)準(zhǔn)的公文包進(jìn)行傳輸交換。標(biāo)準(zhǔn)公文包的內(nèi)容包括公文元數(shù)據(jù)、回執(zhí)