物联网平台开发接口http/mqtt，支持部标808/1078协议对接

云平台API接口

HTTP接口

基础接口

用户登录

设备与分组数据

位置接口

GPS缓存数据

设备最后位置

GPS轨迹数据

停留点数据

统计报表

上传文件列表

音视频接口

设备通道列表

设备通道状态

设备通道地址

设备（808/1078）

设备资源请求

图像录像检索

图像上传

录像上传

设备资源请求任务列表

设备（CFIOT）

通道截图

通道录像

Mqtt接口

实时位置

实时报警

设备事件

设备（CFIOT）

文件上传事件

图片/视频采集事件

设备（808/1078）

文件上传事件

HTTP接口

基础接口

用户登录

请求：

http://api.uddgps.com/UserLogin?username=4gtest&password=123456

Get参数	含义
username	用户名
password	密码

响应：

{

"Result": "ok",

"Message": "UserLoginSuccess",

"SessionId": "5665509C186DED95ED6D89EE1939D83F",

"AliasBool": false

}

Json字段	含义
Result	状态
Message	状态码
SessionId	会话ID
AliasBool

设备与分组数据

请求：

http://api.uddgps.com/LoadDeviceAndGroupFromCache?selaccount=4gtest&SessionId=FDF11A0009516124B2004DBD92ECC506&getgps=no&norequest=yes

Get参数	含义
SessionId	会话ID
selaccount	账号
getgps	yes:返回gps数据 no:不返回gps数据
norequest	yes:不下发立即定位指令 空或无此参数：下发立即定位指令

响应：

{

"Result": "ok",

"Message": "",

"Username": "4gtest",

"DeviceInfoArray": [{

"Id": 230,

"Username": "4gtest",

"Classid": 0,

"DeviceNo": "869756049340471",

"UWBMAC": "",

"DeviceName": "CFIOT_EC20",

"DeviceIcon": "arrow",

"Remark": "",

"Pilot_name": "",

"Pilot_phone": "",

"Terminal_phone": "",

"Correctionvalue": 8,

"Timezonevalue": 8,

"Area": "",

"Endtime": "2020-03-19 00:00:00",

"Fencename": "",

"FenceLongitude": 0,

"FenceLatitude": 0,

"FenceLongitude1": 0,

"FenceLatitude1": 0,

"FenceLongitude2": 0,

"FenceLatitude2": 0,

"Fenceradius": 200,

"Fenceallow": 0,

"ProtocolType": "tianqin_osk",

"ManufacturerMark": "",

"ShareMark": false,

"App_Healthy_parameter": "100|60|140|130|100|90|90|85|65|60",

"Filter_lbs_wifi": "1|0",

"BatteryMaxVoltage": 0,

"BatteryMinVoltage": 0,

"Follow": 1

}, {

"Id": 231,

"Username": "4gtest",

"Classid": 0,

"DeviceNo": "865324039996820",

"UWBMAC": "",

"DeviceName": "Neoway_N720",

"DeviceIcon": "lx_b",

"Remark": "",

"Pilot_name": "",

"Pilot_phone": "",

"Terminal_phone": "",

"Correctionvalue": 8,

"Timezonevalue": 8,

"Area": "",

"Endtime": "2039-03-20 00:00:00",

"Fencename": "",

"FenceLongitude": 0,

"FenceLatitude": 0,

"FenceLongitude1": 0,

"FenceLatitude1": 0,

"FenceLongitude2": 117.2428,

"FenceLatitude2": 31.84674,

"Fenceradius": 56982,

"Fenceallow": 1,

"ProtocolType": "gsms",

"ManufacturerMark": "",

"ShareMark": false,

"App_Healthy_parameter": "100|60|140|130|100|90|90|85|65|60",

"Filter_lbs_wifi": "1|1",

"BatteryMaxVoltage": 0,

"BatteryMinVoltage": 0,

"Follow": 1

}, {

"Id": 331,

"Username": "4gtest",

"Classid": 0,

"DeviceNo": "9170951424",

"UWBMAC": "",

"DeviceName": "9170951424",

"DeviceIcon": "arrow",

"Remark": "",

"Pilot_name": "",

"Pilot_phone": "",

"Terminal_phone": "",

"Correctionvalue": 8,

"Timezonevalue": 8,

"Area": "",

"Endtime": "2020-08-16 00:00:00",

"Fencename": "",

"FenceLongitude": 0,

"FenceLatitude": 0,

"FenceLongitude1": 0,

"FenceLatitude1": 0,

"FenceLongitude2": 0,

"FenceLatitude2": 0,

"Fenceradius": 200,

"Fenceallow": 0,

"ProtocolType": "tianqin_osk",

"ManufacturerMark": "",

"ShareMark": false,

"App_Healthy_parameter": "100|60|140|130|100|90|90|85|65|60",

"Filter_lbs_wifi": "1|0",

"BatteryMaxVoltage": 0,

"BatteryMinVoltage": 0,

"Follow": 0

}],

"ClassInfoaArray": [{

"Id": -2,

"Username": "4gtest",

"Classname": "Share Group"

}, {

"Id": 147,

"Username": "4gtest",

"Classname": "Default Group"

}],

"GpsDatakey": {}

}

