ICS35.200

CCSM57

T/GXAS

團(tuán)體標(biāo)準(zhǔn)

T/GXAS811—2024

田長(zhǎng)巡管理系統(tǒng)接口規(guī)范

Specificationforinterfaceoffieldchiefpatrolmanagementsystem

2024-08-09發(fā)布2024-08-15實(shí)施

廣西標(biāo)準(zhǔn)化協(xié)會(huì)發(fā)布

T/GXAS811—2024

目次

前言......................................................................................II

1范圍.....................................................................................1

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

3術(shù)語(yǔ)和定義..............................................................................1

4縮略語(yǔ)..................................................................................1

5系統(tǒng)接口架構(gòu)............................................................................1

6數(shù)據(jù)要求................................................................................2

7接口調(diào)用流程...........................................................................3

8開(kāi)發(fā)要求...............................................................................10

附錄A（規(guī)范性）互聯(lián)互通接口描述......................................................11

附錄B（規(guī)范性）安全驗(yàn)證接口及消息描述...............................................12

附錄C（資料性）安全驗(yàn)證接口參數(shù)示例..................................................13

附錄D（規(guī)范性）結(jié)構(gòu)化數(shù)據(jù)接口描述....................................................14

附錄E（資料性）結(jié)構(gòu)化數(shù)據(jù)接口參數(shù)示例...............................................16

附錄P（規(guī)范性）文件接口描述..........................................................20

附錄G（資料性）文件接口參數(shù)示例......................................................22

附錄H（規(guī)范性）空間服務(wù)信息接口描述..................................................25

附錄I（資料性）空間服務(wù)信息接口參數(shù)示例...............................................27

附錄J（規(guī)范性）視頻信息接口描述......................................................30

附錄K（資料性）視頻信息接口參數(shù)示例..................................................32

參考文獻(xiàn)..................................................................................35

I

T/GXAS811—2024

-JLX-.1

刖百

本文件參照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é)任。

本文件由廣西壯族自治區(qū)自然資源調(diào)查監(jiān)測(cè)院提出并宣貫。

本文件由廣西標(biāo)準(zhǔn)化協(xié)會(huì)歸口。

本文件起草單位：廣西壯族自治區(qū)自然資源調(diào)查監(jiān)測(cè)院、廣西壯族自治區(qū)自然資源產(chǎn)品質(zhì)量檢驗(yàn)中

心、南寧市自然資源信息集團(tuán)有限公司。

本文件主要起草人：馮一軍、楊如軍、梁雄乾、梁繞、文浩翔、鐘昌海、莊翔、陳遠(yuǎn)婷、楊捷、陳

偉健、李斌、谷小康、高瑞瑤、黃永盛、程少?gòu)?qiáng)、蔣勛、黃應(yīng)建、黃聰、葉科峰、劉佳、陳玉鑫、蘭卉、

陸澤堯、梁文麗、賴(lài)敏娜。

II

T/GXAS811—2024

田長(zhǎng)巡管理系統(tǒng)接口規(guī)范

1范圍

本文件界定了田長(zhǎng)巡管理系統(tǒng)接口涉及的術(shù)語(yǔ)和定義、縮略語(yǔ)，確立了系統(tǒng)接口框架，規(guī)定了數(shù)據(jù)

要求、接口調(diào)用流程、開(kāi)發(fā)要求。

本文件適用于田長(zhǎng)巡管理系統(tǒng)的數(shù)據(jù)交互和業(yè)務(wù)協(xié)同。

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

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

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

文件。

GB/T28168信息技術(shù)中間件消息中間件技術(shù)規(guī)范

GB/T32907信息安全技術(shù)SM4分組密碼算法

HJ1144生態(tài)保護(hù)紅線(xiàn)監(jiān)管技術(shù)規(guī)范臺(tái)賬數(shù)據(jù)庫(kù)建設(shè)(試行)

HJ1145生態(tài)保護(hù)紅線(xiàn)監(jiān)管技術(shù)規(guī)范數(shù)據(jù)質(zhì)量控制：試行)

T/GXAS809田長(zhǎng)巡管理系統(tǒng)數(shù)據(jù)庫(kù)建設(shè)規(guī)范

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

下列術(shù)語(yǔ)和定義適用于本文件。

3.1

田長(zhǎng)巡管理系統(tǒng)fieldchiefpatrolmanagementsystem

運(yùn)用地理信息系統(tǒng)、大數(shù)據(jù)分析與云計(jì)算、移動(dòng)互聯(lián)網(wǎng)等技術(shù)，建立具有實(shí)地巡查、上報(bào)、信息共

享等功能的耕地網(wǎng)格化信息化管理應(yīng)用系統(tǒng).

