ICS35.240CCSL773502IDB3502/T170—2024前言 12規(guī)范性引用文件 13術(shù)語(yǔ)和定義 14縮略語(yǔ) 25接入原則 26接入流程 27接口規(guī)范 68安全要求 9運(yùn)維要求 （資料性）“i廈門(mén)”平臺(tái)服務(wù)對(duì)接申請(qǐng)表37 參考文獻(xiàn) 44DB3502/T170—2024本文件按照GB/T1.1—2020《標(biāo)準(zhǔn)化工作導(dǎo)則第1部分：標(biāo)準(zhǔn)化文件的結(jié)構(gòu)和起草規(guī)則》的規(guī)定起草。請(qǐng)注意本文件的某些內(nèi)容可能涉及專(zhuān)利。本文件的發(fā)布機(jī)構(gòu)不承擔(dān)識(shí)別專(zhuān)利的責(zé)任。本文件由廈門(mén)市民數(shù)據(jù)服務(wù)股份有限公司提出。本文件由廈門(mén)市數(shù)據(jù)管理局歸口。本文件起草單位：廈門(mén)市民數(shù)據(jù)服務(wù)股份有限公司、廈門(mén)市數(shù)據(jù)管理局、廈門(mén)市信息中心、廈門(mén)市標(biāo)準(zhǔn)化研究院。本文件主要起草人：紀(jì)榮造、蔡婧、韓紹兵、王楊、白毅、蔡躍華、上官慧柏、林晨、李童、余曉燕、曾煥輝、陳瑀。DB3502/T170—20241“i廈門(mén)”平臺(tái)系統(tǒng)接入及服務(wù)入駐規(guī)范本文件規(guī)定了“i廈門(mén)”平臺(tái)系統(tǒng)接入及服務(wù)入駐的接入原則、接入流程、接口規(guī)范、安全要求、運(yùn)維要求及界面要求。本文件適用于廈門(mén)市各機(jī)關(guān)、事業(yè)單位和公共服務(wù)企業(yè)的服務(wù)應(yīng)用在“i廈門(mén)”平臺(tái)上的接入及入駐工作。2規(guī)范性引用文件下列文件中的內(nèi)容通過(guò)文中的規(guī)范性引用而構(gòu)成本文件必不可少的條款。其中，注日期的引用文件，僅該日期對(duì)應(yīng)的版本適用于本文件；不注日期的引用文件，其最新版本（包括所有的修改單）適用于本文件。GB/T22239—2019信息安全技術(shù)網(wǎng)絡(luò)安全等級(jí)保護(hù)基本要求GB/T35273—2020信息安全技術(shù)個(gè)人信息安全規(guī)范GB/T43506—2023電信和互聯(lián)網(wǎng)服務(wù)用戶(hù)個(gè)人信息保護(hù)技術(shù)要求GB/T44248—2024信息技術(shù)生物特征識(shí)別人臉識(shí)別系統(tǒng)應(yīng)用要求3術(shù)語(yǔ)和定義下列術(shù)語(yǔ)和定義適用于本文件。3.1為市民和企業(yè)提供權(quán)威綜合公共服務(wù)和便民服務(wù)的統(tǒng)一入口,整合各類(lèi)應(yīng)用，提供政務(wù)、生活、健康、教育、文化、交通、社保等多領(lǐng)域在線(xiàn)服務(wù)，構(gòu)建市民、企業(yè)和政府互聯(lián)互通體系，“一云多端”一站式便民利企的服務(wù)平臺(tái)。3.2平臺(tái)主管部門(mén)platformadministrationdepartment負(fù)責(zé)“i廈門(mén)”平臺(tái)頂層規(guī)劃和監(jiān)督管理，協(xié)調(diào)推動(dòng)服務(wù)事項(xiàng)入駐。3.3平臺(tái)建設(shè)單位platformdevelopmentorganization受主管部門(mén)委托，履行平臺(tái)業(yè)主職能，負(fù)責(zé)平臺(tái)的建設(shè)、運(yùn)行、運(yùn)營(yíng)、審核和安全管理。3.4平臺(tái)運(yùn)營(yíng)單位platformoperationorganization受建設(shè)單位的委托，負(fù)責(zé)平臺(tái)的研發(fā)實(shí)施、運(yùn)行維護(hù)和安全管理，為服務(wù)的提供方和使用方提供日常運(yùn)營(yíng)服務(wù)，保障平臺(tái)整體安全。3.5服務(wù)提供單位serviceproviderorganization服務(wù)提供單位是市民服務(wù)領(lǐng)域的各機(jī)關(guān)、事業(yè)單位和公共服務(wù)企業(yè)，是“i廈門(mén)”平臺(tái)的服務(wù)提供方，負(fù)責(zé)協(xié)調(diào)落實(shí)本單位與平臺(tái)相關(guān)的市民服務(wù)事項(xiàng)的入駐管理、數(shù)據(jù)管理和安全管理。DB3502/T170—202423.6開(kāi)放平臺(tái)openplatform為“i廈門(mén)”平臺(tái)服務(wù)提供單位提供統(tǒng)一的發(fā)布、運(yùn)營(yíng)、管理的一體化服務(wù)平臺(tái)。4縮略語(yǔ)下列縮略語(yǔ)適用于本文件。APP：移動(dòng)端應(yīng)用程序（Application）CSS：層疊樣式表（CascadingStyleSheets）H5：第五版標(biāo)準(zhǔn)通用標(biāo)記語(yǔ)言（HyperTextMarkupLanguageV5.0）JS：開(kāi)發(fā)互聯(lián)網(wǎng)頁(yè)面的腳本語(yǔ)言（JavaScript）Json：基于JavaScript語(yǔ)法子集的開(kāi)放標(biāo)準(zhǔn)數(shù)據(jù)交換格式（JavaScriptObjectNotation）SDK：軟件開(kāi)發(fā)工具包（SoftwareDevelopmentKit）5接入原則5.1統(tǒng)一接入流程接入服務(wù)應(yīng)按照統(tǒng)一的接入流程進(jìn)行接入、開(kāi)發(fā)與發(fā)布。5.2統(tǒng)一接口規(guī)范接入服務(wù)應(yīng)按照統(tǒng)一的接口規(guī)范與“i廈門(mén)”平臺(tái)進(jìn)行數(shù)據(jù)交互和服務(wù)能力開(kāi)發(fā)。5.3統(tǒng)一安全要求接入服務(wù)應(yīng)符合“i廈門(mén)”平臺(tái)統(tǒng)一的安全要求，保障服務(wù)應(yīng)用及數(shù)據(jù)安全。5.4統(tǒng)一運(yùn)維要求接入服務(wù)應(yīng)符合“i廈門(mén)”平臺(tái)統(tǒng)一的運(yùn)維要求，保障服務(wù)應(yīng)用的穩(wěn)定性及可用性。5.5統(tǒng)一界面風(fēng)格接入服務(wù)應(yīng)符合“i廈門(mén)”平臺(tái)統(tǒng)一的界面設(shè)計(jì)要求，實(shí)現(xiàn)界面風(fēng)格統(tǒng)一、用戶(hù)交互體驗(yàn)一致。6接入流程6.1接入總體流程“i廈門(mén)”平臺(tái)入駐流程主要分為應(yīng)用接入流程、應(yīng)用變更流程及應(yīng)用暫?；蚪K止流程三大流程，見(jiàn)圖1-圖3。DB3502/T170—20243圖1應(yīng)用接入流程圖2應(yīng)用變更流程DB3502/T170—20244圖3應(yīng)用暫停或終止流程6.2接入申請(qǐng)6.2.1提交申請(qǐng)服務(wù)提供單位向“i廈門(mén)”平臺(tái)建設(shè)單位提出書(shū)面入駐申請(qǐng)，平臺(tái)建設(shè)單位應(yīng)在5個(gè)工作日內(nèi)，組織平臺(tái)運(yùn)營(yíng)單位做好對(duì)接服務(wù)，開(kāi)展入駐服務(wù)的測(cè)試和上線(xiàn)工作。入駐申請(qǐng)材料包括《關(guān)于申請(qǐng)服務(wù)對(duì)接“i廈門(mén)”平臺(tái)的函》、《“i廈門(mén)”平臺(tái)服務(wù)對(duì)接申請(qǐng)表》及《安全承諾書(shū)》，見(jiàn)附錄A、附錄B及附錄C。6.2.2分配賬號(hào)“i廈門(mén)”平臺(tái)運(yùn)營(yíng)單位通過(guò)線(xiàn)上或線(xiàn)下發(fā)送開(kāi)放平臺(tái)賬號(hào)給服務(wù)提供單位，賬號(hào)分配內(nèi)容包含“i廈門(mén)”接入平臺(tái)地址、登錄賬號(hào)及登錄密碼。6.3應(yīng)用創(chuàng)建6.3.1創(chuàng)建系統(tǒng)服務(wù)提供單位收到分配賬號(hào)后，登錄開(kāi)放平臺(tái)填寫(xiě)系統(tǒng)信息、服務(wù)承建單位信息、系統(tǒng)保護(hù)評(píng)定評(píng)級(jí)信息后創(chuàng)建系統(tǒng)。6.3.2創(chuàng)建應(yīng)用服務(wù)提供單位填寫(xiě)應(yīng)用基本信息、測(cè)試環(huán)境信息、正式環(huán)境信息、服務(wù)承建單位信息，創(chuàng)建應(yīng)用后可獲取應(yīng)用聯(lián)調(diào)參數(shù)。6.4應(yīng)用開(kāi)發(fā)6.4.1功能開(kāi)發(fā)服務(wù)不應(yīng)含有任何非法內(nèi)容，不應(yīng)進(jìn)行任何違法行為且不應(yīng)違反社會(huì)公德，服務(wù)提供單位依據(jù)入駐申請(qǐng)的建設(shè)內(nèi)容對(duì)應(yīng)用進(jìn)行開(kāi)發(fā)。6.4.2測(cè)試聯(lián)調(diào)服務(wù)提供單位在開(kāi)發(fā)過(guò)程中，使用平臺(tái)提供的服務(wù)能力，應(yīng)指定專(zhuān)人與平臺(tái)運(yùn)營(yíng)單位進(jìn)行開(kāi)發(fā)對(duì)接與測(cè)試聯(lián)調(diào)。DB3502/T170—202456.5應(yīng)用發(fā)布6.5.1測(cè)試版發(fā)布測(cè)試版發(fā)布應(yīng)遵循以下流程：——上傳測(cè)試版程序包，生成版本記錄；——生成測(cè)試二維碼，掃碼進(jìn)行測(cè)試；——測(cè)試通過(guò)后，生成正式環(huán)境密鑰。6.5.2正式發(fā)布服務(wù)應(yīng)用正式發(fā)布前應(yīng)提交審核，并進(jìn)行以下操作：——確認(rèn)發(fā)布的版本號(hào)、版本更新說(shuō)明、應(yīng)用類(lèi)型、首頁(yè)地址和單點(diǎn)登錄地址；——上傳“測(cè)試報(bào)告”和“操作手冊(cè)”；——選擇是否審核通過(guò)后立即上線(xiàn)。若“是”，則審核通過(guò)后生產(chǎn)版本立即切換，若“否”，則審核通過(guò)后可通過(guò)版本管理頁(yè)面，設(shè)置版本上線(xiàn)時(shí)間；——提交正式版本審核。提交審核后，等待平臺(tái)運(yùn)營(yíng)單位對(duì)服務(wù)版本進(jìn)行審核，審核結(jié)果將同步推送通知給服務(wù)提供單位；——服務(wù)提供單位可在審核記錄中查看提交審核版本與審核情況。6.6應(yīng)用變更6.6.1變更申請(qǐng)服務(wù)提供單位需要變更服務(wù)內(nèi)容的，應(yīng)向平臺(tái)建設(shè)單位發(fā)起變更申請(qǐng)，變更申請(qǐng)流程見(jiàn)6.2.1。6.6.2功能修改服務(wù)提供單位根據(jù)實(shí)際需求對(duì)應(yīng)用進(jìn)行變更，應(yīng)用變更應(yīng)填寫(xiě)更新內(nèi)容，且應(yīng)再次進(jìn)行測(cè)試版本發(fā)布。6.6.3測(cè)試版發(fā)布應(yīng)用變更測(cè)試版發(fā)布應(yīng)遵循以下流程：——上傳變更后的測(cè)試版程序包，生成版本記錄；——生成測(cè)試二維碼，掃碼進(jìn)行測(cè)試。6.6.4正式發(fā)布應(yīng)用變更正式發(fā)布前應(yīng)提交審核，并進(jìn)行以下操作：——確認(rèn)發(fā)布的版本號(hào)、版本更新說(shuō)明、應(yīng)用類(lèi)型、首頁(yè)地址和單點(diǎn)登錄地址；——上傳變更后版本“測(cè)試報(bào)告”與變更后版本“操作手冊(cè)”；——選擇是否審核通過(guò)后立即上線(xiàn)。若“是”，則審核通過(guò)后生產(chǎn)版本立即切換，若“否”，則審核通過(guò)后可通過(guò)版本管理頁(yè)面，設(shè)置版本上線(xiàn)時(shí)間；——提交正式版本審核。提交審核后，等待平臺(tái)運(yùn)營(yíng)單位對(duì)服務(wù)版本進(jìn)行審核，審核結(jié)果將同步推送通知給服務(wù)提供單位；——服務(wù)提供單位可在審核記錄中查看提交審核版本與審核情況。DB3502/T170—202466.7應(yīng)用暫?；蚪K止6.7.1暫停或終止申請(qǐng)服務(wù)事項(xiàng)需暫?；蚪K止的，服務(wù)提供單位應(yīng)至少提前5個(gè)工作日向平臺(tái)建設(shè)單位報(bào)備。平臺(tái)建設(shè)單位在收到申請(qǐng)后5個(gè)工作日內(nèi)完成審核，審核通過(guò)后通知平臺(tái)運(yùn)營(yíng)單位辦理服務(wù)暫?；蛳戮€(xiàn)。6.7.2正式下線(xiàn)需暫?；蚪K止的服務(wù)應(yīng)用，由平臺(tái)運(yùn)營(yíng)單位提前10個(gè)工作日通過(guò)“i廈門(mén)”平臺(tái)統(tǒng)一發(fā)布公告。如遇特殊情況緊急暫?；蛳戮€(xiàn)的，平臺(tái)運(yùn)營(yíng)單位應(yīng)向平臺(tái)建設(shè)單位報(bào)備后給予執(zhí)行，待服務(wù)提供單位完成整改和測(cè)試以后再予以恢復(fù)上線(xiàn)。7接口規(guī)范7.1單點(diǎn)登錄7.1.1第三方應(yīng)用接入流程第三方系統(tǒng)接入流程見(jiàn)圖4，圖中code獲取見(jiàn)。DB3502/T170—20247圖4第三方系統(tǒng)接入流程圖7.1.2推送式單點(diǎn)登錄接口獲取授權(quán)碼獲取授權(quán)碼接口說(shuō)明見(jiàn)表1。用戶(hù)允許授權(quán)后，將會(huì)重定向到redirect_uri的網(wǎng)址上，并附帶code參數(shù)，返回結(jié)果參數(shù)見(jiàn)表2。DB3502/T170—20248表1推送式單點(diǎn)登錄獲取授權(quán)碼接口是是是是是redirect_uri?code=CODE表2推送式單點(diǎn)登錄獲取授權(quán)碼返回參數(shù)獲取調(diào)用憑證獲取調(diào)用憑證接口說(shuō)明見(jiàn)表3，返回結(jié)果參數(shù)見(jiàn)表4，表4中接口作用域（scope）的可調(diào)用接口列表見(jiàn)表5。表3推送式單點(diǎn)登錄獲取調(diào)用憑證接口是是是是是注：參數(shù)組裝在請(qǐng)求URL上，如：請(qǐng)求URL?Code=XXX&cli表4推送式單點(diǎn)登錄獲取調(diào)用憑證接口返回參數(shù)DB3502/T170—20249表4（續(xù)）表5接口作用域可調(diào)用接口列表{"jti":"1578a3e2-26a4-4252-8a54-0c44a7447763"}獲取用戶(hù)信息獲取用戶(hù)信息接口說(shuō)明見(jiàn)表6。獲取用戶(hù)信息后應(yīng)符合GB/T43506—2023中7.3條款要求，保護(hù)用戶(hù)個(gè)人信息。表6獲取用戶(hù)信息接口是注：參數(shù)組裝在請(qǐng)求URL上，如：請(qǐng)求URL?acces{{DB3502/T170—2024"authTypeEn":"PASSED_}7.1.3SDK方式單點(diǎn)登錄獲取調(diào)用憑證獲取調(diào)用憑證接口說(shuō)明見(jiàn)表7，返回結(jié)果參數(shù)見(jiàn)表8。表7SDK方式單點(diǎn)登錄獲取調(diào)用憑證接口是是是是注：參數(shù)組裝在請(qǐng)求URL上，如：請(qǐng)求URL?scope=XXX&client_id=XXX...DB3502/T170—2024表8SDK方式單點(diǎn)登錄獲取調(diào)用憑證返回參數(shù)注：客戶(hù)端模式獲取的access_token只{"jti":"24f10f91-49}獲取用戶(hù)信息獲取用戶(hù)信息接口說(shuō)明見(jiàn)表9。表9SDK方式單點(diǎn)登錄獲取用戶(hù)信息接口資源服務(wù)器地址/resource/client/user/getUs是{}7.2移動(dòng)端開(kāi)放能力接入7.2.1開(kāi)放能力接入流程移動(dòng)端開(kāi)放能力流程見(jiàn)圖5，系統(tǒng)支持iOS、Android和HarmonyOS，7.2中示例采用JS語(yǔ)法格式。DB3502/T170—2024圖5移動(dòng)端開(kāi)放能力流程7.2.2APP與H5交互接口獲取與設(shè)置.1獲取設(shè)備id用于獲取APP設(shè)備id。其中：——Android方法：android.getDeviceId()；——HarmonyOS方法：harmony.getDeviceId()；——iOS方法：innoPlus.device.uuid。.2獲取APP系統(tǒng)類(lèi)型判斷在APP嵌在Android、HarmonyOS、iOS內(nèi)，分別判斷android、harmony和innoPlus對(duì)象是否存在。其中：——Android方法：typeof(android)!=="undefined"；DB3502/T170—2024——HarmonyOS方法：typeof(harmony)!=="undefined"；——iOS方法：typeof(innoPlus)!=="undefined"。.3獲取APP名稱(chēng)用于獲取App名稱(chēng)，方法返回字符串“ixiamen”。其中：——Android方法：android.getAppName()；——HarmonyOS方法：harmony.getAppName()；——iOS方法：innoPlus.device.appname。.4獲取APP基礎(chǔ)參數(shù)用于獲APP基礎(chǔ)參數(shù)，返回結(jié)果見(jiàn)示例。其中：——Android方法：android.getBaseParams()；——HarmonyOS方法：harmony.getBaseParams()；——iOS方法：innoPlus.baseParam。{siteAreaCode:""}.5設(shè)置APP頭部標(biāo)題用于設(shè)置APP標(biāo)題欄的標(biāo)題。其中：——Android方法：android.setTitle(title)；——HarmonyOS方法：harmony.setTitle(title)；——iOS方法：innoPlus.native.setTitle(title)?？刂祁?lèi)操作.1打開(kāi)APP頁(yè)面用于跳轉(zhuǎn)到APP內(nèi)部頁(yè)面。其中：——Android方法：android.openWindow(path)；——HarmonyOS方法：harmony.openWindow(path)；——iOS方法：innoPlus.native.openWindow(path)。.2后退用于調(diào)用APP后退方法。其中：——Android方法：android.back()；——HarmonyOS方法：harmony.back()；——iOS方法：innoPlus.native.back()。.3關(guān)閉用于調(diào)用APP關(guān)閉webview窗口的方法。其中：——Android方法：android.close()；——HarmonyOS方法：harmony.close()；——iOS方法：innoPlus.native.close()。.4隱藏頭部用于隱藏APP頭部（標(biāo)題欄）。其中：——Android方法：android.hideHeader()；——HarmonyOS方法：harmony.hideHeader()；——iOS方法：innoPlus.native.hideNavbar()。登錄與認(rèn)證.1打開(kāi)登錄頁(yè)用于跳轉(zhuǎn)到APP內(nèi)部頁(yè)面。其中：——Android方法：android.openLogin()；——HarmonyOS方法：harmony.openLogin()；——iOS方法：innoPlus.native.openLoginPage()。.2根據(jù)身份證信息進(jìn)行人臉認(rèn)證用于調(diào)用APP人臉認(rèn)證，傳入json字符串(jsonStr)。安卓或鴻蒙設(shè)備，應(yīng)在全局對(duì)象window下注冊(cè)一個(gè)方法，將方法名作為參數(shù)傳遞給安卓或鴻蒙提供的方法。iOS設(shè)備，將js函數(shù)傳遞給方法，js函數(shù)需設(shè)置一個(gè)參數(shù)來(lái)接收傳遞的地址數(shù)據(jù)。其中：——Android方法：android.faceAuthWithRegister("functionName",jsonStr)；——HarmonyOS方法：harmony.faceAuthWithRegister("functionName",jsonStr)；——iOS方法：innoPlus.native.faceAuthWithRegister(callback,jsonStr)。{}android.faceAuthWithRegister("functharmony.faceAuthWithRegister("functionName".3調(diào)用APP人臉認(rèn)證頁(yè)面（是否高級(jí)認(rèn)證）用于調(diào)用APP人臉認(rèn)證，傳入json字符串(jsonStr)。安卓或鴻蒙設(shè)備，應(yīng)在全局對(duì)象window下注冊(cè)一個(gè)方法，將方法名作為參數(shù)傳遞給安卓或鴻蒙提供的方法。iOS設(shè)備，將js函數(shù)傳遞給方法，js函數(shù)需設(shè)置一個(gè)參數(shù)來(lái)接收傳遞的地址數(shù)據(jù)。其中：——Android方法：android.faceAuthWithAEO("functionName",jsonStr)；——HarmonyOS方法：harmony.faceAuthWithAEO("functionName",jsonStr)；——iOS方法：innoPlus.native.faceAuthWithAEO(callback,jsonStr)。{}android.faceAuthWithAEO("functioharmony.faceAuthWithAEO("functionName",.4APP登錄回調(diào)用于調(diào)用APP登錄后回調(diào)獲取用戶(hù)信息以及處理登錄后續(xù)操作。安卓或鴻蒙設(shè)備，應(yīng)在全局對(duì)象window下注冊(cè)一個(gè)方法，將方法名作為參數(shù)傳遞給安卓或鴻蒙提供的方法。iOS設(shè)備，將js函數(shù)傳遞給方法，js函數(shù)需設(shè)置一個(gè)參數(shù)來(lái)接收傳遞的地址數(shù)據(jù)。其中：——Android方法：android.APPLoginWithCallback("functionName")；——HarmonyOS方法：harmony.APPLoginWithCallback("functionName")；——iOS方法：innoPlus.native.APPLoginWithCallback(callback)。功能類(lèi)操作.1選擇代理企業(yè)列表用于選取代理企業(yè)列表。安卓或鴻蒙設(shè)備，應(yīng)在全局對(duì)象window下注冊(cè)一個(gè)方法，將方法名作為參數(shù)傳遞給安卓或鴻蒙提供的方法。iOS設(shè)備，將js函數(shù)傳遞給方法，js函數(shù)需設(shè)置一個(gè)參數(shù)來(lái)接收傳遞的地址數(shù)據(jù)。其中：——Android方法：android.selectAgentEnterprise("functionName")；——HarmonyOS方法：harmony.selectAgentEnterprise("functionName")；——iOS方法：innoPlus.native.selectAgentEnterprise(callback)。.2調(diào)用APP地址選擇用于調(diào)用APP地址選擇控件，獲取地址。安卓或鴻蒙設(shè)備，應(yīng)在全局對(duì)象window下注冊(cè)一個(gè)方法，將方法名作為參數(shù)傳遞給安卓或鴻蒙提供的方法。iOS設(shè)備，將js函數(shù)傳遞給方法，js函數(shù)需設(shè)置一個(gè)參數(shù)來(lái)接收傳遞的地址數(shù)據(jù)。其中：——Android方法：android.selectAddress("functionName")；——HarmonyOS方法：harmony.selectAddress("functionName")；——iOS方法：innoPlus.native.selectAddress(callback)。.3獲取當(dāng)前位置信息用于獲取當(dāng)前位置信息。安卓或鴻蒙設(shè)備，應(yīng)在全局對(duì)象window下注冊(cè)一個(gè)方法，將方法名作為參數(shù)傳遞給安卓或鴻蒙提供的方法。iOS設(shè)備，將js函數(shù)傳遞給方法，js函數(shù)需設(shè)置一個(gè)參數(shù)來(lái)接收傳遞的地址數(shù)據(jù)。其中：——Android方法：android.getLocationInfo("functionName")；——HarmonyOS方法：harmony.getLocationInfo("functionName")；——iOS方法：innoPlus.native.getLocationInfo(callback)。.4獲取當(dāng)前位置坐標(biāo)用于獲取當(dāng)前位置坐標(biāo)。安卓或鴻蒙設(shè)備，應(yīng)在全局對(duì)象window下注冊(cè)一個(gè)方法，將方法名作為參數(shù)傳遞給安卓或鴻蒙提供的方法。iOS設(shè)備，將js函數(shù)傳遞給方法，js函數(shù)需設(shè)置一個(gè)參數(shù)來(lái)接收傳遞的地址數(shù)據(jù)。其中：——Android方法：android.getLocationCoordinate("functionName")；——HarmonyOS方法：harmony.getLocationCoordinate("functionName")；——iOS方法：innoPlus.native.getLocationCoordinate(callback)。.5調(diào)用導(dǎo)航用于調(diào)用APP導(dǎo)航，傳遞json字符串。其中：——Android方法：android.navigation(JSON.stringify(obj))；——HarmonyOS方法：harmony.navigation(JSON.stringify(obj))；——iOS方法：innoPlus.map.nav(JSON.stringify(obj))。{}.6APP搜索地址頁(yè)用于調(diào)用APP搜索地址的頁(yè)面，可傳入建筑物名稱(chēng)，勾選對(duì)應(yīng)的地址，選擇后回調(diào)返回地址信息。安卓或鴻蒙設(shè)備，應(yīng)在全局對(duì)象window下注冊(cè)一個(gè)方法，將方法名作為參數(shù)傳遞給安卓或鴻蒙提供的方法。iOS設(shè)備，將js函數(shù)傳遞給方法，js函數(shù)需設(shè)置一個(gè)參數(shù)來(lái)接收傳遞的地址數(shù)據(jù)。其中：——Android：android.selectLocalAddress("functionName")；——HarmonyOS方法：harmony.selectLocalAddress("functionName")；——iOS方法：innoPlus.native.selectLocalAddress(name,callback)。.7復(fù)制文本用于復(fù)制文本。其中：——Android方法：android.copyToClipboard(str)；——HarmonyOS方法：harmony.copyToClipboard(str)；——iOS方法：innoPlus.native.paste(str)。.8撥打電話(huà)安卓系統(tǒng)通過(guò)調(diào)用原生方法傳入電話(huà)，實(shí)現(xiàn)撥打電話(huà)，iOS系統(tǒng)通過(guò)h5的a標(biāo)簽實(shí)現(xiàn)。其中：——Android：android.openDial(phoneNumber)；——HarmonyOS方法：hamorny.openDial(phoneNumber)；——iOS方法：<ahref="tel:110"></a>。圖文操作.1APP發(fā)起掃碼調(diào)用APP端掃碼功能。其中：——Android：調(diào)用android.openScanning()；——HarmonyOS方法：調(diào)用harmony.openScanning()；——iOS方法：innoPlus.native.openScanning()。.2APP獲取掃碼信息用于獲取掃描二維碼信息。安卓或鴻蒙設(shè)備，應(yīng)在全局對(duì)象window下注冊(cè)一個(gè)方法，將方法名作為參數(shù)傳遞給安卓或鴻蒙提供的方法。iOS設(shè)備，將js函數(shù)傳遞給方法，js函數(shù)需設(shè)置一個(gè)參數(shù)來(lái)接收傳遞的地址數(shù)據(jù)。其中：——Android方法：android.openScanningWithBlock("functionName")；——HarmonyOS方法：harmony.openScanningWithBlock("functionName")；——iOS方法：innoPlus.native.openScanningWithBlock(callback)。{}.3APP圖片預(yù)覽調(diào)用APP端圖片預(yù)覽功能。其中：——Android方法：android.photoBroswer(JSON.stringify(obj))；——HarmonyOS方法：harmony.photoBroswer(JSON.stringify(obj))；——iOS方法：innoPlus.native.photoBroswer(JSON.stringify(obj))。}.4PDF文檔預(yù)覽用于預(yù)覽PDF文檔。傳入文檔名稱(chēng)，文檔的路徑，iOS方法傳遞的參數(shù)為對(duì)象的字符串。其中：——Android方法：android.openPDF(fileName,fileUrl)；——HarmonyOS方法：harmony.openPDF(fileName,fileUrl)；——iOS方法：innoPlus.native.previewPDF(JSON.stringify(params))。};文件操作.1選擇文件用于選取文件附件。安卓或鴻蒙設(shè)備，應(yīng)在全局對(duì)象window下注冊(cè)一個(gè)方法，將方法名作為參數(shù)傳遞給安卓或鴻蒙提供的方法。iOS設(shè)備，將js函數(shù)傳遞給方法，js函數(shù)需設(shè)置一個(gè)參數(shù)來(lái)接收傳遞的地址數(shù)據(jù)。其中：——Android方法：android.selectMaterial("functionName",MAX_SIZE)；——HarmonyOS方法：harmony.selectMaterial("functionName",MAX_SIZE)；——iOS方法：innoPlus.native.selectMaterial(callback,MAX_SIZE)。DB3502/T170—20.2生成文件用于選取生成文件。安卓或鴻蒙設(shè)備，應(yīng)在全局對(duì)象window下注冊(cè)一個(gè)方法，將方法名作為參數(shù)傳遞給安卓或鴻蒙提供的方法。iOS設(shè)備，將js函數(shù)傳遞給方法，js函數(shù)需設(shè)置一個(gè)參數(shù)來(lái)接收傳遞的地址數(shù)據(jù)。其中：——Android方法：android.generateMaterial("functionName",MAX_SIZE)；——HarmonyOS方法：harmony.generateMaterial("functionName",MAX_SIZE)；——iOS方法：innoPlus.native.generateMaterial(callback,MAX_SIZE)。.3生成文件（自定義文件名）用于選取生成文件,可自定義文件名。安卓或鴻蒙設(shè)備，應(yīng)在全局對(duì)象window下注冊(cè)一個(gè)方法，將方法名作為參數(shù)傳遞給安卓或鴻蒙提供的方法。iOS設(shè)備，將js函數(shù)傳遞給方法,，js函數(shù)需設(shè)置一個(gè)參數(shù)來(lái)接收傳遞的地址數(shù)據(jù)。其中：——Android方法：android.createMaterial("functionName",MAX_SIZE)；——HarmonyOS方法：harmony.createMaterial("functionName",MAX_SIZE)；——iOS方法：innoPlus.native.createMaterial(callback,MAX_SIZE)。DB3502/T170—20247.2.3H5調(diào)用APP接口概述在需調(diào)用JS接口的頁(yè)面引入JS文件：ixm-jssdk.js。設(shè)備類(lèi)型在H5頁(yè)面，調(diào)用APP方法，判斷當(dāng)前APP系統(tǒng)，返回設(shè)備類(lèi)型H5/iOS/Android/HarmonyOS。方法名為ixm.getDeviceType()。ixm.getDeviceType();//返回設(shè)備類(lèi)型分享接口.1初始化分享描述接口初始化分享描述接口說(shuō)明見(jiàn)表10。表10初始化分享描述接口進(jìn)入H5頁(yè)面，頁(yè)面右上角出現(xiàn)分享按鈕，可分享自定義內(nèi)容至微{desc:'我是描述',//分享描述thirdSystemId:'828e62d19f4b49a2a74c677}.2事件觸發(fā)分享接口事件觸發(fā)分享接口說(shuō)明見(jiàn)表11。DB3502/T170—2024表11事件觸發(fā)分享接口{desc:'我是描述',//分享描述thirdSystemId:'828e62d19f4b49a2a74c677}圖片接口.1從手機(jī)相冊(cè)中選圖接口從手機(jī)相冊(cè)中選圖接口說(shuō)明見(jiàn)表12，返回結(jié)果參數(shù)見(jiàn)表13。表12從手機(jī)相冊(cè)中選圖接口varfieIds=res.fieIds;//返回DB3502/T170—2024{});.2拍攝圖片接口拍攝圖片接口說(shuō)明見(jiàn)表14，返回結(jié)果參數(shù)見(jiàn)表15。表14使用手機(jī)相機(jī)拍攝照片接口表15使用手機(jī)相機(jī)拍攝照片接口返回參數(shù)varfieId=res.fieId;});.3預(yù)覽圖片接口預(yù)覽圖片接口說(shuō)明見(jiàn)表16。表16預(yù)覽圖片接口當(dāng)前顯示圖片的http鏈接{});.4下載圖片接口下周圖片接口說(shuō)明見(jiàn)表17，返回結(jié)果參數(shù)見(jiàn)表18。表17下載圖片接口{{});.5獲取本地圖片接口獲取本地圖片接口說(shuō)明見(jiàn)表19，返回結(jié)果參數(shù)見(jiàn)表20。表19獲取本地圖片接口DB3502/T170—2024{{});音頻接口.1開(kāi)始錄音接口{});.2停止錄音接口停止錄音接口說(shuō)明見(jiàn)表22，返回結(jié)果參數(shù)見(jiàn)表23。表22停止錄音接口});.3播放語(yǔ)音接口播放語(yǔ)音接口說(shuō)明見(jiàn)表24。表24播放語(yǔ)音接口.4暫停播放接口在H5頁(yè)面，調(diào)用APP方法，手機(jī)暫停播放音頻的本地ID。方法名為ixm.pauseVoice()。.5停止播放接口在H5頁(yè)面，調(diào)用APP方法，手機(jī)停止播放音頻的本地ID。方法名為ixm.stopVoice()。認(rèn)證接口.1當(dāng)前用戶(hù)人臉認(rèn)證接口當(dāng)前用戶(hù)人臉認(rèn)證接口說(shuō)明見(jiàn)表25。表25當(dāng)前用戶(hù)人臉認(rèn)證接口.2人臉認(rèn)證接口人臉認(rèn)證接口說(shuō)明見(jiàn)表26。接入用戶(hù)人臉認(rèn)證接口的系統(tǒng)應(yīng)符合GB/T44248—2024第四章的基本要DB3502/T170—2024表26人臉認(rèn)證接口{});.3銀行卡認(rèn)證接口銀行卡認(rèn)證接口說(shuō)明見(jiàn)表27。表27銀行卡認(rèn)證接口證{DB3502/T170—2024});支付接口支付接口說(shuō)明見(jiàn)表28。表28支付接口{{});地址管理.1獲取APP地址接口獲取APP地址接口說(shuō)明見(jiàn)表29，返回結(jié)果參數(shù)見(jiàn)表30。表29獲取APP地址接口表30獲取APP地址接口返回參數(shù)DB3502/T170—2024表30（續(xù)）{{});8安全要求8.1用戶(hù)安全要求接入服務(wù)應(yīng)采用“i廈門(mén)”平臺(tái)用戶(hù)認(rèn)證體系，兼容上級(jí)政務(wù)服務(wù)平臺(tái)，通過(guò)調(diào)用“i廈門(mén)”相關(guān)功能，支持個(gè)人/法人用戶(hù)的登錄、注冊(cè)、刷臉認(rèn)證等。8.2用戶(hù)數(shù)據(jù)要求接入服務(wù)在使用用戶(hù)數(shù)據(jù)前，應(yīng)告知用戶(hù)并獲取用戶(hù)授權(quán)同意。收集用戶(hù)個(gè)人信息應(yīng)符合GB/T35273—2020中第5章的要求。8.3接口安全要求8.3.1接口鑒權(quán)要求接入服務(wù)可以使用以下兩種鑒權(quán)模式：——安全鑒權(quán)，即請(qǐng)求簽名機(jī)制，雙方以安全方式存儲(chǔ)通訊密鑰；——白名單鑒權(quán)，即接口僅向平臺(tái)的白名單開(kāi)放。8.3.2接口傳輸要求接入服務(wù)接口數(shù)據(jù)傳輸應(yīng)使用HTTPS協(xié)議，防止接口數(shù)據(jù)被竊取與篡改。DB3502/T170—20248.4數(shù)據(jù)脫敏要求接入服務(wù)應(yīng)按相關(guān)要求對(duì)數(shù)據(jù)進(jìn)行脫敏處理。脫敏范圍應(yīng)不少于50%。用戶(hù)隱私信息使用*替換，脫敏規(guī)則包括但不限于：——中文姓名：至少覆蓋一個(gè)字符，大于5個(gè)字符以上留首尾各一個(gè)字符，大于15個(gè)字符以上留首尾各兩個(gè)字符；——年齡：按照年齡規(guī)則進(jìn)行分檔，嬰幼兒（出生至6歲）、少兒（7歲至12歲）、青少年（13歲至17歲）、青年（18歲至45歲）、中年（46歲至69歲）、老年（70歲以上）；——公民身份證號(hào)：保留前2位和后4位；——手機(jī)號(hào)：保留前3位和后4位；——固定電話(huà)：保留后4位；——電子郵箱：保留前2位及@后面部分；——銀行卡號(hào)：保留前4位及后4位；——地址：保留前6位；——QQ：保留前2位及后1位；——微信：每隔2位用*替換2位；——車(chē)牌號(hào)：保留地區(qū)編碼和后兩位；——其它：按實(shí)際業(yè)務(wù)需求進(jìn)行脫敏。8.5外部資源安全要求接入服務(wù)不應(yīng)直接調(diào)用外部資源，對(duì)于服務(wù)引用的文件資源（如CSS、JS、圖片等），應(yīng)隨服務(wù)應(yīng)用統(tǒng)一部署在政務(wù)云平臺(tái)上。如須使用外部資源，需上報(bào)平臺(tái)主管部門(mén)審核，經(jīng)平臺(tái)運(yùn)營(yíng)單位評(píng)估審核通過(guò)后方可使用。9運(yùn)維要求接入運(yùn)維要求包括但不限于：——系統(tǒng)的上線(xiàn)及變更應(yīng)提交應(yīng)用上線(xiàn)及變更申請(qǐng)表，通過(guò)平臺(tái)運(yùn)營(yíng)方審批后方可執(zhí)行；——系統(tǒng)上線(xiàn)及后續(xù)運(yùn)維過(guò)程中，應(yīng)每半年梳理平臺(tái)管理帳號(hào)，清理過(guò)期或未使用賬號(hào)；——應(yīng)支持運(yùn)維可視化狀態(tài)監(jiān)控功能，包括但不限于服務(wù)、進(jìn)程、模塊等監(jiān)控，支持提供接口與平臺(tái)統(tǒng)一運(yùn)維中心對(duì)接；——應(yīng)支持異常告警功能包括但不限于服務(wù)、進(jìn)程、模塊等，支持短信、微信、郵件等形式發(fā)送告警信息；——應(yīng)設(shè)置每月至少一次的系統(tǒng)巡檢任務(wù)，并具備巡檢打點(diǎn)記錄功能，巡檢記錄可以導(dǎo)出，巡檢范圍包括但不限于各子系統(tǒng)、模塊、服務(wù)進(jìn)程等；——應(yīng)每年提供應(yīng)用和數(shù)據(jù)安全自查表，提供給平臺(tái)運(yùn)營(yíng)方審查；——服務(wù)提供單位應(yīng)確保服務(wù)提供期間系統(tǒng)穩(wěn)定可用并提供適宜的客服服務(wù)；——涉及國(guó)家安全、社會(huì)秩序、公共利益以及公民、法人和其它組織合法權(quán)益的系統(tǒng)，應(yīng)符合GB/T22239—2019網(wǎng)絡(luò)安全等級(jí)保護(hù)要求。10界面要求10.1移動(dòng)端接入界面要求DB3502/T170—202410.1.1設(shè)計(jì)尺寸設(shè)計(jì)稿尺寸應(yīng)以寬750px，高1334px作為標(biāo)準(zhǔn)頁(yè)面大小，界面尺寸見(jiàn)圖6。圖6界面尺寸10.1.2總體布局界面布局應(yīng)符合8px原理，所有間距或標(biāo)準(zhǔn)尺寸都為8px的倍數(shù)（特殊情況可調(diào)整適配界面組成部分及其間距應(yīng)符合以下要求，界面組成部分尺寸見(jiàn)圖7：——頂部狀態(tài)欄：40px；——導(dǎo)航欄最小高度：88px；——導(dǎo)航欄下滑動(dòng)Tab度度：88px；——底部tab高度：98px；——內(nèi)容塊之間最小間距：16px；——內(nèi)容結(jié)束的最小間距：16px；——屏幕左右與內(nèi)容最小間距：24px；——常規(guī)列表卡片最小高度：96px；——按鈕高度：88px；——界面設(shè)計(jì)參考見(jiàn)附錄D。DB3502/T170—2024圖7界面組成部分尺寸10.1.3色彩規(guī)范主色主色是產(chǎn)品的代表顏色。常用于主要按鈕和文字、重點(diǎn)操作狀態(tài)、高亮體系、空狀態(tài)等。功能色功能色向用戶(hù)明確傳達(dá)成功、警告、錯(cuò)誤、連接等信息和狀態(tài)。DB3502/T170—2024中性色調(diào)和產(chǎn)品界面色彩搭配，襯托主色及其他色彩，有利于拉開(kāi)內(nèi)容層次，令用戶(hù)專(zhuān)注與內(nèi)容。常用于文字、背景、圖標(biāo)、邊框和分割線(xiàn)等元素。。DB3502/T170—2024遮罩色遮罩色用于作為底色