车辆动态监控系统-开放API调用说明

采用HTTP + JSON的方式调用

API主要功能：获取TOKEN、实时定位、历史轨迹、视频实时播放、查询历史视频列表、历史视频回放、历史视频回放进度控制。

1200 获取TOKEN

请求参数：

回复参数：

示例：

请求：
{apicode:1200,account:"openapi",password:"63474798a035919d470a81536897b2b0",apitoken:"a4475031-d2af-4695-a722-8f6128d90581"}

回复
{
"code": 1,
"message": "SUCCESS",
"token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJsYXN0TG9naW5UaW1lIjoxNjY1NzMyMjQ5NDA3LCJyb2xlSWRzIjoiMGRmZGNjNmYtZWI3Zi00ZWRiLTkzY2MtZTVhY2NiMTdmNmQ1Iiwib3JnSWRzIjoiNjY4OWFlNmEtMTQwZi0xMWU1LWI2NTAtNzRkMDJiNmI1ZjYxIiwiZXhwIjoxNjY1NzM0MDQ5LCJ1c2VySWQiOiJmY2UyZjUyYy0zZTc1LTRhMGItODU0YS0xYzE2M2ZjMzk1OTQifQ.wXXU2JuMCXzr4q4dX448FX5Ja6_Hv5V-3hwJdNxQWOY"
}

1201 获取车辆最新位置信息

请求参数：

回复参数：

示例：