3.2

反地理編碼reversegeocodeIocation

將地球表面的經(jīng)緯度坐標(biāo)轉(zhuǎn)換為標(biāo)準(zhǔn)地址信息。

4縮略語(yǔ)

下列縮略語(yǔ)適用于本文件。

TCP/IP：傳輸控制協(xié)議/互聯(lián)網(wǎng)協(xié)議(TransmissionConti'olProtocol/IntcrnetProtocol)

HTTP：超文本傳輸協(xié)議(HyperTextTransferProtocol)

HTTPS：超文本傳輸安全協(xié)議，是一種通過(guò)計(jì)算機(jī)網(wǎng)絡(luò)進(jìn)行安全通信的傳輸協(xié)議(HyperText

TransferProtocolSecure)

JSON：JavaScript對(duì)象表示法(JavaScriptObjectNotation)

5系統(tǒng)接口架構(gòu)

5.1訪問(wèn)機(jī)制

以國(guó)土變更調(diào)查(脫密成果)有關(guān)業(yè)務(wù)數(shù)據(jù)建立的統(tǒng)一空間、統(tǒng)一數(shù)據(jù)格式的各級(jí)田長(zhǎng)責(zé)任耕地基

礎(chǔ)底庫(kù)數(shù)據(jù)庫(kù)為基礎(chǔ)，系統(tǒng)用戶(hù)可通過(guò)授權(quán)服務(wù)建立身份安全校驗(yàn)，將舉證材料換取成果校驗(yàn)碼，舉證

材料上報(bào)給田長(zhǎng)巡管理系統(tǒng)，系統(tǒng)將舉證信息傳入消息中間件，授權(quán)服務(wù)通過(guò)消費(fèi)消息形式生成舉證校

驗(yàn)碼入庫(kù)?；ヂ?lián)互通接口描述按附錄A執(zhí)行。

1

T/GXAS811—2024

5.2接口功能

5.2.1訪問(wèn)授權(quán)

田長(zhǎng)、網(wǎng)格員通過(guò)用戶(hù)名和空碼等方式進(jìn)行安全驗(yàn)證，獲取互聯(lián)互通接口訪問(wèn)授權(quán)：

a）四級(jí)田長(zhǎng)及以上用戶(hù)可查看和訪問(wèn)行政區(qū)域內(nèi)的永久基本農(nóng)田和舉證任務(wù)數(shù)據(jù)；

b）網(wǎng)格員用戶(hù)可查看和訪問(wèn)本村的永久基本農(nóng)田和個(gè)人舉證任務(wù)數(shù)據(jù)。

5.2.2數(shù)據(jù)推送

系統(tǒng)用戶(hù)向用長(zhǎng)巡笆理系統(tǒng)推送符合規(guī)范的舉證材料數(shù)據(jù)。

5.2.3數(shù)據(jù)提取

系統(tǒng)用戶(hù)從田長(zhǎng)巡管理系統(tǒng)突取問(wèn)題圖斑、舉證任務(wù)圖班數(shù)據(jù)等。

5.3接口類(lèi)型

5.3.1安全驗(yàn)證接口

用于系統(tǒng)用戶(hù)登錄田長(zhǎng)巡管理系統(tǒng)時(shí)的身份安全驗(yàn)證。

5.3.2結(jié)構(gòu)化數(shù)據(jù)接口

用于問(wèn)題圖斑上報(bào)下發(fā)、實(shí)時(shí)在線(xiàn)巡田軌跡上報(bào)、舉證任務(wù)下發(fā)上報(bào)、農(nóng)田耕地范圍下發(fā)等結(jié)構(gòu)化

數(shù)據(jù)的同步更新。

5.3.3文件接口

用于收集調(diào)查圖斑實(shí)時(shí)圖片、耕地現(xiàn)狀變化屬性等實(shí)體數(shù)據(jù)的在線(xiàn)傳輸。

5.3.4空間服務(wù)信息接口

用于反地理編碼獲取農(nóng)田圖斑范圍服務(wù)、各類(lèi)耕地功能產(chǎn)品柵格服務(wù)、耕地服務(wù)等空間服務(wù)地址及

服務(wù)信息的在線(xiàn)共享。

5.3.5視頻信息接口

用于收集調(diào)查圖斑視頻及視頻信息的實(shí)時(shí)共享。

6數(shù)據(jù)要求

6.1數(shù)據(jù)內(nèi)容

以國(guó)土變更調(diào)查（脫密成果）有關(guān)業(yè)務(wù)數(shù)據(jù)建立的統(tǒng)一空間、統(tǒng)一-數(shù)據(jù)格式的各級(jí)田長(zhǎng)責(zé)任耕地基

