ICS35.08015IDB15/T3486.4—2024前言 12規(guī)范性引用文件 13術(shù)語和定義 14縮略語 15數(shù)據(jù)接口 1 15.2數(shù)據(jù)推送接口 26數(shù)據(jù)接口開發(fā)要求 2 26.2請求報文舉例 2 26.4調(diào)用權(quán)限控制 27接口說明 37.1用戶信息對接接口 37.2機構(gòu)管理 4 77.4終端位置信息管理 DB15/T3486.4—2024本文件按照GB/T1.1—2020《標準化工作導(dǎo)則第1部分：標準化文件的結(jié)構(gòu)和起草規(guī)則》的規(guī)定起草。本文件是DB15/T3486《內(nèi)蒙古北斗高分綜合應(yīng)用服務(wù)平臺》的第4部分。DB15/T3486已經(jīng)發(fā)布了——第1部分：功能描述——第2部分：短報文數(shù)據(jù)傳輸協(xié)議；——第3部分：4G數(shù)據(jù)傳輸協(xié)議；——第4部分：數(shù)據(jù)接口；——第5部分：高分服務(wù)二次開發(fā)要求；——第6部分：安全要求。本文件由中共內(nèi)蒙古自治區(qū)委員會軍民融合發(fā)展委員會辦公室提出。本文件由內(nèi)蒙古自治區(qū)軍民融合標準化技術(shù)委員會（SAM/TC57）歸口。本文件起草單位：內(nèi)蒙古自治區(qū)軍民融合發(fā)展研究中心、航天恒星科技有限公司、內(nèi)蒙古衛(wèi)星應(yīng)用產(chǎn)業(yè)協(xié)會、內(nèi)蒙古自治區(qū)知識產(chǎn)權(quán)保護中心、內(nèi)蒙古自治區(qū)大數(shù)據(jù)中心。本文件主要起草人：王偉、孟斌、劉賀、吳凱、崔濤、蘇明明、郭稚鷹、王雯鐸、任淑慧、郭嘉麗、李申陽、史欣赫、史凌峰、董國棟、袁鵬、張靜、張建軍、石彥龍。DB15/T3486.4—2024制定北斗高分綜合應(yīng)用服務(wù)平臺功能描述、數(shù)據(jù)傳輸協(xié)議、數(shù)據(jù)接口、二次開發(fā)和安全要求系列標準有助于構(gòu)建一個功能豐富、安全可信、易于集成和拓展的北斗高分綜合應(yīng)用服務(wù)平臺，推動相關(guān)產(chǎn)業(yè)的快速發(fā)展，提高用戶體驗，促進創(chuàng)新。北斗高分綜合應(yīng)用服務(wù)平臺系列標準由六部分構(gòu)成?！?部分：功能描述。有助于確保不同組件和模塊之間的功能一致性，避免因不同開發(fā)者理解不同而導(dǎo)致的功能差異。明確的功能描述可以提高開發(fā)人員的理解和實現(xiàn)的一致性。有助于提供一致的用戶體驗。無論用戶使用平臺的哪一部分，他們都能夠期望相似的功能和操作方式，降低了學(xué)習(xí)成本和提高了用戶滿意度?！?部分：短報文數(shù)據(jù)傳輸協(xié)議。制定短報文數(shù)據(jù)傳輸協(xié)議標準確保不同組件和模塊之間能夠進行有效的數(shù)據(jù)交換，提高了平臺的互操作性。這對于整合不同數(shù)據(jù)源、設(shè)備和服務(wù)至關(guān)重要?！?部分：4G數(shù)據(jù)傳輸協(xié)議。優(yōu)化的數(shù)據(jù)傳輸協(xié)議可以提高數(shù)據(jù)傳輸效率，減少網(wǎng)絡(luò)帶寬的占用，加速數(shù)據(jù)處理和分析的過程?！?部分：數(shù)據(jù)接口。定義統(tǒng)一的數(shù)據(jù)接口標準有助于不同組件和系統(tǒng)之間實現(xiàn)更加順暢的數(shù)據(jù)交互，提高平臺的互操作性，支持各類數(shù)據(jù)的集成與共享?！?部分：高分服務(wù)二次開發(fā)要求。制定二次開發(fā)標準有助于構(gòu)建健康的開發(fā)生態(tài)系統(tǒng)。標準化的開發(fā)接口和工具使得第三方開發(fā)者更容易參與平臺的生態(tài)系統(tǒng)，從而促進創(chuàng)新和市場競爭。明確的二次開發(fā)標準降低了開發(fā)者的學(xué)習(xí)成本，加速了應(yīng)用程序和服務(wù)的開發(fā)周期?！?部分：安全要求。制定安全要求標準有助于確保平臺對于數(shù)據(jù)和用戶隱私的處理是安全可靠的。這對于用戶信任的建立至關(guān)重要，也有助于維護平臺的聲譽。DB15/T3486.4—20241內(nèi)蒙古北斗高分綜合應(yīng)用服務(wù)平臺第4部分：數(shù)據(jù)接口本文件規(guī)定了內(nèi)蒙古北斗高分綜合應(yīng)用服務(wù)平臺不同功能模塊間的數(shù)據(jù)接口、數(shù)據(jù)接口開發(fā)要求及接口說明。本文件適用于內(nèi)蒙古北斗高分綜合應(yīng)用服務(wù)平臺（以下簡稱平臺）的接口設(shè)計。2規(guī)范性引用文件下列文件中的內(nèi)容通過文中的規(guī)范性引用而構(gòu)成本文件必不可少的條款。其中，注日期的引用文件，僅該日期對應(yīng)的版本適用于本文件；不注日期的引用文件，其最新版本（包括所有的修改單）適用于本文件。GB/T11457信息技術(shù)軟件工程術(shù)語GB/T25070信息安全技術(shù)網(wǎng)絡(luò)安全等級保護安全設(shè)計技術(shù)要求3術(shù)語和定義GB/T11457、GB/T25070界定的以及下列術(shù)語和定義適用于本文件。3.1數(shù)據(jù)接口datainterface提供異構(gòu)數(shù)據(jù)源統(tǒng)一標準化的數(shù)據(jù)對外應(yīng)用開發(fā)接口服務(wù)，滿足個性化數(shù)據(jù)需求。4縮略語下列縮略語適用于本文件。ID：身份標識號縮寫，具有唯一性（Identitydocument）IMEI：國際移動設(shè)備識別碼,即設(shè)備序列號，具有唯一性（Internationalmobileequipmentidentity）5數(shù)據(jù)接口5.1Web訪問接口Web訪問接口為業(yè)務(wù)系統(tǒng)中的數(shù)據(jù)需求提供數(shù)據(jù)服務(wù)支持。通過標準協(xié)議和個性化參數(shù)來滿足各業(yè)務(wù)系統(tǒng)的數(shù)據(jù)需求。整個WEB訪問接口基于大數(shù)據(jù)基礎(chǔ)支撐組件并采用分布式架構(gòu)，提供跨編程語言、2DB15/T3486.4—2024跨操作系統(tǒng)平臺的遠程調(diào)用，向外界提供一系列能通過Web調(diào)用的API接口實現(xiàn)其他業(yè)務(wù)應(yīng)用調(diào)用，滿足內(nèi)蒙古北斗高分行業(yè)其他業(yè)務(wù)需求。5.2數(shù)據(jù)推送接口通過利用消息隊列構(gòu)建業(yè)務(wù)數(shù)據(jù)推送接口服務(wù)，同時針對不同的場景可用采用不同的推送模式，滿足個性化推送需求。為了提升推送的到達率，可通過服務(wù)發(fā)起多種類型的消息推送，用戶可根據(jù)實際的業(yè)務(wù)場景，選擇合適的推送內(nèi)容、推送渠道以及推送方式。6數(shù)據(jù)接口開發(fā)要求支持如下HTTP調(diào)用方式：a)PUT：更新資源，請求消息必須包含資源中的部分或所有成員；b)POST：創(chuàng)建資源，請求消息必須包含資源中的一個成員；c)GET：請求指定的資源信息；d)DELETE：刪除一個或所有支持post方法的資源成員。6.2請求報文舉例當方法是PUT/POST時，HTTP主體通常需要包含JSON數(shù)據(jù)。請求必須發(fā)送到服務(wù)端的HTTP/HTTPS端口。6.3響應(yīng)報文舉例響應(yīng)報文舉例如下：a)“URL”：代表HTTP請求消息攜帶的URL。求方法為get/put/delete時，URL與請求中的URL相同。post請求，它是新創(chuàng)建對象的URL?？蛻舳丝梢允褂盟苯荧@取新對象；b)“CreatedID”：代表資源支持httppost/delete方法。它將傳輸新對象的ID，該ID由服務(wù)器為新對象創(chuàng)建；c)“Code”：代表處理系統(tǒng)結(jié)果，表1常見狀態(tài)碼說明；d)“msg”：代表處理系統(tǒng)結(jié)果的解釋；e)“Data”：請求（獲?。┑馁Y源的信息或數(shù)據(jù)。大多數(shù)情況下都是JSON。對于相同的URL，放置請求數(shù)據(jù)格式與getresponse中的數(shù)據(jù)相同。如果服務(wù)器工作失敗，或者HTTP方法為Put/Post，則響應(yīng)“data"包含”null"。表1常見狀態(tài)碼說明6.4調(diào)用權(quán)限控制DB15/T3486.4—20243調(diào)用接口前需獲取Token，并在請求頭參數(shù)中包含“X-Access-Token”參數(shù)，否則調(diào)用失敗。7接口說明7.1用戶信息對接接口7.1.1獲取用戶信息請求url：/user/getUserInfoByToken。請求方式：POST。調(diào)用量上限（次/日）：500。請求頭參數(shù)見表2，接口返回參數(shù)見表3，data參數(shù)示例見表4。表2獲取用戶信息請求頭參數(shù)表3返回參數(shù)說明值表4data參數(shù)示例說明7.1.2驗證賬號密碼請求URL：/user/verifyUsernameAndPassword。請求方式：POST。調(diào)用量上限（次/日）：500。請求參數(shù)見表5，接口返回參數(shù)見表6，data參數(shù)示例見表7。表5驗證賬號密碼請求參數(shù)說明是是是DB15/T3486.4—20244表6返回參數(shù)說明值表7data參數(shù)示例說明7.2機構(gòu)管理7.2.1列表查詢請求url：/org/getOrgList。請求方式：POST請求。調(diào)用量上限（次/日）：500。請求頭header見表8，請求參數(shù)見表9，返回參數(shù)說明見表10,data參數(shù)示例見表11。表8列表查詢請求頭說明值表9列表查詢請求參數(shù)說明否否否是是表10查詢列表返回參數(shù)說明值DB15/T3486.4—20245表11data參數(shù)示例說明7.2.2增加操作請求url：/org/addOrg。請求方式：POST請求。調(diào)用量上限（次/日）：500。請求頭header見表8，請求參數(shù)見表12，返回參數(shù)見表13。表12增加操作請求參數(shù)情況是是是否否否用戶id’否表13增加操作返回參數(shù)說明值7.2.3修改操作請求url：/org/updateOrg。請求方式：POST請求。調(diào)用量上限（次/日）：500。請求頭header見表8，請求參數(shù)見表14，返回參數(shù)見表15。DB15/T3486.4—20246表14修改操作請求參數(shù)情況是否是否是是是否否是否否否否表15修改操作返回參數(shù)說明值7.2.4刪除操作請求url：/org/deleteOrg。請求方式：POST請求。調(diào)用量上限（次/日）：500。請求頭header見表8，請求參數(shù)見表16，返回參數(shù)見表17。表16刪除操作請求參數(shù)情況是是表17刪除操作返回參數(shù)說明值7.2.5獲取所有機構(gòu)樹形結(jié)構(gòu)DB15/T3486.4—20247請求url：/org/getAllOrgTree。請求方式：POST請求。調(diào)用量上限（次/日1000。請求參數(shù)：無，返回參數(shù)見表18，data參數(shù)示例見表19。表18獲取所有機構(gòu)樹形結(jié)構(gòu)返回參數(shù)說明值表19data參數(shù)示例說明7.3終端操作7.3.1列表查詢請求url：/terminal/listTerminalTies。請求方式：POST請求。調(diào)用量上限（次/日1000。請求頭header見表8，請求參數(shù)見表20，返回參數(shù)見表21，data參數(shù)示例見表22，返回列表參數(shù)說明見表23。表20列表查詢請求參數(shù)情況否否否否否DB15/T3486.4—20248表20列表查詢請求參數(shù)情況（續(xù)）否否否否是是表21終端列表返回參數(shù)說明值表22終端列表data參數(shù)示例說明DB15/T3486.4—20249表23返回列表參數(shù)說明dataProtocol:modelId:DB15/T3486.4—2024表23返回列表參數(shù)說明（續(xù)）warehouseworkStatus7.3.2增加操作請求url：/terminal/insertTerminal。請求方式：POST請求。調(diào)用量上限（次/日）：500。請求頭header見表8，請求參數(shù)見表24，返回參數(shù)見表25。表24增加操作請求參數(shù)說明是是否workStatus否warehouse否是是是是否否否否否否否否否否否否否表25終端新增返回參數(shù)說明值7.3.3修改操作請求url：/terminal/updateTerminal。DB15/T3486.4—2024請求方式：POST請求。調(diào)用量上限（次/日）：500。請求頭header見表8，請求參數(shù)見表26，返回參數(shù)見表27。表26修改操作請求參數(shù)說明否否否否否否否否否否否否否否是否否否否否否否否否否否是否否否否是是否否否否DB15/T3486.4—2024表26修改操作請求參數(shù)說明（續(xù)）否否warehouse否workStatus否表27終端修改返回參數(shù)說明值7.3.4刪除操作請求url：/terminal/updateTerminalDelFlag。請求方式：POST請求。調(diào)用量上限（次/日）：500。請求頭header見表8，請求參數(shù)見表28，返回參數(shù)見表29。表28刪除操作請求參數(shù)說明是表29終端刪除操作返回參數(shù)說明值7,4終端位置信息管理7.4.1獲取終端位置信息（實時軌跡）請求url：/search/getLocation。請求方式：GET請求。調(diào)用量上限（次/日10000。請求參數(shù)見表30，返回參數(shù)見表31，data參數(shù)示例見表32。表30獲取終端位置信息請求參數(shù)說明是DB15/T3486.4—2024表31獲取終端位置信息返回參數(shù)說明值表32獲取終端位置信息data返回參數(shù)說明7.4.2獲取終端位置信息（歷史軌跡）請求url：/dataVisit/findHistoryAll。請求方式：POST請求。調(diào)用量上限（次/日1000。請求參數(shù)見表33，返回參數(shù)見表34，返回數(shù)據(jù)格式見表35。表33獲取終端位置信息（歷史軌跡）請求參數(shù)說明是是是表34獲取終端位置信息（歷史軌跡）返回參數(shù)說明值表35獲取終端位置信息返回數(shù)據(jù)格式說明7.4.3短報文下發(fā)下發(fā)接口：/BDDA/rest/command/messageTxtNew。請求方式：POST。DB15/T3486.4—2024調(diào)用量上限（次/日1000。請求參數(shù)見表36，返回參數(shù)見表3