Json字段	含义
Result	状态
Message	消息名
Username	账号名
DeviceInfoArray	设备列表，设备信息结构见表1
ClassInfoaArray	分组列表，分组信息结构见表2
GpsDatakey	设备的gps数据，设备号作为KEY,VALYE值结构见GPS数据章节中的表1

表1

Json字段	含义
Id	设备数据库ID号
Username	账号名
Classid	分组ID
DeviceNo	设备号
UWBMAC	UWB标签MAC地址
DeviceName	设备名称
DeviceIcon	设备图标
Remark	备注信息
Pilot_name	联系人
Pilot_phone	联系电话
Terminal_phone	设备sim卡号
Correctionvalue	设备时间纠偏值
Timezonevalue	设备所在地时区
Area	设备地区编码
Endtime	设备服务到期时间
Fencename	设备圆形围栏名称
FenceLongitude	围栏经度
FenceLatitude	围栏纬度
FenceLongitude1	围栏经度（google坐标）
FenceLatitude1	围栏纬度（google坐标）
FenceLongitude2	围栏经度（百度坐标）
FenceLatitude2	围栏纬度（百度坐标）
Fenceradius	围栏半径
Fenceallow	0：禁用设备围栏 1：启用设备围栏
ProtocolType	设备协议类型
ManufacturerMark
ShareMark	设备是否共享
App_Healthy_parameter	健康参数
Filter_lbs_wifi	基站/wifi过滤
BatteryMaxVoltage	电池充满电压
BatteryMinVoltage	电池工作最低电压
Follow	0：非关注 1：关注设备

表2

Json字段	含义
Id	分组数据库ID号
Username	账号名
Classname	分组名称

位置接口

GPS缓存数据

请求：

http://api.uddgps.com/RequestGpsData?funcname=&FirstRequest=false&selaccount=4gtest&SessionId=5665509C186DED95ED6D89EE1939D83F&_=1577761203897

Get参数	含义
funcname	回掉函数名，可选
FirstRequest	true:返回全部设备缓存位置 False:返回在线设备缓存位置
SessionId	会话ID
selaccount	账号

响应：

{

"Result": "ok",

"Message": "",

"Username": "4gtest",

"GpsDatakey": {

"862607059076223": {

"DeviceNo": "862607059076223",

"Ltype": 0,

"Online": 1,

"Longitude": 117.23088,

"Latitude": 31.84247,

"Longitude1": 117.23636,

"Latitude1": 31.84046,

"Longitude2": 117.24279,

"Latitude2": 31.84682,

"N_S": "N",

"E_W": "E",

"Speed": 0,

"Direction": 250,

"Mode": "A",

"DateTime": "2021-06-25T01:56:20Z",

"DateTime1": "2021-06-25 01:56:20",

"ReceiveTime": "2021-06-30T22:40:51.135536549+08:00",

"ReceiveTime1": "2021-06-30 22:40:51",

"Battery": -1,

"BatteryVoltage": 0,

"Oilquantity": -1,

"Acc": 0,

"Address": "",

"AddressUpdatetime": "0001-01-01T00:00:00Z",

"StayTime": 0,

"NextBootTime": "",

"Shefangchefang": 0,

"MainPower": 0,

"LbsData": null,

"WifiData": [],

"CustomData": ""

}

},

"AlarmDatakey": {}

}

Json字段	含义
Result	状态
Message	消息名
Username	账号名
GpsDatakey	设备的gps数据，设备号作为KEY,VALYE值结构见表1
AlarmDatakey	设备的报警数据，设备号作为KEY,VALYE值结构见表2

表1

Json字段	含义
DeviceNo	设备号
Ltype	基站定位标识，0：gps，1：lbs，2：wifi
Online	在线离线状态，0：离线，1：在线
Longitude	Gps经度
Latitude	Gps纬度
Longitude1	Gps经度（google）
Latitude1	Gps纬度（google）
Longitude2	Gps经度（baidu）
Latitude2	Gps纬度（baidu）
N_S	S:南纬,N:北纬
E_W	E:东经，W：西经
Speed	速度
Direction	方向
Mode	定位状态，A:GPS有效，V：GPS无效
DateTime1	GPS时间
ReceiveTime1	信号时间
Battery	剩余电量
Acc	ACC状态
StayTime	停留时间
LbsData	基站数据
WifiData	Wifi数据

表2

Json字段	含义
DeviceNo	设备号
DeviceName	设备名称
AlarmType	报警类型，定义见表3
Longitude	Gps经度
Latitude	Gps纬度
Longitude1	Gps经度（google）
Latitude1	Gps纬度（google）
Longitude2	Gps经度（baidu）
Latitude2	Gps纬度（baidu）
Speed	速度
Direction	方向
Mode	定位状态，A:GPS有效，V：GPS无效
GpsTime1	定位时间
AlarmTime1	报警时间
OfflineTimeout	离线超时时间
AlertInfo	报警提示
FileName	图片或视频文件路径