礎(chǔ)底數(shù)數(shù)據(jù)庫(kù)為基礎(chǔ)，主要包括耕地的劃定和調(diào)整、永久基本農(nóng)CD保護(hù)紅線(xiàn)成果等相關(guān)成果數(shù)據(jù)，最終

形成耕地保護(hù)監(jiān)管數(shù)據(jù)全覆蓋、動(dòng)態(tài)更新。其中：

a）田長(zhǎng)巡管理系統(tǒng)向系統(tǒng)用戶(hù)提供的數(shù)據(jù)應(yīng)符合T/GXAS809的要求；

b）系統(tǒng)用戶(hù)向?qū)?yīng)行政區(qū)為田長(zhǎng)和網(wǎng)格員提供耕地保護(hù)紅線(xiàn)劃定和調(diào)整、疑似耕地破壞問(wèn)題核

實(shí)處理與整改、耕地保護(hù)修復(fù):成效評(píng)估、人類(lèi)活動(dòng)準(zhǔn)入和項(xiàng)目審批、視頻監(jiān)控、耕地紅線(xiàn)管

理等數(shù)據(jù)。

6.2格式

6.2.1結(jié)構(gòu)化數(shù)據(jù)

結(jié)構(gòu)化數(shù)據(jù)格式應(yīng)符合HJ1144的規(guī)定。

6.2.2文件實(shí)體

圖片文件采用JPEG、PNG格式進(jìn)行交換和共享，視頻文件采用MP4格式進(jìn)行交換和共享，矢量文件采

用SHP、GML格式進(jìn)行交換和共享c

9

T/GXAS811—2024

6.2.3空間服務(wù)

空間服務(wù)采用OGC標(biāo)準(zhǔn)進(jìn)行數(shù)據(jù)共享，支持NMS、WFS、WCS、WPS、WMTS等方式發(fā)布的地圖服務(wù)、影

像服務(wù)或矢量服務(wù)。

6.2.4流媒體

流媒體格式支持HTTPLiveStreaming網(wǎng)絡(luò)傳輸協(xié)議。

6.3質(zhì)量

6.3.1應(yīng)符合HJ1145的規(guī)定。

6.3.2響應(yīng)時(shí)間W3s,吞吐量＞400bps,并發(fā)數(shù)＞1000,出錯(cuò)率VI%,7X24h可用。

7接口調(diào)用流程

7.1安全驗(yàn)證接口

系統(tǒng)用戶(hù)通過(guò)安全驗(yàn)證接口訪問(wèn)田長(zhǎng)巡管理系統(tǒng)，通過(guò)用戶(hù)名和國(guó)密算法SM3加密后的密碼進(jìn)行身

份安全驗(yàn)證，提取令牌信息，實(shí)現(xiàn)其他應(yīng)用程序接口的安全訪問(wèn)。安全驗(yàn)證接口及消息描述按附錄B執(zhí)

行，安全驗(yàn)證接口參數(shù)示例見(jiàn)附錄C。

7.2結(jié)構(gòu)化數(shù)據(jù)接口

7.2.1結(jié)構(gòu)化數(shù)據(jù)推送接口

7.2.1.1系統(tǒng)用戶(hù)向田長(zhǎng)巡管理系統(tǒng)推送結(jié)構(gòu)化數(shù)據(jù)時(shí)：

，八誦;寸方仝叫泳桂口井的益■戚伯卑.

b）通過(guò)令牌信息訪問(wèn)或構(gòu)化數(shù)索靠建接口，將結(jié)構(gòu)化數(shù)據(jù)推送至相應(yīng)數(shù)據(jù)庫(kù)。

7.2.1.2結(jié)構(gòu)化數(shù)據(jù)推送接口調(diào)用流程見(jiàn)圖1,結(jié)構(gòu)化數(shù)據(jù)接口描述按附錄D執(zhí)行，結(jié)構(gòu)化數(shù)據(jù)接口

參數(shù)示例見(jiàn)附錄E。

圖1結(jié)構(gòu)化數(shù)據(jù)推送接口調(diào)用流程圖

7.2.2結(jié)構(gòu)化數(shù)據(jù)提取接口

7.2.2.1系統(tǒng)用戶(hù)從田長(zhǎng)巡管理系統(tǒng)提取結(jié)構(gòu)化數(shù)據(jù)時(shí):

a）通過(guò)安全驗(yàn)證接口獲取令牌信息；

3

T/GXAS811—2024

b）通過(guò)令牌信息訪問(wèn)結(jié)構(gòu)化數(shù)據(jù)提取接口，從田長(zhǎng)巡管理系統(tǒng)相應(yīng)數(shù)據(jù)庫(kù)獲取所需數(shù)據(jù)，存儲(chǔ)

至系統(tǒng)用戶(hù)數(shù)據(jù)庫(kù)。

7.2.2.2結(jié)構(gòu)化數(shù)據(jù)提取接LI調(diào)用流程見(jiàn)圖2,結(jié)構(gòu)化數(shù)據(jù)接口描述按附錄D執(zhí)行，結(jié)構(gòu)化數(shù)據(jù)接口

參數(shù)示例見(jiàn)附錄E。

圖2結(jié)構(gòu)化數(shù)據(jù)提取接口調(diào)用流程圖

7.3文件接口

7.3.1文件推送接口

7.3.1.1地方田長(zhǎng)或網(wǎng)格員向田長(zhǎng)巡管理系統(tǒng)推送舉證文件數(shù)據(jù)時(shí)：

a）通過(guò)安全驗(yàn)證接口獲取令牌信息：

b）通過(guò)令牌信息訪問(wèn)文件推送接口，將文件元數(shù)據(jù)推送至田長(zhǎng)巡附件數(shù)據(jù)庫(kù)，將文件實(shí)體數(shù)據(jù)

存儲(chǔ)至田長(zhǎng)巡管理系統(tǒng)磁盤(pán)陣列。

7.3.1.2文件推送接口調(diào)用流程見(jiàn)圖3,文件接口描述按附錄F執(zhí)行，文件接口參數(shù)示例見(jiàn)附錄G。

T/GXAS811—2024

圖3文件推送接口調(diào)用流程圖

7.3.2文件提取接口

7.3.2.1地方田長(zhǎng)或網(wǎng)格員向田長(zhǎng)巡管理系統(tǒng)提取舉證文件數(shù)據(jù)時(shí)：

a）通過(guò)安全驗(yàn)證接口獲取令牌信息；

b）通過(guò)令牌信息訪問(wèn)文件提取接口，將所需文件的元數(shù)據(jù)保存至系統(tǒng)用戶(hù)數(shù)據(jù)庫(kù)，同時(shí)，根據(jù)

文件元數(shù)據(jù)信息中的文件下載地址，獲取文件實(shí)體，并將文件實(shí)體存儲(chǔ)至系統(tǒng)用戶(hù)磁盤(pán)中。

7.3.2.2文件提取接II調(diào)用流程見(jiàn)圖4,文件接口描述按附錄F執(zhí)行，文件接口參數(shù)示例見(jiàn)附錄G.

5

T/GXAS811—2024

圖4文件提取接口調(diào)用流程圖

7.4空間服務(wù)信息接口

7.4.1反地理編碼獲取耕地范匡接口

7.4.1.1系統(tǒng)用戶(hù)向田長(zhǎng)巡管理系統(tǒng)獲取空間服務(wù)信息時(shí)：

a）通過(guò)安全驗(yàn)證接口獲取令牌信息；

b）通過(guò)令牌信息訪問(wèn)反地理編碼獲取耕地范圍接口，通過(guò)地方經(jīng)緯度獲取對(duì)應(yīng)的耕地范圍，并

存儲(chǔ)至系統(tǒng)用戶(hù)中。

7.4.1.2反地理編碼獲取耕地范圍接口調(diào)用流程見(jiàn)圖5,空間報(bào)務(wù)信息接口描述按附錄H執(zhí)行，空間

服務(wù)信息接口參數(shù)示例見(jiàn)附錄Io

6

T/GXAS811—2024

圖5反地理編碼獲取農(nóng)田范圍接口調(diào)用流程圖

7.4.2空間服務(wù)信息提取接口

7.4.2.1系統(tǒng)用戶(hù)從田長(zhǎng)巡管理系統(tǒng)提取空間服務(wù)信息時(shí)：

a）通過(guò)安全驗(yàn)證接口獲取令牌信息；

b）通過(guò)令牌信息訪問(wèn)空間服務(wù)信息提取接口，從田長(zhǎng)巡管理系統(tǒng)數(shù)據(jù)庫(kù)獲取所需數(shù)據(jù)，存儲(chǔ)至

系統(tǒng)用戶(hù)數(shù)據(jù)庫(kù)；根據(jù)獲取的空間服務(wù)地址，查看空間服務(wù)信息。

7.4.2.2空間服務(wù)信息提取接口調(diào)用流程見(jiàn)圖6,空間服務(wù)信息接口描述按附錄H執(zhí)行，空間服務(wù)信

息接口參數(shù)示例見(jiàn)附錄Io

7

T/GXAS811—2024

圖6空間服務(wù)信息提取接口調(diào)用流程圖

7.5視頻信息接口

7.5.1視頻信息推送接口

