wifidog认证Wiwiz Query API参考手册与接口规范
功能描述
Wiwiz Query API是Wiwiz HotSpot Builder提供的基于Web的外部开发接口。调用它可以用于查询以下信息:
- 当前热点连接信息
- 热点的连接履历
- 热点使用者在使用热点认证时输入的手机号码
使用条件与要求
1.已拥有Wiwiz专业版账户。
2.查询Wiwiz账户的User Key(*注1)
调用概要
调用Wiwiz Query API时,用户需向指定URL发送HTTP请求,发送请求时应根据接口规范指定参数(GET或POST方式皆可)。查询的结果数据以HTTP响应的形式(XML格式)返回。
无报错情况下的HTTP响应数据的格式样例:
<?xml version="1.0" encoding="UTF-8"?>
<result>
<status>
<code>OK</code>
<message>Query Completed</message>
</status>
<data>
<record>
……
</record>
<record>
……
</record>
……
</data>
</result>
有报错情况下的HTTP响应数据的格式样例:
<?xml version="1.0" encoding="UTF-8"?>
<result>
<status>
<code>STATUS CODE</code>
<message>STATUS CODE DESCIRPTION</message>
</status>
<data></data>
</result>
接口规范
- 查询当前热点连接信息
请求URL: http://cp.wiwiz.com/as/qapi/conn/
请求参数说明:
返回数据说明:
- 查询热点的连接履历
请求URL: http://cp.wiwiz.com/as/qapi/connlog/
请求参数说明:
返回数据说明:
- 查询热点使用者在使用热点认证时输入的手机号码
请求URL: http://cp.wiwiz.com/as/qapi/mobile/
请求参数说明:
返回数据说明:
注解
注1:User Key可在Wiwiz Web面板的“用户菜单”->“升级选项”->“查询User Key”中查询。
注2:状态码说明:
注3:国家地区代码的含义:
AR:阿根廷
AT:奥地利
AU:澳大利亚
BE:比利时
BR:巴西
CA:加拿大
CH:瑞士
CN:中国
DE:德国
DK:丹麦
ES:西班牙
FR:法国
GB:英国
HK:中国香港特别行政区
ID:印度尼西亚
IE:爱尔兰
IL:以色列
IN:印度
IT:意大利
JO:约旦
JP:日本
KR:韩国
KY:开曼群岛
LU:卢森堡
MO:中国澳门特别行政区
MX:墨西哥
MY:马来西亚
NL:荷兰
NO:挪威
NZ:新西兰
PH:菲律宾
PK:巴基斯坦
PL:波兰
SE:瑞典
SG:新加坡
TH:泰国
TR:土耳其
TW:台湾
US:美国
ZA:南非
本文章由 http://www.wifidog.pro/2015/03/23/wifidog%E8%AE%A4%E8%AF%81wiwiz-query-API.html 整理编辑,转载请注明出处