CR02E及CR02EU设备与服务器通讯,采用的Http协议通讯,设备主动发起请求,POST提交,设备为客户端,服务器端必须实现的两个接口心跳接口(IsConnect)与数据上传接口(CheckCode)。接口发布后,请按以下方式检查是否正确。
测试接口
1)、测试方法一
使用我司提供的[接口测试工具],分别对IsConnect与CheckCode进行测试。测试方式:先将发布的http地址输入至[服务器地址]文本框,地址不包含接口名称,点击 [心跳接口]及[数据上传],返回如下则表示接口正确:
若响应结果与提示格式不一致,请检查代码及服务器设置;
2)、测试方法二
使用Postman对接口进行测试
测试心跳接口,提交类型选择POST,Headers中添加Key/Value,分别为Content-Type/application/x-www-form-urlencoded,如下图所示:
地址栏包含接口名称;
BODY的内容为字符串,因此选择raw及Text;
请求参数示例:
paramaters={“ViewId”:”V123″,”UID”:”U123″,”UKey”:”ABCD12345678″,”SN”:”1802010024″}
注:请求参数在JSON字符串前,增加paramaters=,数据返回参数则为JSON,如下图所示:
测试数据上传接口,提交方式/Headers与心跳接口相同;
请求参数示例:
paramaters={“CodeVal”:”999985″,”CodeType”:”Q”,”BrushTime”:”2018-06-27 16:47:46″,”ViewId”:”V123″,”UID”:”U123″,”UKey”:”ABCD12345678″,”IsOnline”:”1″,”SN”:”1802010023″}
如下图所示:
若响应结果非上述的JSON格式,请检查代码及服务器设置;
接口设置到设备
按上述方法测试接口正常后,可将接口地址设置到设备。
点击[生成二维码],并使用设备扫码,”Card”图标亮绿色及CR02EU屏幕显示“数据保存中…”,表示配置成功,否则为配置失败,请检查设备密码或其它设置。
扫码配置后,约10S后设备会自动请求心跳接口,若能正常连接,CR02E的”Card”图标蓝灯常亮,CR02EU屏幕右上角显示”E”图标。
其它
- 请求参数,在JSON字符串前有增加paramaters=,而响应参数则无;
- 若是Apache服务器,需关闭数据压缩,关闭方法,请参考“Apache关闭数据压缩”;
- JSON字段值区分大小写,请严格对照文档进行编写;