表3

报警类型	报警描述
1	震动报警
2	断电报警
3	低电报警
4	求救报警
5	进围栏报警
6	出围栏报警
7	超速报警
8	位移报警
9	拆除报警
10	离线报警
11	指令收到提醒报警

设备最后位置

请求：

http://api.uddgps.com/GetLastGpsPoint?deviceno=84381128040&SessionId=EA110DD89EE11D4D12DD7764A32C4FB8

Get参数	含义
deviceno	设备编号
SessionId	会话ID

响应：

{

"Result": "ok",

"Message": "",

"DeviceNo": "84381128040",

"DeviceInfo": {

"Id": 0,

"Username": "",

"Classid": 0,

"DeviceNo": "",

"UWBMAC": "",

"DeviceName": "",

"DeviceIcon": "",

"Remark": "",

"Pilot_name": "",

"Pilot_phone": "",

"Terminal_phone": "",

"Correctionvalue": 0,

"Timezonevalue": 0,

"Area": "",

"Endtime": null,

"Fencename": "",

"FenceLongitude": 0,

"FenceLatitude": 0,

"FenceLongitude1": 0,

"FenceLatitude1": 0,

"FenceLongitude2": 0,

"FenceLatitude2": 0,

"Fenceradius": 0,

"Fenceallow": 0,

"ProtocolType": "",

"ManufacturerMark": "",

"ShareMark": false,

"App_Healthy_parameter": "",

"Filter_lbs_wifi": "",

"BatteryMaxVoltage": 0,

"BatteryMinVoltage": 0,

"Follow": 0

},

"GpsDatakey": {

"84381128040": {

"DeviceNo": "",

"Ltype": 0,

"Online": 0,

"Longitude": 0,

"Latitude": 0,

"Longitude1": 0,

"Latitude1": 0,

"Longitude2": 0,

"Latitude2": 0,

"N_S": "",

"E_W": "",

"Speed": 0,

"Direction": 0,

"Mode": "",

"DateTime": "0001-01-01T00:00:00Z",

"DateTime1": "",

"ReceiveTime": "0001-01-01T00:00:00Z",

"ReceiveTime1": "",

"Battery": -1,

"BatteryVoltage": 0,

"Oilquantity": 0,

"Acc": 0,

"Address": "",

"AddressUpdatetime": "0001-01-01T00:00:00Z",

"StayTime": 0,

"NextBootTime": "",

"Shefangchefang": 0,

"MainPower": 0,

"LbsData": null,

"WifiData": [],

"CustomData": ""

}

}

}

Json字段	含义
Result	状态
Message	消息名
DeviceNo	设备编号
DeviceInfo	设备信息结构见设备与分组数据章节中表一
GpsDatakey	位置结构见gps缓存数据章节中表1

GPS轨迹数据

请求：

http://api.uddgps.com/RequestTrack1?deviceno=84390730103&startdate=2021-06-30%2018:24:48&enddate=2021-06-30%2023:59:59&SessionId=0CD901F1C2DAE4807FF56A59A414EB3A

Get参数	含义
deviceno	设备编号
startdate	开始时间
enddate	结束时间
SessionId	会话ID

响应：

{

"Result": "ok",

"Message": "",

"Deviceno": "84390730103",

"Startdate": "2021-06-30 18:23:48",

"Enddate": "2021-06-30 18:25:59",

"Playindex": 0,

"GpsDataArray": [

["2021-06-30 18:23:54", "117.29784", "32.53654", "117.30343", "32.53448", "117.31005", "32.54016", "67", "102", "-1", "0", "0", ""],

["2021-06-30 18:24:24", "117.30411", "32.53563", "117.30971", "32.53359", "117.31634", "32.53927", "75", "96", "-1", "0", "0", ""],

["2021-06-30 18:24:54", "117.31087", "32.53527", "117.3165", "32.53325", "117.32309", "32.53903", "76", "93", "-1", "0", "0", ""],

["2021-06-30 18:25:24", "117.31657", "32.53484", "117.3222", "32.53281", "117.32879", "32.5386", "52", "98", "-1", "0", "0", ""],

["2021-06-30 18:25:54", "117.31862", "32.53456", "117.32425", "32.53253", "117.33084", "32.53832", "24", "97", "-1", "0", "0", ""]

]

}

Json字段	含义
Result	状态
Message	消息名
Startdate	开始时间
Enddate	结束时间
Playindex
GpsDataArray	轨迹点列表，点结构见表一

表一

索引	描述
0	位置时间
1	Gps经度
2	Gps纬度
3	Gps经度（google）
4	Gps纬度（google）
5	Gps经度（baidu）
6	Gps纬度（baidu）
7	速度
8	方向
9	电量
10	Acc状态
11	基站定位标志
12	自定义数据

停留点数据

请求：

http://api.uddgps.com/QueryStopPoint?funcname=QueryStopPointResult&deviceno=84390730103&startdate=2021-06-30%2016:23:48&enddate=2021-06-30%2020:25:59&SessionId=0CD901F1C2DAE4807FF56A59A414EB3A

Get参数	含义
deviceno	设备编号
startdate	开始时间
enddate	结束时间
SessionId	会话ID

响应：

{

"Result": "ok",

"Message": "",

"SelDeviceNo": "84390730103",

"Startdate": "2021-06-30 16:23:48",

"Enddate": "2021-06-30 20:25:59",

"Data": [{

"DeviceNo": "84390730103",

"Start_Longitude": 117.07687,

"Start_Latitude": 32.64736,

"Start_Longitude1": 117.08252,

"Start_Latitude1": 32.64547,

"Start_Longitude2": 117.08911,

"Start_Latitude2": 32.65125,

"Radius": 122.16,

"StartTime": "2021-06-30 15:03:32",

"StopTime": "2021-06-30 16:44:39",

"ResidenceTime": 6067,

"StayPointsAddress": null

}, {

"DeviceNo": "84390730103",

"Start_Longitude": 117.07618,

"Start_Latitude": 32.64855,

"Start_Longitude1": 117.08183,

"Start_Latitude1": 32.64666,

"Start_Longitude2": 117.08841,

"Start_Latitude2": 32.65244,

"Radius": 169.52,

"StartTime": "2021-06-30 16:44:49",

"StopTime": "2021-06-30 17:45:22",

"ResidenceTime": 3633,

"StayPointsAddress": null

}, {

"DeviceNo": "84390730103",

"Start_Longitude": 117.79919,

"Start_Latitude": 31.76009,

"Start_Longitude1": 117.80466,

"Start_Latitude1": 31.75806,

"Start_Longitude2": 117.81121,

"Start_Latitude2": 31.76383,

"Radius": 135.84,

"StartTime": "2021-06-30 19:49:46",

"StopTime": "2021-06-30 20:28:13",

"ResidenceTime": 2307,

"StayPointsAddress": null

}]

}

Json字段	含义
Result	状态
Message	消息名
SelDeviceNo	设备编号
Startdate	开始时间
Enddate	结束时间
Data	停留点列表，点结构见表一

表1

Json字段	含义
DeviceNo	设备号
StartTime	停留开始时间
StopTime	停留结束时间
Start_Longitude	停留点经度
Start_Latitude	停留点纬度
Start_Longitude1	停留点经度（google）
Start_Latitude1	停留点纬度（google）
Start_Longitude2	停留点经度（baidu）
Start_Latitude2	停留点纬度（baidu）
Radius	停留点半径
ResidenceTime	停留时间，秒
StayPointsAddress	停留点地址，客户端请求

统计报表

上传文件列表

请求：

http://api.uddgps.com/QueryFileList?DeviceNo=1277116530&Date=2022-04-14&Start=5&Count=100&SessionId=0FA86575978808CEF19A4B8638212D4E&_=1649883241131

Get参数	含义
DeviceNo	设备号
Date	日期
Start	列表开始位置
Count	列表数据大小
SessionId	会话ID

响应：

{

"Result": "ok",

"Message": "",

"SelDeviceNo": "1277116530",

"Date": "2022-04-14",

"Start": 0,

"Data": ["{\"FilePath\":\"file/Media/20220414/1277116530_1_1009.jpg\",\"FileSize\":14430,\"UploadTime\":\"2022-04-14 05:30:49\"}", "{\"FilePath\":\"file/Media/20220414/1277116530_1_1008.jpg\",\"FileSize\":14426,\"UploadTime\":\"2022-04-14 05:30:48\"}", "{\"FilePath\":\"file/Media/20220414/1277116530_1_1007.jpg\",\"FileSize\":14402,\"UploadTime\":\"2022-04-14 05:30:47\"}", "{\"FilePath\":\"file/Media/20220414/1277116530_1_1006.jpg\",\"FileSize\":14378,\"UploadTime\":\"2022-04-14 05:30:46\"}", "{\"FilePath\":\"file/Media/20220414/1277116530_1_1005.jpg\",\"FileSize\":14398,\"UploadTime\":\"2022-04-14 05:30:45\"}"]

}

Json字段	含义
Result	状态
Message	消息名
SelDeviceNo	设备号
Date	日期
Start	列表开始位置
Data	列表数据

音视频接口

设备通道列表

请求：

http://api.uddgps.com/getUserChannelData?selaccount=4gtest&SessionId=9D2B721FE7BBCC2E25FAA6EAB7D82320

Get参数	含义
SessionId	会话ID
selaccount	账号

响应：

