乐高易软件-乐高易车联网平台接口体系 www.legaoyi.com
广西乐高易网络有限公司 www.legaoyi.com 1 / 70
乐高易软件-乐高易车联网平台接口体系 www.legaoyi.com
广西乐高易网络有限公司 www.legaoyi.com 2 / 70
乐高易软件-乐高易车联网平台接口体系 www.legaoyi.com
广西乐高易网络有限公司 www.legaoyi.com 3 / 70
乐高易软件-乐高易车联网平台接口体系 www.legaoyi.com
广西乐高易网络有限公司 www.legaoyi.com 4 / 70
乐高易软件-乐高易车联网平台接口体系 www.legaoyi.com
广西乐高易网络有限公司 www.legaoyi.com 5 / 70
接口体系 平台提供restful风格的接口,接口调用安全遵守OAuth2.0认证协议,调用接口时必须通过Http请求头传递用户标识及其认证令牌。如:
Authorization:Bearer d2pqOjEyMzQ1Ng==
其中“d2pqOjEyMzQ1Ng”为token字符串。
接口返回结果为json格式(application/json)。返回结果数据结构如下:
返回参数说明:
返回json示例:
元数据接口属于框架层面的通用接口,提供了基于实体的CURD操作,为标准的RESTful风格接口。
请求路径:
GET ${host}/system/objects
请求参数:
无
返回参数:
{ "code":0, "message":"success", "data":{ }} 乐高易软件-乐高易车联网平台接口体系 www.legaoyi.com
广西乐高易网络有限公司 www.legaoyi.com 6 / 70
请求例子:
GET https://api.legaoyi.com/system/objects.json
请求路径:
GET ${host}/system/object/{entityName}/description
请求参数:
返回参数:
对象描述信息
请求例子:
GET https://api.legaoyi.com/system/object/device/description.json
请求路径:
GET ${host}/system/message/{messageId}/description
请求参数:
返回参数:
消息描述信息
乐高易软件-乐高易车联网平台接口体系 www.legaoyi.com
广西乐高易网络有限公司 www.legaoyi.com 7 / 70
请求例子:
GET https://api.legaoyi.com/system/message/0200/description.json
请求路径:
GET ${host}/system/message/{messageId}/example
请求参数:
返回参数:
消息样例信息
请求例子:
GET https://api.legaoyi.com/system/message/0200/example.json
对象记录列表查询接口,根据给定的实体名称和查询条件查询对象数据。根据对象数据的存储所用的数据库(mysql、mongodb),查询条件稍有不同,具体参考以下介绍。
请求路径:
POST ${host} /common/query/{entityName}.json
请求参数:
url参数,返回字段信息(对应实体对象字段名称),逗号分隔
url参数,是否需要返回分页参数(可选值:ture、 false)
url参数,是否降序(可选值:ture、 false)
乐高易软件-乐高易车联网平台接口体系 www.legaoyi.com
广西乐高易网络有限公司 www.legaoyi.com 8 / 70
post消息体参数(json格式),查询条件对象,支持and查询,key-value值,支持gt,gte,lt,lte,eq,neq,like操作
对于关系型数据库(mysql)
form参数格式:
对于mongodb数据库:
form参数格式:
数据存放时间yyyyMMdd格式(由于mongodb中部分数据是按天分表存放,这部分数据需要传此参数)
普通查询条件,支持and查询,key-value值,支持gt,gte,lt,lte,eq操作
conditions参数格式:
rangeConditions参数格式:
返回结果:
返回对象记录列表,如果没有匹配的结果,则返回一个空的数组。
乐高易软件-乐高易车联网平台接口体系 www.legaoyi.com
广西乐高易网络有限公司 www.legaoyi.com 9 / 70
请求例子:
POST https://api.legaoyi.com/common/query/user.json?select=id,name&orderBy=createTime
POST消息体(mysql查询条件):
POST消息体(mongodb查询条件):
获取指定ID的指定对象记录,返回对象记录详情。
请求路径:
GET ${host}/common/{entityName}/{id}.json
请求参数(application/json):
{ "userId .gt":1, "userName.like":"test", "type.eq":1} { "conditions":{ "userId .gt":1, "userName.like":"test", "type.eq":1 }, "rangeConditions":[ { "fieldName":"gpsTime", "from":"2016-12-12", "includeLower":true, "includeUpper":true, "to":"2016-12-13" } ]} 乐高易软件-乐高易车联网平台接口体系 www.legaoyi.com
广西乐高易网络有限公司 www.legaoyi.com 10 / 70
返回参数:
对象记录详情,如果没有匹配的结果,则返回空。
请求例子:
GET https://api.legaoyi.com/common/user/1.json
新增对象记录详情。
请求路径:
POST ${host}/common/{entityName}.json
请求参数:
post消息体参数(json格式),实体对象记录详情,key-value值
返回参数:
添加成功后的记录详情。
请求例子:
POST https://api.legaoyi.com/common/user.json
POST消息体:
{ "userName":"test", "type":1} 乐高易软件-乐高易车联网平台接口体系 www.legaoyi.com
广西乐高易网络有限公司 www.legaoyi.com 11 / 70
修改对象记录根据给定的ID修改指定的对象记录。
请求路径:
PATCH ${host}/common/{entityName}/{id}.json
请求参数:
post消息体参数(json格式),实体对象记录详情,key-value值
返回参数:
修改成功后的记录详情。
请求例子:
PATCH https://api.legaoyi.com/common/user/1.json
POST消息体:
删除对象记录。
请求路径:
DELETE ${host}/common/{entityName}/{ids}.json
请求参数:
返回参数:
{ "userName":"test", "type":1} 乐高易软件-乐高易车联网平台接口体系 www.legaoyi.com
广西乐高易网络有限公司 www.legaoyi.com 12 / 70
无注:关联的实质可能被级联删除,取决于JPA标注和数据库表的外键约束情况。
请求例子:
DELETE https://api.legaoyi.com/common/user/1,2,3.json
业务接口提供给外部系统的restful定制化接口,实现特定的逻辑。一般情况下,为了减少业务接口,如果通用接口可以实现的数据操作,则应不提供或者尽量少提供定制化的业务接口。
请求路径:
GET ${host}/ oauth2/token.json
请求参数:
路径参数,
grant_type=password时为用户名称;
grant_type=phone时为手机号码
路径参数,
grant_type=password时为经过AES加密后的用户密码;
grant_type=phone时为手机验证码
返回参数:
乐高易软件-乐高易车联网平台接口体系 www.legaoyi.com
广西乐高易网络有限公司 www.legaoyi.com 13 / 70
请求例子: GET https://api.legaoyi.com/ /oauth2/token.json?grant_type=password&username=test&password=ecM4pCU0VV0xnlhACrb1Tg
请求路径:
GET ${host}/ oauth2/token.json
请求参数:
返回参数:
请求例子:
GET https://api.legaoyi.com/ /oauth2/token.json?grant_type=refresh_token& refresh_token=ecM4pCU0VV0xnlhACrb1Tg
请求路径:
GET ${host}/aas/authentication.json
请求参数:
无
返回参数:
乐高易软件-乐高易车联网平台接口体系 www.legaoyi.com
广西乐高易网络有限公司 www.legaoyi.com 14 / 70
请求例子:
GET https://api.legaoyi.com/aas/authentication.json
请求路径:
GET ${host}/aas/subsidiary.json
请求参数:
无
返回参数:
返回下级企业对象“Enterprise”详情列表。
请求例子:
GET https://api.legaoyi.com/aas/subsidiary.json
请求路径:
乐高易软件-乐高易车联网平台接口体系 www.legaoyi.com
广西乐高易网络有限公司 www.legaoyi.com 15 / 70
GET ${host}/device/{id}/state.json
请求参数:
返回参数:
设备状态,
0:未注册;
1:已注册;
2:离线;
3:在线;
4:已注销;
5:已停用
请求例子:
GET https://api.legaoyi.com/device/1,2,3/state.json
请求路径:
GET ${host}/device/{id}/bizState.json
请求参数:
返回参数:
业务状态:
0:离线;
1:行驶;
2:停车;
3:熄火;
4:无信号
请求例子:
GET https://api.legaoyi.com/device/1,2,3/bizState.json
乐高易软件-乐高易车联网平台接口体系 www.legaoyi.com
广西乐高易网络有限公司 www.legaoyi.com 16 / 70
获取设备信息接口请求路径:
GET ${host}/device/{id}.json
请求参数:
返回参数:
返回设备对象“Device”详情
请求例子:
GET https://api.legaoyi.com/device/1.json
请求路径:
GET ${host}/device/{id}/car.json
请求参数:
返回参数:
返回“DeviceCar”对象详情。
请求例子:
GET https://api.legaoyi.com/device/1/car.json
请求路径:
GET ${host}/device/{id}/terminal/params.json
请求参数:
乐高易软件-乐高易车联网平台接口体系 www.legaoyi.com
广西乐高易网络有限公司 www.legaoyi.com 17 / 70
返回参数:
请求例子:
GET https://api.legaoyi.com/device/1/terminal/params.json
请求路径:
GET ${host}/car/{id}/state.json
请求参数:
返回参数:
设备状态,
0:未注册;
1:已注册;
2:离线;
3:在线;
4:已注销;
5:已停用
请求例子:
GET https://api.legaoyi.com/car/1/state.json
请求路径:
GET ${host}/car/{id}/bizState.json
请求参数:
乐高易软件-乐高易车联网平台接口体系 www.legaoyi.com
广西乐高易网络有限公司 www.legaoyi.com 18 / 70
返回参数:
业务状态:
0:离线;
1:行驶;
2:停车;
3:熄火;
4:无信号
请求例子:
GET https://api.legaoyi.com/device/1,2,3/bizState.json
请求路径:
DELETE ${host}/car/device/{deviceId}.json
请求参数:
返回参数:
无
请求例子:
DELETE https://api.legaoyi.com/car/device/1.json
请求路径:
GET ${host}/device/driver/{deviceId}.json
请求参数:
返回参数:
乐高易软件-乐高易车联网平台接口体系 www.legaoyi.com
广西乐高易网络有限公司 www.legaoyi.com 19 / 70
返回司机对象“Driver”详情。请求例子:
GET https://api.legaoyi.com/device/driver/1.json
请求路径:
GET ${host}/car/driver/{carId}.json
请求参数:
返回参数:
返回司机对象“Driver”详情。
请求例子:
GET https://api.legaoyi.com/car/driver/1.json
请求路径:
POST ${host}/driver/car/unbind.json
请求参数:
无
返回参数:
请求例子:
GET https://api.legaoyi.com/driver/car/unbind.json
乐高易软件-乐高易车联网平台接口体系 www.legaoyi.com
广西乐高易网络有限公司 www.legaoyi.com 20 / 70
指令下发接口平台向车载设备发送指令。
请求路径:
POST ${host}/command/{deviceId}/{messageId}.json
请求参数:
路径参数,消息ID(参考乐高易网关使用手册中对应消息id的定义)
post消息体参数(json格式),
协议网关定义消息体(参考乐高易网关使用手册中对应消息体的定义),key-value值
返回参数:
返回下行消息对象“DownstreamMessage”详情。
请求例子:
POST https://api.legaoyi.com/command/5/9101.json
POST消息体:
平台向车载设备发送指令。
请求路径:
POST ${host}/batch/command/{messageId}.json
请求参数:
{ "channelId":1, "dataType":0, "streamType":1} 乐高易软件-乐高易车联网平台接口体系 www.legaoyi.com
广西乐高易网络有限公司 www.legaoyi.com 21 / 70
路径参数,消息ID(参考乐高易网关使用手册中对应消息id的定义)
post消息体参数(json格式),
协议网关定义消息体(参考乐高易网关使用手册中对应消息体的定义),key-value值
ost消息体参数,设备id列表,多个设备id之间“,”逗号分隔
返回参数:
返回下行消息对象“DownstreamMessage”详情。
请求例子:
POST https://api.legaoyi.com/batch/command/9101.json
POST消息体:
根据指令id查询指令的下发的状态。
请求路径:
GET ${host}/command/{id}/state.json
请求参数:
路径参数,指令记录id列表,多个(最多10个)可用“,”分隔
返回参数:
指令状态,
0:终端设备应答成功;
1:终端设备应答失败;
2:终端应答消息有误;
3:终端应答消息不支持;
{ "deviceIds":"1,2,3", "channelId":1, "dataType":0, "streamType":1} 乐高易软件-乐高易车联网平台接口体系 www.legaoyi.com
广西乐高易网络有限公司 www.legaoyi.com 22 / 70
4:消息已下发;
5:终端设备已下线;
6:消息有误;
7:不支持该消息;
8:网关处理中;
9:终端应答超时
请求例子:
GET https://api.legaoyi.com/command/1/state.json
平台向车载设备发送开启实时音视频传输指令。
请求路径:
POST ${host}/command/{deviceId}/9101.json
请求参数:
post消息体参数,数据类型
0:音视频
1:视频
2:对讲
3:监听
post消息体参数,码流类型,
0:主码流
1:子码流
返回参数:
对讲推流wss地址,按照1078协议格式把采集到的pcm(8khz,16位,单通道)数据封装成字节流
请求例子:
乐高易软件-乐高易车联网平台接口体系 www.legaoyi.com
广西乐高易网络有限公司 www.legaoyi.com 23 / 70
POST https://api.legaoyi.com/command/5/1/9101.json
POST消息体:
前端应用开始播放视频时,定时(每隔5秒)调用该接口保持心跳,否则后台会自动关闭视频。
请求路径:
PUT ${host}/video/heartbeat/{streamId}.json
请求参数:
返回参数:
无
请求例子:
PUT https://api.legaoyi.com/video/heartbeat/1.json
POST消息体:
平台向车载设备发送实时音视频传输控制指令。
请求路径:
{ "channelId":1, "dataType":0, "streamType":1} 乐高易软件-乐高易车联网平台接口体系 www.legaoyi.com
广西乐高易网络有限公司 www.legaoyi.com 24 / 70
PUT ${host}/command/{deviceId}/9102.json
请求参数:
post消息体参数,控制指令
0:关闭音视频
1:切换码流
2:暂停播放
3:恢复播放
4:关闭对讲
post消息体参数,关闭音视频类型
0:关闭全部
1:关闭音频,保留视频
2:关闭视频,保留音频
post消息体参数,码流类型,
0:主码流
1:子码流
返回参数:
返回下行消息对象“DownstreamMessage”详情。
请求例子:
PUT https://api.legaoyi.com/command/5/9102.json
POST消息体:
平台向车载设备发送历史视频资源查询指令。平台会每天定时发送指令查询设备昨天的历史视频资源列表,但不包括今天在内。所以前端应用需要查询今天的历史视频资源时需要先发送改指令获取今天的历史视频资源列表,待车载设备应该成功之后,在调用“查询历史视频资源”接口即可获取历史视频资源列表。对于查询昨天的历史视频资源列表可发可不发送该指令。
请求路径:
POST ${host}/command/{deviceId}/9205.json
{ "channelId":1, "command":0, "dataType":0, "streamType":0} 乐高易软件-乐高易车联网平台接口体系 www.legaoyi.com
广西乐高易网络有限公司 www.legaoyi.com 25 / 70
请求参数:
post消息体参数,逻辑通道号,0代表查询全部通道
post消息体参数,码流类型:
0:所有码流
1:主码流
2:子码流
post消息体参数,存储器类型:
0:所有存储器
1:主存储器;
2:灾备存储器
文件类型:
0:音视频
1:音频
2:视颊;
3:音频或视频
开始时间,格式:yyyy-MM-dd:hh:mm:ss
结束时间,格式:yyyy-MM-dd:hh:mm:ss
返回参数:
返回下行消息对象“DownstreamMessage”详情。
请求例子:
POST https://api.legaoyi.com/command/5/9205.json
POST消息体:
请求路径:
GET ${host}/video/hisVideoResource/{deviceId}/check/last30days.json
请求参数:
{ "channelId":0, "streamType":0, "storeType":0, "resourceType":0, "startTime":"2022-05-30 00:00:00", "endTime":"2022-05-31 00:00:00"} 乐高易软件-乐高易车联网平台接口体系 www.legaoyi.com
广西乐高易网络有限公司 www.legaoyi.com 26 / 70
返回参数:
是否存在视频资源,true 存在;false:不存在
请求例子:
GET https://api.legaoyi.com/video/hisVideoResource/5/check/last30days.json? channelId=1
平台向车载设备发送开启录像回放指令。
请求路径:
POST ${host}/command/playback/{resourceId}.json
请求参数:
返回参数:
请求例子:
POST https://api.legaoyi.com/command/playback/1.json
POST消息体:
乐高易软件-乐高易车联网平台接口体系 www.legaoyi.com
广西乐高易网络有限公司 www.legaoyi.com 27 / 70
开启录像回放指令接口平台向车载设备发送开启录像回放指令。
请求路径:
POST ${host}/command/{deviceId}/9201.json
请求参数:
post消息体参数,回放方式
0:正常回放;
1:快进回放;
2:关键帧快退回放;
3:关键帧播放;
4:单帧上传;
post消息体参数,快进或快退倍数
回放控制为1和2时,此字段内容有效,否则置0。
0;无效;
1 :1倍;
2:2倍;
3:4倍;
4:8倍;
5:16倍
post消息体参数,开始回放位置
格式:yyyy-MM-dd:hh:mm:ss,
回放控制为4时,表示单帧上传时间
post消息体参数,结束回放位置
格式:yyyy-MM-dd:hh:mm:ss,
返回参数:
请求例子:
POST https://api.legaoyi.com/command/{deviceId}/{type}/9201.json
乐高易软件-乐高易车联网平台接口体系 www.legaoyi.com
广西乐高易网络有限公司 www.legaoyi.com 28 / 70
POST消息体:
平台向车载设备发送录像回放控制指令。
请求路径:
post ${host}/command/{deviceId}/9202.json
请求参数:
post消息体参数,回放方式
0:开始回放;
1 :暂停回放;
2:结束回放;
3:快进回放;
4:关键帧快退回放;
5:拖动回放;
6:关键帧播放
post消息体参数,快进或快退倍数
回放控制为3和4时,此字段内容有效,否则置0。
0;无效;
1 :1倍;
2:2倍;
3:4倍;
4:8倍;
5:16倍
{ "channelId":1, "dataType":1, "streamType":0, "storeType ":1, "playbackType":0, "startTime":"2022-06-27 00:00:00", "endTime":"2022-06-27 59:59:59", "bizId":1} 乐高易软件-乐高易车联网平台接口体系 www.legaoyi.com
广西乐高易网络有限公司 www.legaoyi.com 29 / 70
post消息体参数,拖动回放位置
格式:yyyy-MM-dd:hh:mm:ss,
回放控制为5时,此字段有效
返回参数:
返回下行消息对象“DownstreamMessage”详情。
请求例子:
POST https://api.legaoyi.com/command/5/9202.json
POST消息体:
平台向车载设备发送停止录像回放指令。
请求路径:
DELETE ${host}/command/playback/{resourceId}.json
请求参数:
返回参数:
返回下行消息对象“DownstreamMessage”详情。
请求例子:
DELETE https://api.legaoyi.com/command/playback/1.json
{ "channelId":1, "playbackType":5, "playTimes":0, "startTime":"2022-05-30 05:30:00"} 乐高易软件-乐高易车联网平台接口体系 www.legaoyi.com
广西乐高易网络有限公司 www.legaoyi.com 30 / 70
上传历史视频文件指令接口平台向车载设备发送上传历史视频文件指令。
请求路径:
POST ${host}/command/uploadFile/{resourceId}.json
请求参数:
返回参数:
返回下行消息对象“DownstreamMessage”详情。
请求例子:
POST https://api.legaoyi.com/command/uploadFile/1.json
POST消息体:
根据指令id查询指令的下发的状态。
请求路径:
GET ${host}/video/command/{id}/state.json
请求参数:
路径参数,指令记录id列表,多个(最多10个)可用“,”分隔
返回参数:
指令状态,
0:终端设备应答成功;
1:终端设备应答失败;
2:终端应答消息有误;
乐高易软件-乐高易车联网平台接口体系 www.legaoyi.com
广西乐高易网络有限公司 www.legaoyi.com 31 / 70
3:终端应答消息不支持;
4:消息已下发;
5:终端设备已下线;
6:消息有误;
7:不支持该消息;
8:网关处理中;
9:终端应答超时
请求例子:
GET https://api.legaoyi.com/video/command/1/state.json
平台向车载设备发送开启实时音视频传输指令。
请求路径:
POST ${host}/video/command/live/{deviceId}.json
请求参数:
post消息体参数,数据类型
0:音视频
1:视频
2:对讲
3:监听
post消息体参数,码流类型,
0:主码流
1:子码流
返回参数:
对讲推流wss地址,按照1078协议格式把采集到的pcm(8khz,16位,单通道)数据封装成字节流
请求例子:
乐高易软件-乐高易车联网平台接口体系 www.legaoyi.com
广西乐高易网络有限公司 www.legaoyi.com 32 / 70
POST https://api.legaoyi.com/video/command/live/5.json
POST消息体:
前端应用开始播放视频(包括历史视频)时,定时(每隔5秒)调用该接口保持心跳,否则后台会自动关闭视频。
请求路径:
PUT ${host}/video/command/heartbeat/{streamId}.json
请求参数:
返回参数:
无
请求例子:
PUT https://api.legaoyi.com/video/command/heartbeat/1.json
POST消息体:
平台向车载设备发送停止实时音视频传输控制指令。
请求路径:
{ "channelId":1, "dataType":0, "streamType":1} 乐高易软件-乐高易车联网平台接口体系 www.legaoyi.com
广西乐高易网络有限公司 www.legaoyi.com 33 / 70
DELETE ${host}/video/command/live/{streamId}.json
请求参数:
返回参数:
无。
请求例子:
DELETE https://api.legaoyi.com/video/command/live/1.json
通过资源id开启录像回放指令接口(兼容JT809) 平台向车载设备发送开启录像回放指令。
请求路径:
POST ${host}/video/command/playback/{resourceId}.json
请求参数:
返回参数:
请求例子:
POST https://api.legaoyi.com/video/command/playback/1.json
POST消息体:
乐高易软件-乐高易车联网平台接口体系 www.legaoyi.com
广西乐高易网络有限公司 www.legaoyi.com 34 / 70
停止录像回放指令接口(兼容JT809)平台向车载设备发送停止录像回放指令。
请求路径:
DELETE ${host}/video/command/playback/{resourceId}.json
请求参数:
返回参数:
返回下行消息对象“DownstreamMessage”详情。
请求例子:
DELETE https://api.legaoyi.com/video/command/playback/1.json
平台向车载设备发送历史视频资源查询指令。平台会每天定时发送指令查询设备昨天的历史视频资源列表,但不包括今天在内。所以前端应用需要查询今天的历史视频资源时需要先发送改指令获取今天的历史视频资源列表,待车载设备应该成功之后,在调用“查询历史视频资源”接口即可获取历史视频资源列表。对于查询昨天的历史视频资源列表可发可不发送该指令。
请求路径:
POST ${host}/video/command/queryResource/{deviceId}.json
请求参数:
post消息体参数,逻辑通道号,0代表查询全部通道
post消息体参数,码流类型:
0:所有码流
1:主码流
2:子码流
post消息体参数,存储器类型:
0:所有存储器
1:主存储器;
2:灾备存储器
乐高易软件-乐高易车联网平台接口体系 www.legaoyi.com
广西乐高易网络有限公司 www.legaoyi.com 35 / 70
开始时间,格式:yyyy-MM-dd:hh:mm:ss
结束时间,格式:yyyy-MM-dd:hh:mm:ss
返回参数:
返回下行消息对象“DownstreamMessage”详情。
请求例子:
POST https://api.legaoyi.com/video/command/queryResource/5.json
POST消息体:
平台向车载设备发送上传历史视频文件指令。
请求路径:
POST ${host}/video/command/uploadFile/{resourceId}.json
请求参数:
返回参数:
返回下行消息对象“DownstreamMessage”详情。
请求例子:
POST https://api.legaoyi.com/video/command/uploadFile/1.json
POST消息体:
{ "channelId":0, "streamType":0, "storeType":0, "resourceType":0, "startTime":"2022-05-30 00:00:00", "endTime":"2022-05-31 00:00:00"} 乐高易软件-乐高易车联网平台接口体系 www.legaoyi.com
广西乐高易网络有限公司 www.legaoyi.com 36 / 70
平台向车载设备发送云台旋转指令。
请求路径:
POST ${host}/video/command/{deviceId}/9301.json
请求参数:
post消息体参数,方向
0:停止
1:上
2:下
3:左
4:右
返回参数:
返回下行消息对象“DownstreamMessage”详情。
请求例子:
POST https://api.legaoyi.com/video/command/5/9301.json
POST消息体:
平台向车载设备发送调整焦距控制指令。
{ "channelId":1, "direction":0, "speed":1} 乐高易软件-乐高易车联网平台接口体系 www.legaoyi.com
广西乐高易网络有限公司 www.legaoyi.com 37 / 70
请求路径:POST ${host}/video/command/{deviceId}/9302.json
请求参数:
返回参数:
返回下行消息对象“DownstreamMessage”详情。
请求例子:
POST https://api.legaoyi.com/video/command/5/9302.json
POST消息体:
平台向车载设备发送调整光圈控制指令。
请求路径:
POST ${host}/video/command/{deviceId}/9303.json
请求参数:
返回参数:
返回下行消息对象“DownstreamMessage”详情。
{ "channelId":1, "direction":0} 乐高易软件-乐高易车联网平台接口体系 www.legaoyi.com
广西乐高易网络有限公司 www.legaoyi.com 38 / 70
请求例子:POST https://api.legaoyi.com/video/command/5/9303.json
POST消息体:
平台向车载设备发送调整雨刷控制指令。
请求路径:
POST ${host}/video/command/{deviceId}/9304.json
请求参数:
返回参数:
返回下行消息对象“DownstreamMessage”详情。
请求例子:
POST https://api.legaoyi.com/video/command/5/9304.json
POST消息体:
{ "channelId":1, "type":0} { "channelId":1, "flag":0} 乐高易软件-乐高易车联网平台接口体系 www.legaoyi.com
广西乐高易网络有限公司 www.legaoyi.com 39 / 70
云台控制-红外补光控制指令接口平台向车载设备发送调整红外补光控制指令。
请求路径:
POST ${host}/video/command/{deviceId}/9305.json
请求参数:
返回参数:
返回下行消息对象“DownstreamMessage”详情。
请求例子:
POST https://api.legaoyi.com/video/command/5/9305.json
POST消息体:
平台向车载设备发送调变倍控制指令。
请求路径:
POST ${host}/video/command/{deviceId}/9306.json
请求参数:
{ "channelId":1, "flag":0} 乐高易软件-乐高易车联网平台接口体系 www.legaoyi.com
广西乐高易网络有限公司 www.legaoyi.com 40 / 70
返回参数:返回下行消息对象“DownstreamMessage”详情。
请求例子:
POST https://api.legaoyi.com/video/command/5/9306.json
POST消息体:
返回指定设备最新一条位置信息 。
请求路径:
GET ${host}/gps/device/{deviceId}/last.json.json
请求参数:
返回参数:
返回位置信息对象“Gps”详情
请求例子:
GET https://api.legaoyi.com/gps/device/1/last.json
返回指定车辆绑定的主设备最新一条位置信息。
请求路径:
GET ${host}/gps/car/{carId}/last.json.json
请求参数:
{ "channelId":1, "type":0} 乐高易软件-乐高易车联网平台接口体系 www.legaoyi.com
广西乐高易网络有限公司 www.legaoyi.com 41 / 70
返回参数:
返回位置信息对象“Gps”详情
请求例子:
GET https://api.legaoyi.com/gps/car/1/last.json
返回指定车辆绑定的主设备最新一条位置信息。
请求路径:
GET ${host}/gps/vin/{vin}/last.json.json
请求参数:
返回参数:
返回位置信息对象“Gps”详情
请求例子:
GET https://api.legaoyi.com/gps/vin/1/last.json
获取指定设备的位置信息。
请求路径:
GET ${host}/device/{deviceId}/location.json
请求参数:
返回参数:
返回位置信息对象“Gps”详情。
乐高易软件-乐高易车联网平台接口体系 www.legaoyi.com
广西乐高易网络有限公司 www.legaoyi.com 42 / 70
请求例子:GET https://api.legaoyi.com/device/1,2,3/location.json
获取指定指定车辆的位置信息。
请求路径:
GET ${host}/car/{carId}/location.json
请求参数:
返回参数:
返回位置信息对象“Gps”详情。
请求例子:
GET https://api.legaoyi.com/car/1,2,3/location.json
获取指定指定车辆的位置信息。
请求路径:
POST ${host}/device/location.json
请求参数:
返回参数:
返回位置信息对象“Gps”详情。
请求例子:
乐高易软件-乐高易车联网平台接口体系 www.legaoyi.com
广西乐高易网络有限公司 www.legaoyi.com 43 / 70
POST https://api.legaoyi.com/device/location.json?pageNo=1&pageSize=1000&isParent=true
POST消息体:
获取指定指定车辆的位置信息。
请求路径:
POST ${host}/car/location.json
请求参数:
返回参数:
返回位置信息对象“Gps”详情。
请求例子:
POST https://api.legaoyi.com/car/location.json?pageNo=1&pageSize=1000&isParent=true
POST消息体:
历史轨迹查询不支持跨天查询,如需要查询多天的历史轨迹需要按天分多次查询。
请求路径:
乐高易软件-乐高易车联网平台接口体系 www.legaoyi.com
广西乐高易网络有限公司 www.legaoyi.com 44 / 70
POST ${host}/common/query/gps.json
请求参数:
返回参数:
返回位置信息对象“Gps”列表详情。
请求例子:
POST https://api.legaoyi.com/common/query/gps.json?orderBy=time&pageSize=1000&pageNo=1
POST消息体:
获取指定指定车辆的位置信息。
请求路径:
{ "conditions":{ "enterpriseId.eq":"928280003", "deviceId.eq":"926050678311223296" }, "rangeConditions":[ { "fieldName":"time", "from":1661158794956, "includeLower":true, "includeUpper":true, "to":1661245202561 } ], "recordDate":"20220822"} 乐高易软件-乐高易车联网平台接口体系 www.legaoyi.com
广西乐高易网络有限公司 www.legaoyi.com 45 / 70
POST ${host}/area/car.json
请求参数:
type=1时有效,圆形中心经度,wgs84坐标系
type=1时有效,圆形中心纬度,wgs84坐标系
返回参数:
请求例子:
POST https://api.legaoyi.com/area/car.json
POST消息体:
乐高易软件-乐高易车联网平台接口体系 www.legaoyi.com
广西乐高易网络有限公司 www.legaoyi.com 46 / 70
请求路径:
POST ${host}/report/query/{collectionName}
请求参数:
url参数,是否统计下级企业,true or false
url参数,返回字段,如需返回所有字段则无需传此参数
url参数,是否降序(可选值:ture、 false)
//圆形{ "type":1, "area":{ "radius":3742234, "lat":42.11434041811337, "lng":97.12703872472136 }}//多边形,包括矩形{ "type":2, "area":{ "path":"74.76828044936637,47.434116381232734;150.357372,47.434914;150.357372,20.024128;74.768892404381,20.026433029991498" }}//省市区查车{ "type":3, "areaCode":"110000"} 乐高易软件-乐高易车联网平台接口体系 www.legaoyi.com
广西乐高易网络有限公司 www.legaoyi.com 47 / 70
post消息体参数(json格式),查询条件对象,支持and查询,key-value值,支持gt,gte,lt,lte,eq,neq,like操作
返回参数:
返回MongoDB集合对象“{collectionName}”列表详情。
请求例子:
POST https://api.legaoyi.com/report/query/device_alarm.json
POST消息体:
请求路径:
POST ${host}/report/sum/{collectionName}
请求参数:
url参数,是否统计下级企业,true or false
post消息体参数(json格式),查询条件对象,支持and查询,key-value值,支持gt,gte,lt,lte,eq,neq,like操作
返回参数:
返回MongoDB集合对象“{collectionName}” select字段的求和结果。
请求例子:
POST https://api.legaoyi.com/report/sum/enterprise_month_report.json?isParent=true&select=totalCar,legalMileage,drivingTime
{ "conditions":{ "carId.eq":1 }} 乐高易软件-乐高易车联网平台接口体系 www.legaoyi.com
广西乐高易网络有限公司 www.legaoyi.com 48 / 70
POST消息体:请求路径:
POST ${host}/report/listSum/{collectionName}
请求参数:
url参数,是否统计下级企业,true or false
url参数,是否降序(可选值:ture、 false)
post消息体参数(json格式),查询条件对象,支持and查询,key-value值,支持gt,gte,lt,lte,eq,neq,like操作
返回参数:
返回MongoDB集合对象“{collectionName}” select字段的求和结果。
请求例子:
POST https://api.legaoyi.com/report/listSum/enterprise_month_report.json?select=normalSpeedDrivingTime,lowSpeedDrivingTime,highSpeedDrivingTime,overSpeedDrivingTime&group=month&orderBy=month&desc=false&isParent=true
POST消息体:
{ "conditions":{ "month.eq":202208 }} 乐高易软件-乐高易车联网平台接口体系 www.legaoyi.com
广西乐高易网络有限公司 www.legaoyi.com 49 / 70
请求路径:
POST ${host}/report/pageSum/{collectionName}
请求参数:
url参数,是否统计下级企业,true or false
url参数,是否降序(可选值:ture、 false)
post消息体参数(json格式),查询条件对象,支持and查询,key-value值,支持gt,gte,lt,lte,eq,neq,like操作
返回参数:
返回MongoDB集合对象“{collectionName}” select字段的求和结果。
请求例子:
POST https://api.legaoyi.com/report/pageSum/enterprise_month_report.json?select=normalSpeedDrivingTime,lowSpeedDrivingTime,highSpeedDrivingTime,overSpeedDrivingTime&group=month&orderBy=month&desc=false&isParent=true
POST消息体:
{ "conditions":{ "month.eq":202208 }} 乐高易软件-乐高易车联网平台接口体系 www.legaoyi.com
广西乐高易网络有限公司 www.legaoyi.com 50 / 70
请求路径:
POST ${host}/report/count/{collectionName}
请求参数:
url参数,是否统计下级企业,true or false
post消息体参数(json格式),查询条件对象,支持and查询,key-value值,支持gt,gte,lt,lte,eq,neq,like操作
返回参数:
返回MongoDB集合对象“{collectionName}”对应的记录条数。
请求例子:
POST https://api.legaoyi.com/report/count/enterprise_month_report.json?isParent=true
POST消息体:
{ "conditions":{ "month.eq":202208 }} { "conditions":{ "month.eq":202208 }} 乐高易软件-乐高易车联网平台接口体系 www.legaoyi.com
广西乐高易网络有限公司 www.legaoyi.com 51 / 70
报表记录数量统计接口请求路径:
POST ${host}/report/distinctCount/{collectionName}
请求参数:
url参数,是否统计下级企业,true or false
post消息体参数(json格式),查询条件对象,支持and查询,key-value值,支持gt,gte,lt,lte,eq,neq,like操作
返回参数:
返回MongoDB集合对象“{collectionName}”对应的记录条数。
请求例子:
POST https://api.legaoyi.com/report/count/enterprise_month_report.json?isParent=true&distinct=month
POST消息体:
请求路径:
POST ${host}/report/sumAndCount/{collectionName}
请求参数:
url参数,是否统计下级企业,true or false
{ "conditions":{ "year.eq":2022 }} 乐高易软件-乐高易车联网平台接口体系 www.legaoyi.com
广西乐高易网络有限公司 www.legaoyi.com 52 / 70
post消息体参数(json格式),查询条件对象,支持and查询,key-value值,支持gt,gte,lt,lte,eq,neq,like操作
返回参数:
返回MongoDB集合对象“{collectionName}”对应的记录条数。
请求例子:
POST https://api.legaoyi.com/ report/sumAndCount/device_day_report.json?sum=legalMileage&group=carId&isParent=true&startDate=2022/08/21&endDate=2022/08/23
POST消息体:
请求路径:
POST ${host}/report/groupMax/{collectionName}
请求参数:
url参数,是否统计下级企业,true or false
post消息体参数(json格式),查询条件对象,支持and查询,key-value值,支持gt,gte,lt,lte,eq,neq,like操作
{ "conditions":{ " legalmileage.gt":800 }} 乐高易软件-乐高易车联网平台接口体系 www.legaoyi.com
广西乐高易网络有限公司 www.legaoyi.com 53 / 70
返回参数:
返回MongoDB集合对象“{collectionName}”对应的记录。
请求例子:
POST https://api.legaoyi.com/ report/groupMax/device_day_report.json?isParent=true&group=carId&max=todayMaxSpeed&pageNo=1&pageSize=10
POST消息体:
获取指定车辆日报表信息列表。
请求路径:
GET ${host}/report/car/dayReport/query
请求参数:
{ "conditions":{ }, "rangeConditions":[ { "fieldName":"date", "from":20220821, "includeLower":true, "includeUpper":true, "to":20220823 } ]} 乐高易软件-乐高易车联网平台接口体系 www.legaoyi.com
广西乐高易网络有限公司 www.legaoyi.com 54 / 70
返回参数: 返回车辆日报表对象“CarDayReport”列表详情。
请求例子:
GET https://api.legaoyi.com/report/car/dayReport/query.json? carId=1&startDate=2022/08/24&endDate=2022/08/24&select=a1,a2,a19
请求路径:
GET ${host}/report/car/dayReport/sum
请求参数:
返回参数:
返回车辆日报表对象“CarDayReport”列表详情。
请求例子:
GET https://api.legaoyi.com/report/car/dayReport/sum.json? carId=1&select=&startDate=2022/08/24&endDate=2022/08/24
条件统计车辆日报表信息列表。
请求路径:
POST ${host}/report/car/dayReport/sum
请求参数:
乐高易软件-乐高易车联网平台接口体系 www.legaoyi.com
广西乐高易网络有限公司 www.legaoyi.com 55 / 70
url参数,是否降序(可选值:ture、 false)
post消息体参数(json格式),查询条件对象,支持and查询,key-value值,支持gt,gte,lt,lte,eq,neq,like操作
返回参数:
返回车辆日报表对象“CarDayReport”列表详情。
请求例子:
POST https://api.legaoyi.com/report/car/dayReport/sum.json? startDate=2022/08/24&endDate=2022/08/24
POST消息体:
车辆日报表分页统计列表。
请求路径:
GET ${host}/report/car/dayReport/page/sum
请求参数:
url参数,是否降序(可选值:ture、 false)
{ "conditions":{ "carId.eq":1 }} 乐高易软件-乐高易车联网平台接口体系 www.legaoyi.com
广西乐高易网络有限公司 www.legaoyi.com 56 / 70
post消息体参数(json格式),查询条件对象,支持and查询,key-value值,支持gt,gte,lt,lte,eq,neq,like操作
返回参数:
返回车辆日报表对象“CarDayReport”列表详情。
请求例子:
POST https://api.legaoyi.com/report/car/dayReport/sum.json? startDate=2022/08/24&endDate=2022/08/24&pageSize=10&pageNo=1
POST消息体:
获取指定设备日报表信息列表。
请求路径:
GET ${host}/report/device/dayReport/query
请求参数:
返回参数:
返回设备日报表对象“DeviceDayReport”列表详情。
请求例子:
{ "conditions":{ "carId.eq":1 }} 乐高易软件-乐高易车联网平台接口体系 www.legaoyi.com
广西乐高易网络有限公司 www.legaoyi.com 57 / 70
GET https://api.legaoyi.com/report/device/dayReport/query.json? deviceId=1&startDate=2022/08/24&endDate=2022/08/24&select=a1,a2,a19
请求路径:
GET ${host}/report/device/dayReport/sum
请求参数:
返回参数:
返回设备日报表对象“DeviceDayReport”列表详情。
请求例子:
GET https://api.legaoyi.com/report/device/dayReport/sum.json? deviceId=1&select=&startDate=2022/08/24&endDate=2022/08/24
条件统计设备日报表信息列表。
请求路径:
POST ${host}/report/device/dayReport/sum
请求参数:
乐高易软件-乐高易车联网平台接口体系 www.legaoyi.com
广西乐高易网络有限公司 www.legaoyi.com 58 / 70
url参数,是否降序(可选值:ture、 false)
post消息体参数(json格式),查询条件对象,支持and查询,key-value值,支持gt,gte,lt,lte,eq,neq,like操作
返回参数:
返回设备日报表对象“DeviceDayReport”列表详情。
请求例子:
POST https://api.legaoyi.com/report/device/dayReport/sum.json? startDate=2022/08/24&endDate=2022/08/24
POST消息体:
设备日报表分页统计列表。
请求路径:
GET ${host}/report/device/dayReport/page/sum
请求参数:
url参数,是否降序(可选值:ture、 false)
post消息体参数(json格式),查询条件对象,支持and查询,key-value值,支持gt,gte,lt,lte,eq,neq,like操作
{ "conditions":{ "deviceId.eq":1 }} 乐高易软件-乐高易车联网平台接口体系 www.legaoyi.com
广西乐高易网络有限公司 www.legaoyi.com 59 / 70
返回参数:
返回设备日报表对象“DeviceDayReport”列表详情。
请求例子:
POST https://api.legaoyi.com/report/device/dayReport/sum.json? startDate=2022/08/24&endDate=2022/08/24&pageSize=10&pageNo=1
POST消息体:
获取指定司机日报表信息列表。
请求路径:
GET ${host}/report/driver/dayReport/query
请求参数:
返回参数:
返回司机日报表对象“DriverDayReport”列表详情。
请求例子:
GET https://api.legaoyi.com/report/driver/dayReport/query.json? driverId=1&startDate=2022/08/24&endDate=2022/08/24&select=a1,a2,a19
{ "conditions":{ "deviceId.eq":1 }} 乐高易软件-乐高易车联网平台接口体系 www.legaoyi.com
广西乐高易网络有限公司 www.legaoyi.com 60 / 70
司机日报表求和接口请求路径:
GET ${host}/report/driver/dayReport/sum
请求参数:
返回参数:
返回司机日报表对象“DriverDayReport”列表详情。
请求例子:
GET https://api.legaoyi.com/report/driver/dayReport/sum.json? driverId=1&select=&startDate=2022/08/24&endDate=2022/08/24
条件统计司机日报表信息列表。
请求路径:
POST ${host}/report/driver/dayReport/sum
请求参数:
url参数,是否降序(可选值:ture、 false)
post消息体参数(json格式),查询条件对象,支持and查询,key-value值,支持gt,gte,lt,lte,eq,neq,like操作
乐高易软件-乐高易车联网平台接口体系 www.legaoyi.com
广西乐高易网络有限公司 www.legaoyi.com 61 / 70
返回参数: 返回司机日报表对象“DriverDayReport”列表详情。
请求例子:
POST https://api.legaoyi.com/report/driver/dayReport/sum.json? startDate=2022/08/24&endDate=2022/08/24
POST消息体:
司机日报表分页统计列表。
请求路径:
GET ${host}/report/driver/dayReport/page/sum
请求参数:
url参数,是否降序(可选值:ture、 false)
post消息体参数(json格式),查询条件对象,支持and查询,key-value值,支持gt,gte,lt,lte,eq,neq,like操作
返回参数:
返回司机日报表对象“DriverDayReport”列表详情。
请求例子:
{ "conditions":{ "carId.eq":1 }} 乐高易软件-乐高易车联网平台接口体系 www.legaoyi.com
广西乐高易网络有限公司 www.legaoyi.com 62 / 70
POST https://api.legaoyi.com/report/driver/dayReport/sum.json? startDate=2022/08/24&endDate=2022/08/24&pageSize=10&pageNo=1
POST消息体:
获取司机今日统计信息。
请求路径:
GET ${host}/report/driver/dayReport/today/{driverId}
请求参数:
返回参数:
返回司机日报表对象“DriverDayReport”列表详情。
请求例子:
GET https://api.legaoyi.com/report/driver/dayReport/today/1.json
获取司机统计缓存信息。
请求路径:
GET ${host}/report/driver/statCache/{driverId}
请求参数:
{ "conditions":{ "driverId.eq":1 }} 乐高易软件-乐高易车联网平台接口体系 www.legaoyi.com
广西乐高易网络有限公司 www.legaoyi.com 63 / 70
返回参数:
返回司机日报表对象“DriverDayReport”列表详情
请求例子:
GET https://api.legaoyi.com/report/driver/statCache/1.json
获取指定企业日报表信息列表。
请求路径:
GET ${host}/report/enterprise/dayReport/query
请求参数:
返回参数:
返回企业日报表对象“EnterpriseDayReport”列表详情。
请求例子:
GET https://api.legaoyi.com/report/enterprise/dayReport/query.json? enterpriseId=1&startDate=2022/08/24&endDate=2022/08/24&select=a1,a2,a19
统计指定日期范围内的企业日报表。
请求路径:
GET ${host}/report/enterprise/dayReport/sum
请求参数:
乐高易软件-乐高易车联网平台接口体系 www.legaoyi.com
广西乐高易网络有限公司 www.legaoyi.com 64 / 70
返回参数:
返回企业日报表对象“EnterpriseDayReport”列表详情。
请求例子:
GET https://api.legaoyi.com/report/enterprise/dayReport/sum.json? enterpriseId=1&select=&startDate=2022/08/24&endDate=2022/08/24
条件统计企业日报表信息列表。
请求路径:
POST ${host}/report/enterprise/dayReport/sum
请求参数:
url参数,是否降序(可选值:ture、 false)
post消息体参数(json格式),查询条件对象,支持and查询,key-value值,支持gt,gte,lt,lte,eq,neq,like操作
返回参数:
返回企业日报表对象“EnterpriseDayReport”列表详情。
请求例子:
POST https://api.legaoyi.com/report/enterprise/dayReport/sum.json? startDate=2022/08/24&endDate=2022/08/24
乐高易软件-乐高易车联网平台接口体系 www.legaoyi.com
广西乐高易网络有限公司 www.legaoyi.com 65 / 70
POST消息体:在火狐浏览器中打开restclient插件,如下:
参考上一章节的接口文档,在插件中输入请求方法(POST)、请求url(http://api.legaoyi.com/common/query/device.json)以及请求消息体(查找在线设备:{"state.eq":3}),如下图:
{ "conditions":{ "year.eq":2022 }} 乐高易软件-乐高易车联网平台接口体系 www.legaoyi.com
广西乐高易网络有限公司 www.legaoyi.com 66 / 70
步骤三添加HTTP头字段,如下图:
增加HTTP头字段,选择“自定义HTTP头字段”,如下图:
在弹出的对话框中,输入“Content-Type”以及
乐高易软件-乐高易车联网平台接口体系 www.legaoyi.com
广西乐高易网络有限公司 www.legaoyi.com 67 / 70
“application/json;charset=UTF-8”,如下图:
点击“发送”按钮,如下图:
查询结果如下:
乐高易软件-乐高易车联网平台接口体系 www.legaoyi.com
广西乐高易网络有限公司 www.legaoyi.com 68 / 70
乐高易软件-乐高易车联网平台接口体系 www.legaoyi.com
广西乐高易网络有限公司 www.legaoyi.com 69 / 70
"code": 0,
"message": "success",
"data": {
"alarmFlag": "00000000000000000000000000000000",
"statusFlag": "11001000000000000000000000000000",
"lng": "108.721721",
"lat": "34.472976",
"altitude": 500,
"speed": 63.0,
"direction": 153,
"gpsTime": 1531443746000,
"mileage": 6530.0,
"oilmass": 19.9,
"dvrSpeed": 71.5,
"alarmEventId": 0,
"networkSignalNum": 0,
"gpsSatelliteNum": 0,
"_id": "8723008037d04040a38efde64f5092a1"
}
}
请求方法:POST
请求URL:
http://api.legaoyi.com/common/query/gps.json?select=lng,lat&orderBy=time&pageSize=500&pageNo=1
消息体:
{
"recordDate":"20180713",
"conditions":{
"deviceId.eq":"2c9299d4612266f2016122c1a0340010"
},
"rangeConditions":[
{
"fieldName":"gpsTime",
"from":1531432800000,
"includeLower":true,
"includeUpper":true,
"to":1531454399000
}
]
}
乐高易软件-乐高易车联网平台接口体系 www.legaoyi.com
广西乐高易网络有限公司 www.legaoyi.com 70 / 70
返回结果:{
"code": 0,
"message": "success",
"data": [{
"_id": "c4a5fc6891fb46e2b9d47e9a40623a24",
"lng": "108.78053",
"lat": "34.459673"
}, {
"_id": "05edaca30ee04d2db591b68ba19372d0",
"lng": "108.780543",
"lat": "34.459658"
}, {
"_id": "1ab93d46f8f04365bbf76b7c489c24e1",
"lng": "108.780538",
"lat": "34.459633"
}, {
"_id": "a2a7094692dc4149800ab2ef535628b0",
"lng": "108.780533",
"lat": "34.459648"
}, {
"_id": "d3f61cb1724c4386a35967a5c4f55fa6",
"lng": "108.780535",
"lat": "34.459633"
}]
}