（規(guī)范性）

共享接口規(guī)范登錄接口說(shuō)明：賬號(hào)密碼登錄接口形式：URL：https://SERVER:PORT/Share/UserLoginHTTP方法：POST輸入?yún)?shù)見表A.1。登錄接口輸入?yún)?shù)參數(shù)名是否必填說(shuō)明username是賬號(hào)password是密碼entryType是入口類型:1-賬號(hào)密碼登錄輸入?yún)?shù)JSON格式{"username":"root","password":"123456","entryType":1,}輸出參數(shù)見表A.2。輸出參數(shù)字段名說(shuō)明ret狀態(tài)碼:200-成功，其他-失敗msg返回信息data返回?cái)?shù)據(jù)access_token認(rèn)證tokenexpire_attoken到期時(shí)間戳輸出參數(shù)JSON格式{"ret":200,"data":{"access_token":"eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJjZmRjNDUwMyIsImF1ZCI6InVzZXIiLCJzdWIiOiJsM2hPb2lYeTY0dDciLCJ1aWQiOjYsImlhdCI6MTc1NzU1MjY1NywiZXhwIjoxNzU4MTU3NDU3fQ.OY3TP0HVy6QsBLm4LVShIV1K-_6fhcHGQWiFBpwTs7w","expire_at":1758157457},"msg":""}許可采區(qū)基礎(chǔ)信息及范圍共享許可采區(qū)列表功能說(shuō)明：獲取該系統(tǒng)下所有許可采區(qū)的基礎(chǔ)信息包含許可編號(hào)省市縣代碼，可根據(jù)地區(qū)編碼進(jìn)行查詢接口形式：URL：https://SERVER:PORT/Share/GetSysLicsAllHTTP方法：POST輸入?yún)?shù)見表A.3。輸入?yún)?shù)參數(shù)名是否必填說(shuō)明access_token是系統(tǒng)認(rèn)證tokenadcode否省市縣地區(qū)搜索條件如：[410000,410800,410883]或[410000]certName否許可采區(qū)名稱模糊搜索輸入?yún)?shù)JSON格式{"access_token":"eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9*******","adcode":[410000],"certName":"采區(qū)"}輸出參數(shù)見表A.4。輸出參數(shù)字段名說(shuō)明ret狀態(tài)碼:200-成功，其他-失敗msg返回信息data返回?cái)?shù)據(jù)province省provinceCode省地區(qū)代碼city市cityCode市地區(qū)代碼district區(qū)/縣districtCode區(qū)/縣代碼certNum許可證編號(hào)certName許可采區(qū)名稱輸出參數(shù)JSON格式{ "ret":200, "data":[{"province":"**省","provinceCode":410000,"city":"**市","cityCode":410800,"district":"**市","districtCode":410883,"certNum":"*****-0003","certName":"****采砂區(qū)",},{"province":"**省","provinceCode":410000,"city":"**市","cityCode":410800,"district":"**","districtCode":410825,"certNum":"*****-0001","certName":"**采砂區(qū)",}], "msg":""}許可采區(qū)基礎(chǔ)信息及可采區(qū)范圍功能說(shuō)明：通過(guò)許可證編號(hào)獲取對(duì)應(yīng)許可采區(qū)的詳細(xì)信息接口形式：URL：https://SERVER:PORT/Share/GetLicsInfoByCertNumHTTP方法：POST輸入?yún)?shù)見表A.5。輸入?yún)?shù)參數(shù)名是否必填說(shuō)明access_token是系統(tǒng)認(rèn)證tokencertNum是許可證編號(hào)輸入?yún)?shù)JSON格式{"access_token":"eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9*******","certNum":"*****-0021"}輸出參數(shù)見表A.6。輸出參數(shù)字段名說(shuō)明ret狀態(tài)碼:200-成功，其他-失敗msg返回信息data返回?cái)?shù)據(jù)id許可證主鍵IDprovince省provinceCode省編碼city市cityCode市編碼district區(qū)/縣districtCode區(qū)/縣編碼licence許可文件編號(hào)certNum許可證編號(hào)certName砂場(chǎng)名稱sc_company采區(qū)企業(yè)sc_address采砂單位地址sc_user單位法人pic許可證掃描件地址starttime許可有效期開始時(shí)間endtime許可有效期結(jié)束時(shí)間authority發(fā)證機(jī)關(guān)issuetime發(fā)證時(shí)間total采砂許可批復(fù)總量rivDes所屬河流rivDesCode所屬河流編碼sc_mobile單位法人電話min_m85最小控制高程max_m85最大控制高程op_location采區(qū)所在地(鄉(xiāng)村(鎮(zhèn))村)pdopoex禁采期intaking_type_code作業(yè)方式codeintaking_type作業(yè)方式bdy_polygon可采范圍數(shù)據(jù)issu_auth_code發(fā)證機(jī)關(guān)代碼handl_type_code辦理性質(zhì)代碼001-新申請(qǐng)009存量fir_issu_date首次發(fā)證日期owner_code采砂單位統(tǒng)一社會(huì)信用代碼或個(gè)人身份證號(hào)owner_code_type采砂單位代碼類別lin_phone采砂單位固定電話cell_phone采砂單位手機(jī)email采砂單位郵箱ind_class行業(yè)類別ind_class_code行業(yè)類別代碼applicant申請(qǐng)人appl_code申請(qǐng)人代碼appl_code_type申請(qǐng)人類型apply_date申請(qǐng)時(shí)間appr_auth審查機(jī)關(guān)approv_date審批日期appr_no采砂規(guī)劃及年度實(shí)施方案等批復(fù)文件號(hào)appr_name采砂規(guī)劃及年度實(shí)施方案等批復(fù)名稱示例2：輸出參數(shù)JSON格式{