{

"Result": "ok",

"Message": "",

"ChannelData": {

"864977047764448": "[{\"CN\":\"48\",\"HasAudio\":false,\"IP\":\"192.168.100.48\",\"SMK\":\"stream0_1_640_480\",\"SN\":\"a7a5c97704e8d558\",\"ShURL\":\"\",\"State\":false},{\"CN\":\"82\",\"HasAudio\":false,\"IP\":\"192.168.100.82\",\"SMK\":\"SecondStreamProfileToken_640_352\",\"SN\":\"c56a12b2314a7567\",\"ShURL\":\"file/Media/20210826/864977047764448_c56a12b2314a7567_20210826102105.jpg\",\"State\":true}]",

"867698042805146": "[{\"CN\":\"楂樻竻1(800*600)\",\"HasAudio\":false,\"IP\":\"192.168.100.80\",\"SMK\":\"MainStreamProfileToken_2560_1920\",\"SN\":\"00D52D669A69\",\"ShURL\":\"file/Media/20210819/867698042805146_00D52D669A69_20210819143158.jpg\",\"State\":true},{\"CN\":\"楂樻竻2(800*600)\",\"HasAudio\":false,\"IP\":\"192.168.100.81\",\"SMK\":\"MainStreamProfileToken_2560_1920\",\"SN\":\"0004794174BD\",\"ShURL\":\"file/Media/20210819/867698042805146_0004794174BD_20210819143158.jpg\",\"State\":true},{\"CN\":\"鏅€�(640*352)\",\"HasAudio\":false,\"IP\":\"192.168.100.82\",\"SMK\":\"SecondStreamProfileToken_640_352\",\"SN\":\"00B7557EBA0B\",\"ShURL\":\"file/Media/20210808/867698042805146_00B7557EBA0B_20210808122242.jpg\",\"State\":true}]"

}

}

Json字段	含义
Result	状态
Message	消息名
ChannelData	账号下设备对应的通道列表json字符串，通道信息结构见表一

通道列表json数据：

[{

"CN": "48",

"HasAudio": false,

"IP": "192.168.100.48",

"SMK": "stream0_1_640_480",

"SN": "a7a5c97704e8d558",

"ShURL": "",

"State": false

}, {

"CN": "82",

"HasAudio": false,

"IP": "192.168.100.82",

"SMK": "SecondStreamProfileToken_640_352",

"SN": "c56a12b2314a7567",

"ShURL": "file/Media/20210826/864977047764448_c56a12b2314a7567_20210826102105.jpg",

"State": true

}]

表1

Json字段	含义
CN	通道名称
HasAudio	音频标志
IP	相机IP
SMK	所选码流
SN	相机序列号
ShURL	快照地址
State	在线离线状态

设备通道状态

请求：

http://api.uddgps.com/getUserChannelStateData?selaccount=4gtest&SessionId=9D2B721FE7BBCC2E25FAA6EAB7D82320

Get参数	含义
SessionId	会话ID
selaccount	账号

响应：

{

"Result": "ok",

"Message": "",

"ChannelStateData": {

"864977047764448": {

"00B7557EBA0B": true,

"a7a5c97704e8d558": false,

"c56a12b2314a7567": true

},

"867698042805146": {

"0004794174BD": true,

"00B7557EBA0B": true,

"00D52D669A69": true

}

}

}

Json字段	含义
Result	状态
Message	消息名
ChannelStateData	账号下设备通道状态

设备通道地址

请求：

http://api.uddgps.com/GetPushStreamUrl?DeviceNo=864977047764448&SessionId=9D2B721FE7BBCC2E25FAA6EAB7D82320

Get参数	含义
SessionId	会话ID
DeviceNo	设备号

响应：

{

"Result": "ok",

"Message": "",

"DeviceNo": "864977047764448",

"StreamMap": {

"a7a5c97704e8d558_stream0_1_640_480": {

"SerialNumber": "a7a5c97704e8d558",

"MediaKey": "stream0_1_640_480",

"StreamUrl": "rtmp://39.104.98.81/live/a7a5c97704e8d558_stream0_1_640_480paramparamparam",

"HLSurl": "http://video_cdn_cn_2.createiot.com/live/a7a5c97704e8d558_stream0_1_640_480.m3u8",

"RTMPurl": "rtmp://video_cdn_cn_2.createiot.com/live/a7a5c97704e8d558_stream0_1_640_480",

"Flvurl": "http://video_cdn_cn_2.createiot.com/live/a7a5c97704e8d558_stream0_1_640_480.flv"

},

"c56a12b2314a7567_SecondStreamProfileToken_640_352": {

"SerialNumber": "c56a12b2314a7567",

"MediaKey": "SecondStreamProfileToken_640_352",

"StreamUrl": "rtmp://39.104.98.81/live/c56a12b2314a7567_SecondStreamProfileToken_640_352paramparamparam",

"HLSurl": "http://video_cdn_cn_2.createiot.com/live/c56a12b2314a7567_SecondStreamProfileToken_640_352.m3u8",

"RTMPurl": "rtmp://video_cdn_cn_2.createiot.com/live/c56a12b2314a7567_SecondStreamProfileToken_640_352",

"Flvurl": "http://video_cdn_cn_2.createiot.com/live/c56a12b2314a7567_SecondStreamProfileToken_640_352.flv"

}

}

}

Json字段	含义
Result	状态
Message	消息名
DeviceNo	设备号
StreamMap	设备通道对应的流地址，流地址请求时需要提交鉴权参数Token和DeviceNo，Token即SessionId，信息结构见表一

表1