请求:
{apicode:1201,deviceId:"018000032600",
"lingxtoken": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJsYXN0TG9naW5UaW1lIjoxNjY1NzMyMjQ5NDA3LCJyb2xlSWRzIjoiMGRmZGNjNmYtZWI3Zi00ZWRiLTkzY2MtZTVhY2NiMTdmNmQ1Iiwib3JnSWRzIjoiNjY4OWFlNmEtMTQwZi0xMWU1LWI2NTAtNzRkMDJiNmI1ZjYxIiwiZXhwIjoxNjY1NzM0MDQ5LCJ1c2VySWQiOiJmY2UyZjUyYy0zZTc1LTRhMGItODU0YS0xYzE2M2ZjMzk1OTQifQ.wXXU2JuMCXzr4q4dX448FX5Ja6_Hv5V-3hwJdNxQWOY"}
回复:
{
"code": 1,
"data": [{
"A01": 1523.0,//设备累计总里程,KM
"A02": 0,//当前油量,需要设备支持,L
"lat_baidu": "31.344596285760456",//百度坐标
"type": "0x0200",//无意义
"tid": "018000032600",//设备号
"speed": 33.0,//时速，KM/H
"alarm": 0,//JT808的报警标志，参照JT808协议解析
"is_address": true,
"alarm_str": "无",//平台转换后的报警信息
"lat": 31.340879440307617,//wgs84坐标
"A30": 0,//无线通信网络信号强度
"height": 51,//高程，米
"direction": 11,//方向，0为正北，正时针方向
"A31": 0,//GNSS 定位卫星数
"address": "四川省德阳市绵竹市剑南街道春溢路59-61号寿春苑,距笋坝子170米",//当前地址，不一定能返回，最好业务系统自己获取
"lng": 104.19419860839844,//wgs84坐标
"JT808ServerId": "JT808ServerId_1",//JT808网关ID
"dtlc": 0,//当天行驶里程,KM
"status_str": "点火,定位",
"systime": "20220902094817",//系统时间
"status_jt808": 4,//1 报警， 2 行驶 ，3 定位，4 离线，5在线不定位
"JT808Info": 1,//无意义
"lng_baidu": "104.20319362927182",//百度坐标
"online": 0,//是否在线,1为在线
"comment": "离线(11分43秒)",
"gpstime": "20220902094817",//卫星时间
"status_leftcar": "离线(11分43秒)",
"status": 3,//JT808的状态标志，参照JT808协议解析
"ts": 1662083297652
}],
"message": "SUCCESS"
}

附加：WEBSOCKET实时推送定位数据接口

获取websocket地址

接口1200返回的参数websocket0x0200URL

1、订阅数据

{cmd:1005,tid:"设备号"}

注意：发送文本消息JSON.stringify({cmd:1005,tid:"设备号"})

2、取消订阅

{cmd:1006,tid:"设备号"}

注意：发送文本消息JSON.stringify({cmd:1006,tid:"设备号"})

1202 获取车辆历史轨迹信息

请求参数：

回复参数：

示例：

请求:
回复:
{
"code": 1,
"data": [{
"id": 17975,//记录ID
"car_id": "018000032600",//设备号,等于实时定位的tid，等于入参的deviceId
"alarm": 0,//JT808的报警标志，参照JT808协议解析
"status": 786435,//JT808的状态标志，参照JT808协议解析
"acc": "1",//点火标志,1点火，非1为熄火
"location": "1",//是否定位，1定位，非1未定位
"lat": 29.6330757,//wgs84坐标
"lng": 105.1450272,//wgs84坐标
"height": 315,//高程，米
"speed": 0.0,//时速，KM/H
"direction": 347,//方向，0为正北，顺时针
"gpstime": "20221207062942",//卫星时间
"systime": "20221207062942",//系统时间
"mileage": 2105.0,//累计里程，KM
"oil": 0.0,//当时油量,L
"txxh": 21,//通信信号
"wxxh": 27,//卫星信息
"status_str": "点火,定位",//系统根据配置解析的状态描述
"alarm_str": "无",//系统根据配置解析的报警描述
"lng_baidu": "105.15483471834807",//百度坐标
"lat_baidu": "29.636533563381434"//百度坐标
}],
"message": "SUCCESS"
}

1203 视频实时直播

请求参数：

回复参数：

示例：

请求:

1204 获取历史视频列表

请求参数：

回复参数：

示例：

请求:
回复:
{
"code": 1,
"data": [
{
"mltype": 1,//码流类型，１：主码流，２：子码流
"zcqtype": 1,//存储器类型，１：主存储器，２：灾备存储器
"etime": "20221206134330",//结束时间
"length": 13632409,//媒体文件大小，单位字节
"tdh": 1,//逻辑通道号
"stime": "20221206134215",//起始时间
"bjzt": "0000000000000000",//报警状态，ｂｉｔ０ ～ ｂｉｔ３１ 按照 ＪＴ／ Ｔ ８０８—２０１１ 的表 １８ 报警标志位定义； ｂｉｔ３２ ～ ｂｉｔ６３ 见表 １３
"type": 0//媒体文件类型，０：音视频，１：音频，２：视频
}
]
}

1205 历史视频在线回放

请求参数：

回复参数：

示例：

请求:
{"apicode":1205,"deviceId":"018000032600","channel":1,"stime":"20221104140408","etime":"20221104142834","type":0,"mltype":1,"zcqtype":1,"lingxtoken":"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJsYXN0TG9naW5UaW1lIjoxNjY3NTQyMTM2Mjk2LCJyb2xlSWRzIjoiNmUwMzYyZTgtMTAwZS0xMWU1LWI3YWItNzRkMDJiNmI1ZjYxIiwib3JnSWRzIjoiYzhhODA3ZjItOWNlZS00Mzg0LTlhNDEtZGFmMTcwNzNiOTk3IiwiZXhwIjoxNjY3NTQ4MzQ3LCJ1c2VySWQiOiI0M2IyZjg0Yi02ZTJkLTRjNGEtODdkNi1hYjY3ZThjODgzYWUifQ.CH-5YnVMhrAaDXdUbTw1Lox6Ep4PM92syamWhkJUztk"}

回复:
{"code":1,"pull_address":"wss://www.gb35658.com/wss6899/websocket","message":"SUCCESS"}

1206 历史视频进度控制

请求参数：

回复参数：

示例：

请求:
{
apicode: 1204,
deviceId: "018000032600",
channel: 1,
stime: "20221120000000",
etime: "20221121000000",
"lingxtoken": ""
}
回复：
{
"code": 1,
"data": [
{
"mltype": 1,//码流类型
"zcqtype": 1,//存储器类型
"etime": "20221120074942",//视频截止时间
"length": 11696979,//视频文件大小，字节
"tdh": 1,//逻辑通道号
"stime": "20221120074839",//视频起始时间
"bjzt": "0000000000000000",//报警标识
"type": 0//文件类型，0是音视频
}
],
"message": "SUCCESS"
}

1207 获取车辆报警数据列表

请求参数：

回复参数：

示例：

请求:

回复:
{
"total": 20,//总记录数
"code": 1,
"data": [
{
"id": 232,
"car_id": "018000032600",//设备号
"name": "摄像头故障",//报警名称
"speed": 40.0, //时速
"lat": 28.973707,
"lng": 118.945648,
"gpstime": "20220712155056", //卫星时间
"ts": "20220712155057"//系统时间
},
{
"id": 238,
"car_id": "018000032600",
"name": "超速报警",
"speed": 55.0,
"lat": 24.645397,
"lng": 118.050728,
"gpstime": "20220722141703",
"ts": "20220722141703"
}
],
"message": "SUCCESS"
}

1208 获取主动安全ADAS数据列表

请求参数：

回复参数：

示例：

请求:
{apicode:1208,deviceId:"012345678912,013800138999",type:"3,2,1",lingxtoken:"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJsYXN0TG9naW5UaW1lIjoxNjY3OTcyNjAxNTUxLCJyb2xlSWRzIjoiMGRmZGNjNmYtZWI3Zi00ZWRiLTkzY2MtZTVhY2NiMTdmNmQ1Iiwib3JnSWRzIjoiNjY4OWFlNmEtMTQwZi0xMWU1LWI2NTAtNzRkMDJiNmI1ZjYxIiwiZXhwIjoxNjY3OTc0NDAxLCJ1c2VySWQiOiJhYjM5NjNjYy1hYmJiLTRkMTUtYjQzYy0xNmVkMTg0ZThiZGUifQ.Kr961Ulwk6qi420nF4eYg3bciFobkv9AnyOxIY0CZV4"}
回复：
{
"total": 1,// 记录总数
"code": 1,
"data": [
{
"id": "002041d262ab413d8cd150d168e361ad",
"car_id": "00000000012917000922",
"bjid": 4,//报警ID
"bzzt": 0,//标志状态
"bjlx": 3,//报警类型
"bjjb": 1,//报警级别
"qccs": 0,//前车车速
"qcjl": 0,//前车距离
"pllx": 0,//偏离类型
"dlbjsblx": 0,//道路标志识别类型
"dlbzsbsj": 0,//道路标志识别数据
"speed": 44,//时速KM/H
"height": 20,//高程M
"lat": 30.219493,
"lng": 116.978613,
"status": "1025",//车辆状态,等同于0x0200的车辆状态
"gpstime": "20221107185344",//卫星时间
"ts": "20221107185351",//系统时间
"files": [
{
"name": "00_64_6403_00_002041d262ab413d8cd150d168e361ad.jpg",
"type": 0,
"length": 26,
"path": "https://www.gb35658.com/AdasFile/2022/11/07/00000000012917000922/002041d262ab413d8cd150d168e361ad/00_64_6403_00_002041d262ab413d8cd150d168e361ad.jpg"
}
]
}
],
"message": "SUCCESS"
}

1209 获取主动安全DSM数据列表

请求参数：

回复参数：

示例：

请求:
{apicode:1209,deviceId:"012345678912,013800138999",type:"3,2,1",lingxtoken:"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJsYXN0TG9naW5UaW1lIjoxNjY3OTcyNjAxNTUxLCJyb2xlSWRzIjoiMGRmZGNjNmYtZWI3Zi00ZWRiLTkzY2MtZTVhY2NiMTdmNmQ1Iiwib3JnSWRzIjoiNjY4OWFlNmEtMTQwZi0xMWU1LWI2NTAtNzRkMDJiNmI1ZjYxIiwiZXhwIjoxNjY3OTc0NDAxLCJ1c2VySWQiOiJhYjM5NjNjYy1hYmJiLTRkMTUtYjQzYy0xNmVkMTg0ZThiZGUifQ.Kr961Ulwk6qi420nF4eYg3bciFobkv9AnyOxIY0CZV4"}
回复:
{
"total": 1,// 记录总数
"code": 1,
"data": [
{
"id": "0000b21521c345dd8c0c42c5f2dd03b8",
"car_id": "016821120125",
"bjid": 176,//报警ID
"bzzt": 0,//标志状态
"bjlx": 5,//报警类型
"bjjb": 1,//报警级别
"plcd": 5,//疲劳程度
"speed": 50,//时速
"height": 0,//高程
"lat": 40.037135,
"lng": 116.307246,
"status": "1025",//车辆状态,等同于0x0200的车辆状态
"gpstime": "20221028151547",//卫星时间
"ts": "20221028151550",//系统时间
"files": [
{
"name": "02_65_6505_1_0000b21521c345dd8c0c42c5f2dd03b8.mp4",
"type": 2,
"length": 80,
"path": "https://www.gb35658.com/AdasFile/2022/10/28/016821120125/0000b21521c345dd8c0c42c5f2dd03b8/02_65_6505_1_0000b21521c345dd8c0c42c5f2dd03b8.mp4"
}
]
}
],
"message": "SUCCESS"
}

1210 刷新TOKEN

请求参数：

回复参数：

示例：

请求:

1211 获取车辆信息列表

请求参数：

回复参数：

示例：

请求:

返回：
{
"code": 1,
"data": [
{
"id": "012345678999",//设备号，用于调用其他接口
"carno": "测A123456",//车牌号码
"gpstime": "20221111143458",//最后位置上报时间
"create_time": "20221111095029"//车辆信息创建时间
}
],
"message": "SUCCESS"
}

1212 获取终端参数

请求参数：

回复参数：

示例：

请求:
{
"apicode": 1212,
"deviceId": "018000032600",
"id": 1,
"type": "DWORD",
"lingxtoken": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJsYXN0TG9naW5UaW1lIjoxNjY4NjcwNDMwOTY3LCJyb2xlSWRzIjoiNmUwMzYyZTgtMTAwZS0xMWU1LWI3YWItNzRkMDJiNmI1ZjYxIiwib3JnSWRzIjoiNjY4OWFlNmEtMTQwZi0xMWU1LWI2NTAtNzRkMDJiNmI1ZjYxLGM4YTgwN2YyLTljZWUtNDM4NC05YTQxLWRhZjE3MDczYjk5NyIsImV4cCI6MTY2ODY3MjIzMCwidXNlcklkIjoiNDNiMmY4NGItNmUyZC00YzRhLTg3ZDYtYWI2N2U4Yzg4M2FlIn0.FZI7IxxKWS4hb14Wh_OSURMTl1BSBesDHz1i4yCerXY"
}:
返回：
{
"code": 1,
"data": {//终端返回原始数据
"1": "0000003C",
"message": "SUCCESS"
},
"message": "SUCCESS",
"value": 60 //参数值
}

1213 获取系统字典接口

请求参数：

回复参数：

示例：

请求:

返回：
{
"code": 1,
"data": {
"id": "740bc5d6-153d-4c09-a9f2-c34b0d46399a",
"name": "DSM报警类型",
"code": "DSM_BJLX",
"items": [
{
"name": "疲劳驾驶报警",
"value": "1"
}
]
},
"message": "SUCCESS"
}

1214 添加车辆信息接口

请求参数：

回复参数：

示例：

请求:

1215 修改车辆信息接口

请求参数：

回复参数：

示例：

请求:

1216 删除车辆信息接口

请求参数：

回复参数：

示例：

请求:

1219 终端指令下发接口

请求参数：

回复参数：

示例：

请求:

1225 下发上传视频指令接口

请求参数：

回复参数：

示例：

请求:

1226 获取设备上传的媒体文件接口

请求参数：

回复参数：

示例：

请求:

1240 获取行车或停车记录接口

请求参数：

回复参数：

示例：

请求:

1241 最新数据接口

请求参数：

回复参数：

示例：

请求:

1242 离线车辆接口

请求参数：

回复参数：

示例：

请求:

1243 报警统计接口

请求参数：

回复参数：

示例：

请求:

1244 行程统计接口

请求参数：

回复参数：

示例：

请求:

1245 里程统计(天)接口

请求参数：

回复参数：

示例：

请求:

1246 里程统计(月)接口

请求参数：

回复参数：

示例：

请求: