签名和文档说明

README.md

+# 签名信息
+alias SOS
+passsword 123456
+
+# 定制终端调用API接口说明
+文档修改说明：
+【2019-3-14】添加配置项返回，增加终端上传数据的频率空着，满足个性化需求的前提下最大限度优化终端功耗，红色为本次修改新增
+【2019-3-15】完善配置交换机制，红色为本次修改新增
+
+
+1 定制机定位信息上传接口
+1.1 接口名称
+功能机定位信息上传接口(/cstmzPosition)
+1.2接口描述
+接口地址：http://202.100.190.58:8090/api/cstmzPosition
+返回格式：JSON
+请求方式：GET/ POST
+请求示例：
+http://202.100.190.58:8088/api/cstmzPosition?longitude=87.5775380&latitude=43.8951940&meid=A100006069E0F8&time=2019-03-10%2011:53:33&tel=13319801000&model=HBA7+&cfgv=2019031512
+接口备注：用于定制机上传位置信息，使用前需要先在系统中绑定用户的MEID信息，如果未绑定，后台服务将直接丢弃该定位信息。
+1.3 请求参数说明（入参）
+参数名	类型	说明	默认值	举例	必选
+longitude	string	经度	必填无默认	87.5775380	是
+latitude	string	纬度	必填无默认	43.8951940	是
+meid	string	移动设备识别码	必填无默认	A100006069E0F8	是
+time	string	手机侧获取位置的时间（格式要求：yyyy-mm-dd hh24:mi:ss）	必填无默认	2019-03-10%2011:53:33	是
+tel	string	手机号码	获取不到填0		是
+iccid	string	SIM卡卡号	获取不到填0		是
+imsi	string	用户SIM卡识别码	获取不到填0		是
+model	string	机型编码	必填无默认	BHA7	是
+cfgv	String	配置版本	第一次预制ROM中的，不是服务器下发的配置，传0，后续按系统返回上传		是
+
+机型编码
+model	名称	厂商	说明
+BHA7	百合A7+	百合	3.5寸屏  1+16 按键智能机
+HBA18L	百合A18L	百合	F12  5寸屏  1+16   智能机
+GXEF36	广信EF36	广信	3.5寸屏  1+16 按键智能机
+GXF12	广信F12	广信	F12  5寸屏  1+16   智能机
+			
+
+
+
+1.4 返回参数说明（出参）
+参数名	类型	说明	举例
+ret_code	int	返回结果（
+成功：0，
+配置变化：1，
+失败：错误码）	0
+ret_message	string	当返回结果为成功时，该字段返回success，当返回结果为失败时，该字段返回错误信息。	success
+以下ret_code 为 1 时返回，0和错误不返回
+url	string	配置 url地址	不变化返回 0
+time_span	int	上传时间间隔,约定999999 再不上传数据	不变化返回 0
+cfgv	string	配置版本号	2019031512
+情况1、正常返回JSON返回示例：
+{
+"ret_code": 0,
+"ret_message": "success"
+}
+
+情况2、配置变化JSON返回示例：
+{
+"ret_code": 1,
+"ret_message": "config",
+"url": "http://202.100.190.58:8090/api/cstmzPosition",
+"time_span": 30,
+"cfgv": "2019031513",
+
+}
+
+1.5 错误码参照
+错误码	说明
+201001	入参错误：MEID无效
+201002	入参错误：经纬度信息无效
+100001	服务错误：内部处理错误
+
+ 
+注意：为了避免接口返回URL地址错误，导致再无法获取配置信息，请做如下异常保障：
+1、保留隐藏菜单设置参数，功能（必须支持）
+2、对修改配置后长时间（建议4小时）连接失败，建议保留前一个配置版本，进行配置回退（非必须支持，可自行处理）
+
+测试服务器地址：
+http://202.100.179.139:8088/api
+
+测试规则说明：
+传入cfgv <= YYYYMMDDHH 下发配置，切换至url http://202.100.179.139:8088/api_b
+时间间隔为 1-5的随机数
+