Json字段	含义
SerialNumber	相机序列号
MediaKey	码流标识
StreamUrl	推流URL
HLSurl	HLS URL
RTMPurl	RTMP URL
Flvurl	Flv URL

设备（808/1078）

设备资源请求

图像录像检索

图像检索请求：

http://api.uddgps.com/RequestDeviceResources?ProtocolType=808&RequestType=0&ChannelId=&MediaType=0&EventType=0&DeviceNo=1277116530&StartDate=2022-04-12%2006:00:00&EndDate=2022-04-13%2006:25:25&SessionId=12BD2325071A933875178B27DBB6089F

录像检索请求

http://api.uddgps.com/RequestDeviceResources?ProtocolType=1078&funcname=RequestDeviceResourcesResult&RequestType=0&ChannelId=&AlarmType=0&FileType=0&StreamType=0&StorageType=0&DeviceNo=1277116530&StartDate=2022-04-12%2000:00:00&EndDate=2022-04-12%2006:23:35&SessionId=12BD2325071A933875178B27DBB6089F

Get参数		含义
ProtocolType		协议类型，808，1078
RequestType		请求类型，0：请求资源属性，1：设备上传资源
ChannelId		通道
StartDate		开始时间
EndDate		结束时间
SessionId		会话ID
DeviceNo		设备号
808	MediaType	0：图像；1：音频；2：视频；
	EventType	事件类型，0：平台下发指令；1：定时动作；2：抢劫报警触发；3：碰撞侧翻报警触发；
1078	AlarmType	兼容808和1078报警标志位
	FileType	0:音视频，1：音频，2：视频，3：视频或音视频
	StreamType	码流类型，0：所有码流，1：主码流，2：子码流
	StorageType	存储器类型，0：所有存储器，1：主存储器，2：灾备存储器

响应：

{

"Result": "ok",

"Message": "",

"Task": {

"UUID": "b78ade8d5e70cc38a8f7dc9173cbab44",

"DeviceNo": "1277116530",

"ProtocolType": "808",

"RequestType": 0,

"TaskResult": 10,

"ChannelId": 0,

"StartDate": "2022-04-12 06:00:00",

"EndDate": "2022-04-13 06:25:25",

"MsgIndex": 436,

"MediaType": 0,

"EventType": 0,

"MediaFileInfo_808": {

"848": {

"ChannelId": 1,

"MediaId": 848,

"MediaType": 0,

"MediaCode": 0,

"EventType": 0,

"FilePath": "file/Media/20220412/1277116530_1_848.jpg",

"FileSize": 15506,

"Longitude": 0,

"Latitude": 0,

"Longitude1": 0,

"Latitude1": 0,

"Longitude2": 0,

"Latitude2": 0,

"N_S": "",

"E_W": "",

"Speed": 0,

"Direction": 0,

"Mode": "",

"DateTime": ""

},

"849": {

"ChannelId": 1,

"MediaId": 849,

"MediaType": 0,

"MediaCode": 0,

"EventType": 0,

"FilePath": "file/Media/20220412/1277116530_1_849.jpg",

"FileSize": 14862,

"Longitude": 0,

"Latitude": 0,

"Longitude1": 0,

"Latitude1": 0,

"Longitude2": 0,

"Latitude2": 0,

"N_S": "",

"E_W": "",

"Speed": 0,

"Direction": 0,

"Mode": "",

"DateTime": ""

}

},

"AlarmType": 0,

"FileType": 0,

"StreamType": 0,

"StorageType": 0,

"MediaFileInfo_1078": null

}

}

Json字段	含义
Result	状态
Message	消息名
Task	设备资源请求任务，信息结构见表一

表1

Json字段	含义
UUID	设备资源请求任务唯一标识
DeviceNo	设备号
ProtocolType	协议类型，808，1078
RequestType	请求类型，0：请求资源属性，1：设备上传资源
TaskResult	任务执行结果，0：执行中，10：资源请求成功，11：资源请求失败，19:上传中，20：资源上传成功，21：资源上传失败
ChannelId	通道
MediaType	0：图像；1：音频；2：视频；
EventType	事件类型，0：平台下发指令；1：定时动作；2：抢劫报警触发；3：碰撞侧翻报警触发；
StartDate	开始时间
EndDate	结束时间
MediaFileInfo_808	808设备资源属性列表，key：多媒体ID，信息结构见下表
MediaFileInfo_1078	1078设备资源属性列表，key：UUID，信息结构见下表

808设备资源属性

Json字段	含义
ChannelId	通道ID
MediaId	多媒体ID
MediaType	多媒体类型，0：图像；1：音频；2：视频；
MediaCode	多媒体编码，0：JPEG；1：TIF；2：MP3；3：WAV；4：WMV；其他保留
EventType	事件类型，0：平台下发指令；1：定时动作；2：抢劫报警触发；3：碰撞侧翻报警触发；其他保留
FilePath	文件路径
FileSize	文件大小，单位字节
Longitude	Gps经度
Latitude	Gps纬度
Longitude1	Gps经度（google）
Latitude1	Gps纬度（google）
Longitude2	Gps经度（baidu）
Latitude2	Gps纬度（baidu）
Speed	速度
Direction	方向
Mode	定位状态，A:GPS有效，V：GPS无效
DateTime	定位时间

1078设备资源属性

Json字段	含义
UUID	录像资源标识
ChannelId	通道ID
StartDate	开始时间
EndDate	结束时间
AlarmType	兼容808和1078报警标志位
FileType	0:音视频，1：音频，2：视频
StreamType	码流类型，1：主码流，2：子码流
StorageType	存储器类型，1：主存储器，2：灾备存储器
FilePath	文件路径
FileSize	文件大小，单位字节
UploadState	上传状态，0：未上传，1：准备上传/上传中，2：上传失败，3：上传成功
UploadTime	上传时间戳

图像上传

请求：

http://api.uddgps.com/UploadDeviceResources?DeviceNo=1277116530&UUID=355e1267d375557bbbdd7c21d42bb7ec&SessionId=12BD2325071A933875178B27DBB6089F

Get参数	含义
DeviceNo	设备号
UUID	设备资源请求任务唯一标识
SessionId	会话ID

响应：

Json字段	含义
Result	状态
Message	消息名
Task	设备资源请求任务

录像上传

请求：

http://api.uddgps.com/UploadDeviceResources?DeviceNo=1277116530&UUID=35aff100ac8cce8202db875d45602273&MediaFileUUID=1fdb203d3b05f05ab286e99a84356d19&SessionId=12BD2325071A933875178B27DBB6089F&_=1649715814299

Get参数	含义
DeviceNo	设备号
UUID	设备资源请求任务唯一标识
MediaFileUUID	录像资源标识
SessionId	会话ID

响应：

Json字段	含义
Result	状态
Message	消息名
MediaFileUUID	录像资源标识
Task	设备资源请求任务

设备资源请求任务列表

请求：

http://api.uddgps.com/GetDeviceResources?DeviceNo=1277116530&UUID=355e1267d375557bbbdd7c21d42bb7ec&SessionId=12BD2325071A933875178B27DBB6089F

Get参数	含义
DeviceNo	设备号
UUID	设备资源请求任务唯一标识 为空：查询所有的请求任务
SessionId	会话ID

响应：

Json字段	含义
Result	状态
Message	消息名
Task	设备资源请求任务列表

设备（CFIOT）

通道截图

请求：

http://api.uddgps.com/getImageFromChannel?DeviceNo=88888881&SN=f71962e51db33c1b&SMK=CH00SubStreamProfileToken_000_1270_720&SessionId=97843F8E3F824A324832204071C6C2CD

Get参数	含义
SessionId	会话ID
DeviceNo	设备号
SMK	所选码流
SN	相机序列号

响应：

图片二进制数据或错误消息体，请求间隔小于5秒时，会返回错误消息体，第三方系统通过响应头Content-Type来判断是二进制数据和json数据

Content-Type	数据类型
image/jpeg	二进制
application/javascript	Json，信息结构见表一

表一

Json字段	含义
Result	状态
Message	消息名 StatusInternalServerError：请求失败，调整请求间隔

通道录像

请求：

http://api.uddgps.com/getVideoFromChannel?DeviceNo=88888881&Cid=&SN=f71962e51db33c1b&SMK=CH00SubStreamProfileToken_000_1270_720&Type=flv&Dur=20&SessionId=97843F8E3F824A324832204071C6C2CD

Get参数	含义
SessionId	会话ID
DeviceNo	设备号
SMK	所选码流
SN	相机序列号
Dur	录像时长,<=60秒
Type	视频类型：flv/avi
Cid	资源编号，第一次请求为空，返回资源编号，后续下载请求，需填写对应的资源编号

响应：

视频文件二进制数据或错误消息体，第三方系统通过响应头Content-Type来判断是二进制数据和json数据

Content-Type	数据类型
application/octet-stream	二进制
application/javascript	Json，信息结构见表一

表一

Json字段	含义
Result	状态
Message	消息名 Recording：视频文件录制中或上传中 Expired：资源已经过期，资源有效时间，大于120秒，小于3*录制时长
Cid	资源编号

Mqtt接口

一个账号下的设备，需要处于关注状态，后台才会转发位置和报警信息到账号对应的数据发布主题，第三方系统订阅这个主题后，可以实时接收到经由后台转发的设备实时位置和报警信息。

实时位置

消息结构

消息字段	含义
MsgType	消息类型：gps
DeviceNo	设备号
Online
Acc
Mode
Longitude	Gps经度
Latitude	Gps纬度
Longitude1	Gps经度（google）
Latitude1	Gps纬度（google）
Longitude2	Gps经度（baidu）
Latitude2	Gps纬度（baidu）
N_S	S:南纬,N:北纬
E_W	E:东经，W：西经
Speed	速度
Direction	方向
DateTime1	GPS时间
ReceiveTime1	信号时间

