Appearance
数据交换格式
请求方式 GET 和 POST
GET和POST方式都支持,建议查询时用GET ,有修改操作用POST
json
{
auth_code:"abcd...", //string 授权码 (必填)
request_content:"请求内容",//string 格式化的json字符串(必填)
timestamp: 1521688597 ,//int 发起请求时的服务器时间戳 (必填)
notify_url:"www.baidu.com",//string (可带GET参数) (同步的请求不需要 ,有异步通知时需要)
sign:"efg...",//string 签名 (必填)
}
request_content 字段内容请使用json格式化为string类型。 http协议请求头 Content-Type 支持 application/json 和 application/x-www-form-urlencoded 两种
接口数据设计
- 为什么返回的数据都是当前所有的数据?
- 性能考虑:对于大数据集,按照特定顺序排序(如设备编号)可能会增加计算复杂度,降低数据处理的效率。尤其是当数据量非常大时,这种影响会更加明显。
- 很多人会不考虑性能问题,会批量的发起单个设备查询的请求。这样会导致服务器压力过大,甚至会导致服务器宕机。
性能限制
- 异步接口中参数
request_content
是个数组,多个设备同时操作可以合并 到一个数组中 发起请求(批量操作请合并)。 - 每小时最多提交100次(http请求),每次最多提交1000个设备操作(抄表,操作,充值),超出不处理。
- 流量卡有流量限制,请合理使用。
- 系统有定时抄表功能,无需进行冗余的定时抄表。