7.5.1.1系統(tǒng)用戶(hù)向田長(zhǎng)巡管理系統(tǒng)推送視頻信息時(shí)：

a）通過(guò)安全驗(yàn)證接口獲取令牌信息；

b）通過(guò)令牌信息訪問(wèn)視頻信息注冊(cè)接口，最后將本地舉證視頻流數(shù)據(jù)推送到田長(zhǎng)巡管理系統(tǒng)。

7.5.1.2視頻信息推送接口調(diào)用流程見(jiàn)圖7,視頻信息接口描述按附錄J執(zhí)行，視頻信息接口參數(shù)示

例見(jiàn)附錄K。

8

T/GXAS811—2024

圖7視頻信息推送接口調(diào)用流程圖

7.5.2視頻信息提取接口

7.5.2.1系統(tǒng)用戶(hù)從田長(zhǎng)巡管理系統(tǒng)提取舉證視頻流數(shù)據(jù)時(shí)：

a）通過(guò)安全驗(yàn)證接口獲取令牌信息；

b）通過(guò)令牌信息訪問(wèn)視頻信息提取接口，從山長(zhǎng)巡管理系統(tǒng)附件庫(kù)獲取所需視頻流地址等信息，

存儲(chǔ)至系統(tǒng)用戶(hù)數(shù)據(jù)庫(kù)；根據(jù)獲取的視頻地址，查看舉證視頻文件。

7.5.2.2視頻信息提取接口調(diào)用流程見(jiàn)圖8,視頻信息接口描述按附錄J執(zhí)行，視頻信息接口參數(shù)示

例見(jiàn)附錄K。

9

T/GXAS811—2024

圖8視頻信息提取接口調(diào)用流程圖

8開(kāi)發(fā)要求

8.1字符集

漢字編碼采用UTF-8字符集。

8.2網(wǎng)絡(luò)通信協(xié)議

支持TCP/IP協(xié)議和HTTPS協(xié)議。

8.3交換格式

采用JS0N格式進(jìn)行數(shù)據(jù)交換。

8.4消息機(jī)制

消息機(jī)制應(yīng)符合GB/T28168的規(guī)定。支持消息中間件，具備斷點(diǎn)續(xù)傳功能，用于消息的內(nèi)容存儲(chǔ)、

持久化處理及數(shù)據(jù)庫(kù)日志記錄。

8.5數(shù)據(jù)加密機(jī)制

數(shù)據(jù)加密機(jī)制應(yīng)符合GB/T32907的規(guī)定。密碼及數(shù)據(jù)傳輸按米用SM4分組密碼加密方式。

10

T/GXAS811—2024

附錄A

（規(guī)范性）

互聯(lián)互通接口描述

采用安全驗(yàn)證接口、結(jié)構(gòu)化數(shù)據(jù)接口、文件接口、空間服務(wù)信息接口、視頻信息接II等方式，通過(guò)

消息中間件進(jìn)行消息傳遞，實(shí)現(xiàn)信息共享和交換傳輸?；ヂ?lián)互通接口描述見(jiàn)表A.1。

表A.1互聯(lián)互通接口描述

序號(hào)接口類(lèi)型接口名稱(chēng)接1」標(biāo)識(shí)請(qǐng)求力式消息類(lèi)型

1安全驗(yàn)證接口安全驗(yàn)證接口loginpostjson

2結(jié)構(gòu)化數(shù)據(jù)推送接口rcport/savcOrllpdatepostjson

結(jié)構(gòu)化數(shù)據(jù)接口

3結(jié)構(gòu)化數(shù)據(jù)提取接口report/(id}getjson

4文件推送接口batchFjUploadpostmultipart

文件接口

5文件提取接口issueinfo/{id}getjson

6反地理編碼獲取農(nóng)田范圍接口gcocodcrpostjson

空間服務(wù)信息接口

7空間服務(wù)信息提取接口gislet/taskgetjson

8視頻信息推送接口batchFjUploadpostmultipart

視頻信息接口

9視頻信息提取接口issueinfo/{id}getjson

11

T/GXAS811—2024

附錄B

（規(guī)范性）

安全驗(yàn)證接口及消息描述

安全驗(yàn)證接口功能是為訪問(wèn)田長(zhǎng)巡管理系統(tǒng)應(yīng)用程序接口提供安全驗(yàn)證信息，防御未授權(quán)的用戶(hù)訪

問(wèn)衛(wèi)長(zhǎng)巡管理系統(tǒng)數(shù)據(jù)。用戶(hù)訪問(wèn)接口時(shí)，首先通過(guò)用戶(hù)名和密碼獲取head”token,然后將令牌添加