{

    "MsgType": "gps",

    "DeviceNo": "862607059076223",

    "Online": 1,

    "Acc": 0,

    "Mode": "A",

    "Latitude": 31.842539033333335,

    "Longitude": 117.23089605,

    "Latitude1": 31.840525033333336,

    "Longitude1": 117.23637805,

    "Latitude2": 31.846887333333335,

    "Longitude2": 117.24280885,

    "Speed": 0,

    "Direction": 157.8,

    "E_W": "E",

    "N_S": "N",

    "DateTime1": "2021-07-01 03:36:49",

    "ReceiveTime1": "2021-07-01 03:36:49"

}

实时报警

消息结构

消息字段	含义
MsgType	消息类型：Alarm
DeviceNo	设备号
Data	报警信息，结构见GPS缓存数据章节 中表2

{

"MsgType": "Alarm",

"DeviceNo": "862607059076223",

"Data": {

"DeviceNo": "862607059076223",

"DeviceName": "陈工测试",

"AlarmType": 100,

"Longitude": 0,

"Latitude": 0,

"Longitude1": 0,

"Latitude1": 0,

"Longitude2": 0,

"Latitude2": 0,

"Speed": 0,

"Direction": 0,

"Mode": "",

"AlarmTime": "2021-07-01T02:44:06.411582188+08:00",

"AlarmTime1": "2021-07-01 02:44:06",

"GpsTime": "0001-01-01T00:00:00Z",

"GpsTime1": "",

"AlarmAddress": "",

"AlertInfo": "",

"OfflineTimeout": 0,

"FileName": "file/Media/20210701/862607059076223_00B7557EBA0B_20210630184405.jpg"

}

}

设备事件

设备（CFIOT）

文件上传事件

消息结构

消息字段	含义
MsgType	消息类型：HTTP_onEvent/Ftp_onEvent
DeviceNo	设备号
Data	详细信息，结构见表1

表1

字段	含义
ChannelName	通道名称
EventName	事件名 File_Upload_Success：文件上传成功 File_Upload_Failure：文件上传失败 FTP_Upload_Success：ftp上传成功 FTP_Upload_Failure：ftp上传失败
FileName	上传文件路径
MediaKey	码流标识
Message	附加消息
SerialNumber	摄像机序列号

{

    "MsgType": "HTTP_onEvent",

    "DeviceNo": "862607059076223",

    "Data": {

        "ChannelName": "通道2",

        "EventName": "File_Upload_Success",

        "FileName": "file/Media/20210701/862607059076223_00B7557EBA0B_20210630184405.jpg",

        "MediaKey": "SecondStreamProfileToken_640_352",

        "Message": "",

        "SerialNumber": "00B7557EBA0B"

    }

}

图片/视频采集事件

消息结构

消息字段	含义
MsgType	消息类型：Media_onEvent
DeviceNo	设备号
Data	详细信息，结构见表1

表1

字段	含义
ChannelName	通道名称
EventName	事件名 Media_Screenshot_Success：截图成功 Media_Screenshot_Failure：截图失败 Media_VideoRecording_Success：视频录制成功 Media_VideoRecording_Failure：视频录制失败
FileName
MediaKey	码流标识
Message	附加消息
SerialNumber	摄像机序列号

{

    "MsgType": "Media_onEvent",

    "DeviceNo": "862607059076223",

    "Data": {

        "ChannelName": "通道2",

        "EventName": "Media_Screenshot_Success",

        "FileName": "",

        "MediaKey": "SecondStreamProfileToken_640_352",

        "Message": "",

        "SerialNumber": "00B7557EBA0B"

    }

}

设备（808/1078）

文件上传事件

消息结构

消息字段		含义
MsgType		消息类型：MediaFileUpload
DeviceNo		设备号
ChannelId		通道编号
ProtocolType		808/1078
808	MediaId	多媒体ID
	MediaType	多媒体类型，0：图像；1：音频；2：视频；
	MediaCode	多媒体编码，0：JPEG；1：TIF；2：MP3；3：WAV；4：WMV；其他保留
	EventType	事件类型，0：平台下发指令；1：定时动作；2：抢劫报警触发；3：碰撞侧翻报警触发；其他保留
	FilePath	文件路径
	FileSize	文件大小，单位字节
	Longitude	Gps经度
	Latitude	Gps纬度
	Longitude1	Gps经度（google）
	Latitude1	Gps纬度（google）
	Longitude2	Gps经度（baidu）
	Latitude2	Gps纬度（baidu）
	Speed	速度
	Direction	方向
	Mode	定位状态，A:GPS有效，V：GPS无效
	DateTime	定位时间
1078	UUID	录像资源标识
	StartDate	开始时间
	EndDate	结束时间
	AlarmType	兼容808和1078报警标志位
	FileType	0:音视频，1：音频，2：视频
	StreamType	码流类型，1：主码流，2：子码流
	StorageType	存储器类型，1：主存储器，2：灾备存储器
	FilePath	文件路径
	FileSize	文件大小，单位字节
	UploadState	上传状态，0：未上传，1：准备上传/上传中，2：上传失败，3：上传成功
	UploadTime	上传时间戳