"ret":

200,

"data":

{

"id":

327,

"province":

"**省",

"provinceCode":

610000,

"city":

"**市",

"cityCode":

610500,

"district":

"**區(qū)",

"districtCode":

610502,

"licence":

"*許可決***45號(hào)",

"certNum":

"****-0021",

"certName":

"***采砂區(qū)",

"sc_company":

"***有限公司",

"sc_address":

"**省**市**區(qū)**路*號(hào)*室",

"sc_user":

"**",

"pic":

"****-0021.jpg",

"starttime":

"2025-03-14

00:00:00",

"endtime":

"2025-12-24

23:59:59",

"authority":

"****",

"issuetime":

"2025-03-14

00:00:00",

"total":

320000,

"rivDes":

"*河",

"rivDesCode":

"ADC00006",

"sc_mobile":

null,

"min_m85":

331.33,

"max_m85":

332.47,

"op_location":

"**區(qū)**鎮(zhèn)**村",

"pdopoex":

"****部門發(fā)布的禁采時(shí)段。",

"intaking_type_code":

"1",

"intaking_type":

"水采",

"bdy_polygon":

[

{

"lat":

34.581888,

"lng":

109.712521

}...,

],

"issu_auth_code":

"12100000415804342T",

"handl_type_code":

"001",

"fir_issu_date":

"2025-03-14

00:00:00",

"ori_cert_num":

"",

"ori_issu_date":

null,

"owner_code":

"****",

"owner_code_type":

"001",

"lin_phone":

"*********",

"cell_phone":

"********",

"email":

"",

"ind_class":

null,

"ind_class_code":

"656",

"applicant":

"****有限公司",

"appl_code":

"****",

"appl_code_type":

"001",

"apply_date":

"2025-03-10

00:00:00",

"appr_auth":

"****",

"approv_date":

"2025-03-14

00:00:00",

"appr_no":

"水河湖**號(hào)、河湖**號(hào)",

"appr_name":

"水利部關(guān)于****的批復(fù)、 黃委河湖局關(guān)于****的批復(fù)",

},

"msg":