到請(qǐng)求頭中訪問(wèn)其他應(yīng)用程序接口獲取或推送數(shù)據(jù)，否則接口訪問(wèn)失敗。安全驗(yàn)證接口參數(shù)見(jiàn)表B.1、

B.2和B.3。

表B.1安全驗(yàn)證接口總體描述

項(xiàng)目描述

接口名稱(chēng)安全驗(yàn)證接口

接口標(biāo)識(shí)login

提供方田長(zhǎng)巡管理系統(tǒng)

接口地址hllps:〃IIl長(zhǎng)巡管理系統(tǒng)域名/mileslone-api/api/login

請(qǐng)求參數(shù)類(lèi)型application/json

請(qǐng)求方式POST

返回格式JSON

1.通過(guò)賬號(hào)、密碼登錄獲取token：

包含操作

2.獲取token令牌有效期。

表B.2安全驗(yàn)證接口請(qǐng)求參數(shù)

序號(hào)參數(shù)標(biāo)識(shí)參數(shù)名稱(chēng)參數(shù)類(lèi)型參數(shù)說(shuō)明必選/可選

1mobile賬號(hào)String登錄系統(tǒng)的賬號(hào)必選

2password密碼String登錄系統(tǒng)的密碼，通過(guò)SM4加密必選

用丁?加客密碼的動(dòng)態(tài)時(shí)間參數(shù)，加

3時(shí)間裁String必選

t密規(guī)則，SM4。前綴斗t）

4uuid設(shè)備唯一碼String用于確認(rèn)登錄方的唯一ID必選

表B.3安全驗(yàn)證接口響應(yīng)參數(shù)

序號(hào)參數(shù)標(biāo)識(shí)參數(shù)名稱(chēng)參數(shù)類(lèi)型參數(shù)說(shuō)明必選/可選

1code執(zhí)行狀態(tài)標(biāo)識(shí)Into:失敗）、1（成功）必選

2msg執(zhí)行狀態(tài)描述String執(zhí)行失敗、執(zhí)行成功可選

3timestamp當(dāng)前服務(wù)器時(shí)間戳String獲取系統(tǒng)服務(wù)時(shí)間必選

4token用戶(hù)token標(biāo)識(shí)String登錄后返回的token令牌必選

5expiretoken有效期String獲取當(dāng)前token有效期必選

12

T/GXAS811—2024

附錄C

（資料性）

安全驗(yàn)證接口參數(shù)示例

C.1安全驗(yàn)證接口請(qǐng)求參數(shù)示例

安全驗(yàn)證接口請(qǐng)求頭描述見(jiàn)表C.1；安全驗(yàn)證接口請(qǐng)求體描述見(jiàn)表C.2。

表C.1安全驗(yàn)證接口請(qǐng)求頭描述

字段值

packagecn.gov.gxzf.dnr.jcytzx.admin

version1.0.0

versionCodc240418181

srcAndroid

timestamp1713506822255

Content-Typeapplication/json;charset=UTF-8

Accept-Langtagezh-Hans-€N:q=l.0

User-Agen:Mozi1la/5.0(Linux;Android12j

Cache-Controlno-cache;on-store

表C.2安全驗(yàn)證接口請(qǐng)求體描述

項(xiàng)目?jī)?nèi)容

請(qǐng)求地址https:〃田長(zhǎng)巡管理系統(tǒng)域名/milestone-api/api/login

{

"password";"4F64FE529D827902486533325BDE1AA2”,

"mobile":,

示例

"uuid":"(16831900-e605-41bd-b274-a4C72577007f*,

*t*:*1713506822231*

)

C.2安全驗(yàn)證接口響應(yīng)參數(shù)示例

安全驗(yàn)證接口響應(yīng)頭描述見(jiàn)表C.3；安全驗(yàn)證接口響應(yīng)體描述見(jiàn)表C.4。

表C3安全驗(yàn)證接口響應(yīng)頭描述

字段值

Servernginx

DateFri,19Apr202406:05:04GCT

Content-Typeapplication/json

Transfer-Encodingchunked

Connectionkeep-alive

表C4安全驗(yàn)證接口響應(yīng)體描述

項(xiàng)目?jī)?nèi)容

(

"code”:0,

"msg":"登陸成功”，

“timestamp":"1713510856785。

"data":{

示例*token*:

vWQnFYThqchlpsDzZC2egPBk29Xe0sBvKm-xldwkegaVjImSyzbg26VRuxPy8wSa6AeZ0A”,

"expire”:864000

}

1

13

T/GXAS811—2024

附錄D

（規(guī)范性）

結(jié)構(gòu)化數(shù)據(jù)接口描述

D.1結(jié)構(gòu)化數(shù)據(jù)推送接口

結(jié)構(gòu)化數(shù)據(jù)推送接口功能是實(shí)現(xiàn)用戶(hù)向田長(zhǎng)巡管理系統(tǒng)推送并更新二維表等結(jié)構(gòu)化數(shù)據(jù)的能力。結(jié)

構(gòu)化數(shù)據(jù)推送接口參數(shù)見(jiàn)表D.l、D.2、D.3。

表D.1結(jié)構(gòu)化數(shù)據(jù)推送接口總體描述

項(xiàng)目描述

接口名稱(chēng)結(jié)構(gòu)化數(shù)據(jù)推送接口

接口標(biāo)識(shí)rcport/savcOrUpdatc

提供方田長(zhǎng)巡管理系統(tǒng)

接口地址https://田長(zhǎng)巡管理系統(tǒng)域名/milestone-api/api/report/saveOrUpdate

請(qǐng)求參數(shù)類(lèi)型application/json

請(qǐng)求方式POST

返回格式JSON

1.將token信息放入請(qǐng)求頭中的headertoken中：

也含操作

2.調(diào)用接口，推送并更新結(jié)構(gòu)化數(shù)據(jù)。

表D.2結(jié)構(gòu)化數(shù)據(jù)推送接口請(qǐng)求參數(shù)

序號(hào)參數(shù)標(biāo)識(shí)參數(shù)名稱(chēng)參數(shù)類(lèi)型參數(shù)說(shuō)明必選/可選

1id上報(bào):dString問(wèn)題圖斑唯一ID必選

2area圖斑面積double問(wèn)題圖斑面積必選

3creatorld創(chuàng)建者idSiring創(chuàng)建圖斑用戶(hù)ID必選

4prombleType圖斑類(lèi)型String圖斑類(lèi)型值必選

創(chuàng)建者圖斑的

創(chuàng)建者當(dāng)前圖斑的行政區(qū)必選

5regionId行政區(qū)String

6geometry圖斑矢量數(shù)據(jù)String圖斑矢量json數(shù)據(jù)必選

7

location圖現(xiàn)池理位置String圖斑地理位置描述必選

8locationRegionld圖斑的行政區(qū)String圖斑的行政區(qū)必選

9remark備注String附加信息選填

表D.3結(jié)構(gòu)化數(shù)據(jù)推送接口響應(yīng)參數(shù)

序號(hào)參數(shù)標(biāo)識(shí)參數(shù)名稱(chēng)參數(shù)類(lèi)型參數(shù)說(shuō)明必選/可選

1code執(zhí)行狀態(tài)標(biāo)識(shí)Int0（失?。?、1（成功）必選

2msg執(zhí)行狀態(tài)描述String執(zhí)行失敗、執(zhí)行成功可選

D.2結(jié)構(gòu)化數(shù)據(jù)提取接口

結(jié)構(gòu)化數(shù)據(jù)提取接口功能是實(shí)現(xiàn)系統(tǒng)用戶(hù)向田長(zhǎng)巡管理系統(tǒng)提取二維表等結(jié)構(gòu)化數(shù)據(jù)的能力。結(jié)構(gòu)

化數(shù)據(jù)提取接口參數(shù)見(jiàn)表D.4、D.5、D.6c

表D.4結(jié)構(gòu)化數(shù)據(jù)提取接口總體描述

項(xiàng)目描述

接口名稱(chēng)結(jié)構(gòu)化數(shù)據(jù)提取接口

接口標(biāo)識(shí)report/(id}

提供方田氏巡筑理系統(tǒng)

接口地址ht?tps://田長(zhǎng)巡管理系統(tǒng)域名/milcst。n。-api/api/rcport/{id}

請(qǐng)求參數(shù)類(lèi)型application/json

請(qǐng)求方式POST

返回格式JSON

1.將token信息放入請(qǐng)求頭中的headertoken中:

包含操作

2.調(diào)用接口，提取更新的結(jié)構(gòu)化數(shù)據(jù)。

14

T/GXAS811—2024

表D.5結(jié)構(gòu)化數(shù)據(jù)提取接口請(qǐng)求參數(shù)

序號(hào)參數(shù)標(biāo)識(shí)參數(shù)名稱(chēng)參數(shù)類(lèi)型參數(shù)說(shuō)明必選/可選

1id問(wèn)題圖斑idString問(wèn)題圖斑id必選

表D.6結(jié)構(gòu)化數(shù)據(jù)提取接口響應(yīng)參數(shù)

序片參數(shù)標(biāo)識(shí)參數(shù)名稱(chēng)參數(shù)類(lèi)型參數(shù)說(shuō)明必選/可選

1code執(zhí)行狀態(tài)標(biāo)識(shí)Int0（失?。?、1（成功）必選

2msg執(zhí)行狀態(tài)描述String執(zhí)行失敗、執(zhí)行成功可選

3id詳情信息String問(wèn)題圖斑唯TD必選

3creatorld創(chuàng)建者idString創(chuàng)建圖斑用戶(hù)ID必選

1prombleType圖斑類(lèi)型String圖斑類(lèi)型值必選

.5regionld創(chuàng)建者圖斑的行政區(qū)String創(chuàng)建者當(dāng)前圖斑的行政區(qū)必選

6geometry圖斑矢量數(shù)據(jù)String圖斑矢量json數(shù)據(jù)必選

7location圖斑地理位置String圖斑地理位置描述必選

SlocationRegionld圖斑的行政區(qū)String圖斑的行政區(qū)必選

9remark備注String附加信息選填

15

T/GXAS811—2024

附錄E

（資料性）

結(jié)構(gòu)化數(shù)據(jù)接口參數(shù)示例

E.1結(jié)構(gòu)化數(shù)據(jù)推送接口示例

E.1.1結(jié)構(gòu)化數(shù)據(jù)推送接口請(qǐng)求參數(shù)示例

結(jié)構(gòu)化數(shù)據(jù)推送請(qǐng)求頭描述見(jiàn)表E.1；結(jié)構(gòu)化數(shù)據(jù)推送請(qǐng)求體描述見(jiàn)表E.2。

表E.1結(jié)構(gòu)化數(shù)據(jù)推送請(qǐng)求頭描述

字段值

packagecn,gov.gxzf.dnr.jcytzx.admin

version1.0.0

versionCode240418181

sreAndroid

timestamp1713506822255

Content-Typea?plication/json;charset=UTF-8

Acccpt-Languagczh-Hans-CN：q=l.0

User-AgentWozilla/5.0(Linux;Android12)

CacheControlnocache;onstore

表E.2結(jié)構(gòu)化數(shù)據(jù)推送請(qǐng)求體描述

項(xiàng)目?jī)?nèi)容

