相关文档

>> GServer实时接口(JSON)示例说明

GServer实时接口(JSON)说明：

本规范规定了直接接入EXLIVE平台GServer应用服务器的接口定义，采用TCP通讯方式，实现了用户登录、权限验证、各种数据传输等功能。

本规范主要用来实现第三方软件和GServer服务器实时互通，采用TCP传输方式，端口为1502，数据格式使用json格式。

数据分为数据头(header)和数据体(body)两个部分。

数据头(header)部分格式为：

"header":
{
"cmd":"1000"
}

格式主要包含一个命令字(cmd)属性，程序根据命令字来区分数据体的内容。数据体(body)部分包含的数据会根据数据头中的命令字(cmd)而异。

第三方平台数据转入EXLIVE平台步骤：

>> 获取一个EXLIVE平台帐号

>> 以TCP方式登录EXLIVE平台1502端口，参考用户登录命令1000

>> 等待exlive平台登录返回成功，如果返回结果不是success服务器将掐断TCP连接

>> 收到成功后，第三方平台需要间隔30秒发送心跳消息，参看客户端心跳　1002

>> 连接成功后，第三方平台可以按照　车辆定位数据 1007　格式上传车辆数据

>> 第三方平台退出连接可以发送　用户退出 1001命令，然后断开TCP连接

自己开发客户端接入EXLIVE平台GServer服务器步骤：

>> 获取一个EXLIVE平台帐号
>> 以TCP方式登录EXLIVE平台1502端口，参考用户登录命令1000
>> 等待exlive平台登录返回成功，如果返回结果不是success服务器将掐断TCP连接
>> 收到成功后，第三方平台需要间隔30秒发送心跳消息，参看客户端心跳　1002
>>请求下发用户下客户和分组数据 1008
>>请求下发每个分组下的车辆数据　1010
>> 服务器向客户端转发车辆的实时定位数据　1007
>>客户端向车载终端下发车机命令　1003
>> 客户端退出连接，发送退出命令 1001，然后断开TCP连接

1.用户从客户端登录GServer服务器

数据发送方向：client —> server

命令字：1000

参数

格式：

{
　"header":
　{
　　"cmd":"1000"
　},
　"body":
　{
　　"name":"exlive",
　　"pass":"000000",
　　"ver":"4.6936",
　　"type":"json_common",
　　"mode":""
　}
}

2.服务器对客户端发送命令返回的通用应答

数据发送方向：server —> client

命令字：8000

参数：

格式：

{
　"header":
　{
　　"cmd":"8000"
　},
　"body":
　{
　　"cmd":"1000",
　　"result":"success"
　}
}

3.用户从客户端退出/注销登录

数据发送方向：client —> server

命令字：1001

参数：

格式：

{
　"header":
　{
　　"cmd":"1001"
　},
　"body":
　{
　　"data":""
　}
}

4.客户端向服务器发送心跳消息

数据发送方向：client —> server

命令字：1002

客户端登录成功后，需要按照30秒间隔向服务器发送心跳消息，如果3分钟没有收到客户端发送的心跳消息，服务器端将主动断开客户端的连接

参数：

格式：

{
　"header":
　{
　　"cmd":"1002"
　},
　"body":
　{
　　"result":""
　}
}

5.服务器向客户端发送通知消息

数据发送方向：client <—> server

命令字：1003

参数：

格式：

{
　"header":
　{
　　"cmd":"1003"
　},
　"body":
　{
　　"msg":""
　}
}

6.客户端向车载终端发送车机命令

数据发送方向：client —> server

命令字：1004

参数：

格式：

{
　"header":
　{
　　"cmd":"1004"
　},
　"body":
　{
　　"terminalid":"",
　　"code":"",
　　"cmdid":"7004",
　　"cmdpass":"",
　　"data":"<cmd><id>7000</id><param>上报间隔</param><para>上报次数</param><param>命令密码</param></cmd>"
　}
}

7.服务器向客户端转发车辆实时定位数据

数据发送方向：server —> client

命令字：1007

参数：

格式：

{
　"header":
　{
　　"cmd":"1007"
　},
　"body":
　{
　　"code":"",
　　"id":"",
　　"lat":"",
　　"lng":"",
　　"veo":"",
　　"dir":"",
　　"gpstime":"",
　　"av":"",
　　"alarm":"",
　　"oil":"",
　　"dis":"",
　　"wstate":"",
　　"cstate":"",
　　"posinfo":"",
　　"p1":"",
　　"p2":"",
       "temp":,
       "temp0":,
       "temp1":,
       "temp2":,
       "temp3":
　}
}

8.客户端请求服务器下发用户权限下客户及分组数据

数据发送方向：client —> server

命令字：1008

参数：

格式：

{
　"header":
　{
　　"cmd":"1008"
　},
　"body":
　{
　　"client":"true"
　}
}

9.服务器向客户端下发用户的客户、分组数据

数据发送方向：client —> server

命令字：1009

参数：

格式：

{
　"header":
　{
　　"cmd":"1009"
　},
　"body":
　{
　　"groupid":"",
　　"relation":"",
　　"customer":"",
　　"goupname":""
　}
}

10.客户端请求服务器下发用户权限下分组的车辆数据

数据发送方向：client —> server

命令字：1010

参数：

格式：

{
　"header":
　{
　　"cmd":"1010"
　},
　"body":
　{
　　"groupid":"1"
　}
}

11.服务器向客户端下发用户权限下指定分组的车辆静态数据

数据发送方向：server —> client

命令字：1011

参数：

格式：

{
　"header":
　{
　　"cmd":"1011"
　},
　"body":
　{
　　"id":"",
　　"code":"",
　　"sim":"",
　　"terminalid":"",
　　"groupname":"",
　　"vhctype":"",
　　"mobiletype":""
　}
}

12.客户端发送车机透传命令到设备

数据发送方向：client —> server

命令字：1012

参数：

格式：

{
　"header":
　{
　　"cmd":"1012"
　},
　"body":
　{
　　"terminalid":"",
　　"code":"",
　　"cmdid":"",　
　　"cmdpass":"",
　　"data":""
　}
}

13.服务器转发车载终端的透传数据到客户端

数据发送方向：server —> client

命令字：1013

参数：

格式：

{
　"header":
　{
　　"cmd":"1013"
　},
　"body":
　{
　　"terminalid":"",
　　"code":"",
　　"data":""
　}
}