"" }采砂機(jī)具空間數(shù)據(jù)共享功能說(shuō)明：根據(jù)許可編號(hào)來(lái)獲取該砂場(chǎng)所有的采砂機(jī)具信息接口形式：URL：https://SERVER:PORT/Share/GetUtensilByCertNumHTTP方法：POST輸入?yún)?shù)見表A.7。輸入?yún)?shù)參數(shù)名是否必填說(shuō)明access_token是系統(tǒng)認(rèn)證tokencertNum是許可證編號(hào)示例1：輸入?yún)?shù)JSON格式{"access_token":"eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9*******","certNum":"*****-0021"}輸出參數(shù)見表A.8。輸出參數(shù)字段名說(shuō)明ret狀態(tài)碼:200-成功，其他-失敗msg返回信息data返回?cái)?shù)據(jù)name機(jī)具名稱type機(jī)具類型：0-采砂船，1-挖掘機(jī)、2-裝載車、3-其他機(jī)具coordinate空間數(shù)據(jù)經(jīng)緯度坐標(biāo)，高程數(shù)據(jù)name機(jī)具名稱示例2：輸出參數(shù)JSON格式{ "ret":200, "data":[{"name":"***采砂船"，"type":0,"coordinate":[112.90376,35.18023682,34.3]},{"name":"**挖掘機(jī)"，"type":1,"coordinate":[112.90376,35.18023682,35.5] }], "msg":""}報(bào)警記錄公開處置信息共享功能說(shuō)明：獲取系統(tǒng)內(nèi)報(bào)警記錄公開處置信息，支持根據(jù)許可編號(hào)、時(shí)間范圍等條件進(jìn)行篩選接口形式：URL：https://SERVER:PORT/Share/GetLawEnforcementPageHTTP方法：POST輸入?yún)?shù)見表A.9。輸入?yún)?shù)參數(shù)名是否必填說(shuō)明access_token是系統(tǒng)認(rèn)證tokenpage是當(dāng)前第幾頁(yè)certNum否許可證編號(hào)，支持模糊匹配times否時(shí)間范圍查詢adcode否省市縣地區(qū)搜索條件如：[410000,410800,410883]或[410000]示例1：輸入?yún)?shù)JSON格式{"access_token":"eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9*******","page":1,"certNum":"****-0021","times":["2020-01-0100:00:00","2025-12-3123:59:59"],"adcode":[410000],}輸出參數(shù)見表A.10。輸出參數(shù)字段名說(shuō)明ret狀態(tài)碼:200-成功，其他-失敗msg返回信息list返回?cái)?shù)據(jù)events_ids關(guān)聯(lián)事件id數(shù)組province省provinceCode省代碼city 市cityCode市代碼district區(qū)/縣districtCode區(qū)/縣代碼certNum所屬砂場(chǎng)許可證編號(hào)certName所屬砂場(chǎng)名稱pic違法事件截圖occur_time事件發(fā)生時(shí)間handle_describe處理內(nèi)容describe簡(jiǎn)要說(shuō)明action1_info違法類型，1：盜采，2、盜運(yùn)，3、設(shè)備破壞，4、其他類型total總條數(shù)示例2：輸出參數(shù)JSON格式{"ret":200,"data":{"list":[{"id":89,"events_ids":"454482","province":"**省","provinceCode":410000,"city":"**市","cityCode":410800,"district":"**區(qū)","districtCode":410883,"certNum":"*****-0031","certName":"****采砂區(qū)","pic":"http://***.******.cn:****/***/bd33b15a-47c1-4881-8266-d9aec685b008.jpg","occur_time":"2024-09-0811:34:48","handle_describe":"發(fā)生盜采事件","describe":"上報(bào)至上級(jí)機(jī)關(guān)","action1_info":"1",}],"total":1}"msg":""}視頻共享許可采區(qū)視頻監(jiān)控基礎(chǔ)數(shù)據(jù)功能說(shuō)明：通過(guò)許可編號(hào)獲取該許可采區(qū)下視頻設(shè)備列表、類型及媒體播放相關(guān)參數(shù)接口形式：URL：https://SERVER:PORT/Share/GetLicsCamListByCertNumHTTP方法：POST輸入?yún)?shù)見表A.11。輸入?yún)?shù)參數(shù)名是否必填說(shuō)明access_token是系統(tǒng)認(rèn)證tokencertNum是許可證編號(hào)示例1：輸入?yún)?shù)JSON格式{"access_token":"eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9*******","certNum":"****-0021"}輸出參數(shù)見表A.12。輸出參數(shù)字段名說(shuō)明ret狀態(tài)碼:200-成功，其他-失敗msg返回信息dev_id設(shè)備IDdev_name設(shè)備名稱dev_type設(shè)備類型：1、不可PTZ控制的攝像機(jī)，0、可PTZ控制的攝像機(jī)gpsx設(shè)備所處經(jīng)度gpsy設(shè)備所處緯度height設(shè)備所處高度streamSession設(shè)備取流授權(quán)碼示例2：輸出參數(shù)JSON格式{ "ret":200, "data":[{"dev_id":1, "dev_name":"****","dev_type":1,"gpsx":35.650012,"gpsy":"110.650012","height":"220","streamSession":"****-****-***-***-********", },], "msg":""}實(shí)時(shí)視頻取流功能說(shuō)明：根據(jù)設(shè)備ID（dev_id）獲取取流地址接口形式：URL：https://SERVER:PORT/Share/GetStreamUrlByDevIdHTTP方法：POST輸入?yún)?shù)見表A.13。輸入?yún)?shù)參數(shù)名是否必填說(shuō)明access_token是系統(tǒng)認(rèn)證tokendev_id是設(shè)備ID示例1：輸入?yún)?shù)JSON格式{"access_token":"eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9*******","dev_id":1}輸出參數(shù)見表A.14。輸出參數(shù)字段名說(shuō)明ret狀態(tài)碼:200-成功，其他-失敗msg返回信息flvUrlflv格式取流地址rtmpUrlrtmp格式取流地址示例2：輸出參數(shù)JSON格式{"ret":200,"data":{"flvUrl":"http://***.*******.cn:****/live/***.flv?session=*****","rtmpUrl":"rtmp://***.*******.cn:****/live/***?session=*****"},"msg":""}歷史視頻取流功能說(shuō)明：根據(jù)設(shè)備ID（dev_id）、開始的時(shí)間日期來(lái)取流。接口形式：URL：https://SERVER:PORT/Share/GetCamBackUrlByDevIdHTTP方法：POST輸入?yún)?shù)見表A.15。輸入?yún)?shù)參數(shù)名是否必填說(shuō)明access_token是系統(tǒng)認(rèn)證tokendev_id是設(shè)備IDstartTime是回放開始時(shí)間示例1：輸入?yún)?shù)JSON格式{"access_token":"eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9*******","dev_id":1,"startTime":"2025-06-0113:25:20",}輸出參數(shù)見表A.16。輸出參數(shù)字段名說(shuō)明ret狀態(tài)碼:200-成功，其他-失敗msg返回信息flvUrlflv格式回放地址示例2：輸出參數(shù)JSON格式{"ret":200,"data":{"flvUrl":"http://***.*******.cn:****/live/***.flv?session=*****"},"msg":""}PTZ控制功能說(shuō)明：根據(jù)設(shè)備ID（dev_id）發(fā)出PTZ控制指令。接口形