請(qǐng)求地址https:〃田長(zhǎng)巡管理系統(tǒng)域名/mi1estone-api/api/report/saveOrUpdate

(

"id":"1739781221458491839”,

"area”:2166.91,

"crealorId":"1736950215897681922”,

*problemType*:"5”,

*regionld*:*450521111*.

*reRionTvDe*:4,

示例"geometry":"geojson格式數(shù)據(jù)”，

"patrolId":

“l(fā)ocation":"***”,

*locationRcgionId*:“450521111”,

“pushld”:null,

remark:,

"dataTypc”:0

)

E.1.2結(jié)構(gòu)化數(shù)據(jù)推送接口響應(yīng)參數(shù)示例

結(jié)構(gòu)化數(shù)據(jù)推送響應(yīng)頭描述見(jiàn)表E.3：結(jié)構(gòu)化數(shù)據(jù)推送響應(yīng)體描述見(jiàn)表E.4

表E.3結(jié)構(gòu)化數(shù)據(jù)推送響應(yīng)頭描述

字段值

Servernginx

DateFri,19Apr202406:05:04GMT

Content-Typeapplication/json

Transfer-Encodingchunked

Connectionkeep-alive

16

T/GXAS811—2024

表E.4結(jié)構(gòu)化數(shù)據(jù)推送響應(yīng)體描述

項(xiàng)目?jī)?nèi)容

{

"code”:0?

"msg":"操作成功”,

示例

"tinestamp”:*1713510856785*,

"data":null

}

E.2結(jié)構(gòu)化數(shù)據(jù)提取接口示例

E.2.1結(jié)構(gòu)化數(shù)據(jù)提取接口請(qǐng)求參數(shù)示例

結(jié)構(gòu)化數(shù)據(jù)提取請(qǐng)求頭描述見(jiàn)表E.5；結(jié)構(gòu)化數(shù)據(jù)提取請(qǐng)求體描述見(jiàn)表E.6。

表E.5結(jié)構(gòu)化數(shù)據(jù)提取請(qǐng)求頭描述

字段值

packagecn.gov.gxzf.dnr.jcytzx.admin

version1.0.0

versionCode240418181

srcAndroid

timestamp1713506822255

Content-Typeapplication/json;charset=UTF-8

Accept-Langtagezh-Hans-€N;q=l.0

User-Agen:Mozi1la/5.0(Linux;Android12j

Cache-Controlno-cache;on-store

表E.6結(jié)構(gòu)化數(shù)據(jù)提取請(qǐng)求體描述

項(xiàng)目?jī)?nèi)容

請(qǐng)求地址