分类 wifidog分析下的文章

wifidog 认证 Wiwiz Setup API参考手册与接口规范(2)

作者: 佐须之男
时间: March 23, 2015
分类: wifidog认证,wifidog安装,wifidog原理,wifidog分析,wifidog-ddwrt

紧接上文。

5.7 添加电子招待券
请求参数说明：

返回数据示例与说明：

<?xml version="1.0" encoding="UTF-8"?>
<result>
    <status>
        <!-- code: 调用结果状态码。
            值为OK代表调用成功；如果为以ERR开头的文字，则代表错误 -->
        <code>OK</code>
        <!-- message: 调用结果状态说明（供调试参考）-->
        <message>Voucher Created</message>
    </status>
</result>

5.8 修改电子招待券
请求参数说明：

返回数据示例与说明：

OK

Voucher Changed

5.9 删除电子招待券
请求参数说明：

返回数据示例与说明：

<?xml version="1.0" encoding="UTF-8"?>
<result>
    <status>
        <!-- code: 调用结果状态码。
            值为OK代表调用成功；如果为以ERR开头的文字，则代表错误 -->
        <code>OK</code>
        <!-- message: 调用结果状态说明（供调试参考）-->
        <message>Voucher Deleted</message>
    </status>
</result>

5.10 删除全部电子招待券
请求参数说明：

返回数据示例与说明：

<?xml version="1.0" encoding="UTF-8"?>
<result>
    <status>
        <!-- code: 调用结果状态码。
            值为OK代表调用成功；如果为以ERR开头的文字，则代表错误 -->
        <code>OK</code>
        <!-- message: 调用结果状态说明（供调试参考）-->
        <message>All Vouchers Deleted</message>
    </status>
</result>

5.11 查询访问控制规则
请求参数说明：

返回数据示例与说明：

<?xml version="1.0" encoding="UTF-8"?>
<result>
    <status>
        <!-- code: 调用结果状态码。
            值为OK代表调用成功；如果为以ERR开头的文字，则代表错误 -->
        <code>OK</code>
        <!-- message: 调用结果状态说明（供调试参考）-->
        <message>Operation Completed</message>
</status>
    <data> <!-- 仅在code为OK时出现 -->
        <record> <!-- 每个record标签代表一条访问控制规则记录 -->
            <mac_id>224</mac_id> <!-- 访问控制记录的唯一存储标识 -->
            <mac>00:50:56:C0:00:08</mac> <!-- MAC地址 -->
            <action>1</action> <!-- 控制规则。0代表屏蔽；1代表放行；2代表免认证 -->
            <memo>Hello, world!</memo> <!-- 备注信息 -->
        </record>
    </data>
</result>

5.12 添加访问控制规则
请求参数说明：

返回数据示例与说明：

<?xml version="1.0" encoding="UTF-8"?>
<result>
    <status>
        <!-- code: 调用结果状态码。
            值为OK代表调用成功；如果为以ERR开头的文字，则代表错误 -->
        <code>OK</code>
        <!-- message: 调用结果状态说明（供调试参考）-->
        <message>MAC Added</message>
    </status>
</result>

5.13 修改访问控制规则
请求参数说明：

返回数据示例与说明：

<?xml version="1.0" encoding="UTF-8"?>
<result>
    <status>
        <!-- code: 调用结果状态码。
            值为OK代表调用成功；如果为以ERR开头的文字，则代表错误 -->
        <code>OK</code>
        <!-- message: 调用结果状态说明（供调试参考）-->
        <message>MAC Changed</message>
    </status>
</result>

5.14 删除访问控制规则
请求参数说明：

返回数据示例与说明：

<?xml version="1.0" encoding="UTF-8"?>
<result>
    <status>
        <!-- code: 调用结果状态码。
            值为OK代表调用成功；如果为以ERR开头的文字，则代表错误 -->
        <code>OK</code>
        <!-- message: 调用结果状态说明（供调试参考）-->
        <message>MAC Deleted</message>
    </status>
</result>

本文章由 http://www.wifidog.pro/2015/03/23/wifidog-Wiwiz-Setup-API-2.html 整理编辑，转载请注明出处

wifidog 认证 Wiwiz Setup API参考手册与接口规范

作者: 佐须之男
时间: March 23, 2015
分类: wifidog认证,wifidog安装,wifidog原理,wifidog分析,wifidog配置

1. 功能描述
Wiwiz Setup API是Wiwiz HotSpot Builder提供的基于Web的外部开发接口。调用它可以用于查询热点信息，创建、修改、删除热点，查询、添加、删除电子招待券，查询、创建、修改、删除访问控制规则等。

2. 使用条件与准备工作

已拥有Wiwiz专业版账户。
查询Wiwiz账户的User Key。
查询User Key的方法是：登录Wiwiz Web面板，点击“用户菜单”页面上的“升级选项”->“查询User Key”。

3. 调用概要
调用本API时，用户需向指定URL发送HTTP请求，发送请求时应根据接口规范指定参数（POST方式）。结果数据以HTTP响应的形式（XML格式）返回。

4. 共通说明

请求URL：
所有的请求都必须发送至 http://cp.wiwiz.com/as/s/setupapi/
所有的HTTP请求参数必须以HTTP POST的方式传送。
共通请求参数：
所有的请求都必须包含以下HTTP请求参数：

5. 接口规范
5.1. 查询热点基本信息
请求参数说明：

返回数据示例与说明：

<?xml version="1.0" encoding="UTF-8"?>
<result>
　　<status>
        <!-- code: 调用结果状态码。
            值为OK代表调用成功；如果为以ERR开头的文字，则代表错误（*注1） -->
　　    <code>OK</code>
　　    <!-- message:  调用结果状态说明（供调试参考） -->
　　    <message>Operation Completed</message>
　　</status>
　　<data> <!-- 仅在code为OK时出现 -->
　　    <record> <!-- 每个record标签代表一条热点信息记录 -->
　　        <hotspot_id>1374085CF3C</hotspot_id> <!-- HotSpot ID -->
　　        <name>XXXXXX</name> <!-- 热点名称 -->
　　        <running_status>1</running_status> <!-- 认证接受状态。1代表接受认证，0代表拒绝认证 -->
　　    </record>
　　</data>
</result>

5.2. 查询热点详细设置信息
请求参数说明：

返回数据示例与说明：

<?xml version="1.0" encoding="UTF-8"?>
<result>
    <status>
        <!-- code: 调用结果状态码。
            值为OK代表调用成功；如果为以ERR开头的文字，则代表错误 -->
        <code>OK</code>
        <!-- message:  调用结果状态说明（供调试参考） -->
        <message>Query Completed</message>
    </status>
<data> <!-- 仅在code为OK时出现 -->
        <name>XXXXXX</name> <!-- 热点名称-->
        <running_status>1</running_status> <!-- 认证接受状态。1代表接受认证，0代表拒绝认证 -->
        <location>XXXX</location> <!-- 地点/街道地址 -->
        <timezone>Etc/GMT-8</timezone> <!-- 所在时区 -->
        <longitude></longitude> <!-- 经度 -->
        <latitude></latitude> <!-- 纬度 -->
        <owner_name>XXXX</owner_name> <!-- 管理员姓名 -->
        <owner_contact>XXXX</owner_contact> <!-- 管理员联系方式 -->
        <auth_agree>0</auth_agree> <!-- 要求认同条款认证方式。1代表启用，0代表禁用 -->
        <auth_voucher>0</auth_voucher> <!-- 电子招待券认证方式。1代表启用，0代表禁用 -->
        <auth_login>1</auth_login> <!-- 要求登录认证方式。1代表启用，0代表禁用 -->
        <logintype>0</logintype> <!-- 0代表“Wiwiz.com注册用户”方式，1代表“自定义账户”方式 -->
        <single_login>0</single_login> <!-- 禁止同一用户同时使用多个客户端。1代表启用，0代表禁用 -->
        <auth_api>0</auth_api> <!-- 调用Wiwiz Auth API认证方式。1代表启用，0代表禁用 -->
        <authapi_url></authapi_url> <!-- 认证URL（Wiwiz Auth API） -->
        <auth_sms>0</auth_sms> <!-- 手机验证认证方式。1代表启用，0代表禁用 -->
        <phone_country></phone_country> <!-- 国家地区代码（手机验证） -->
        <phone_repeat_interval>1</phone_repeat_interval> <!-- 重复验证间隔（手机验证） -->
        <phone_valid_interval>30</phone_valid_interval> <!-- 验证码有效期（手机验证） -->
        <phone_resend>0</phone_resend> <!-- 允许验证码有效期内重发短信（手机验证）。1代表启用，0代表禁用 -->
        <phone_maxtimes>5</phone_maxtimes> <!-- 每号码每日限制次数（手机验证） -->
        <phone_onlyonce>0</phone_onlyonce> <!-- 验证码仅限使用一次（手机验证）。1代表启用，0代表禁用 -->
        <phone_blacklst></phone_blacklst> <!-- 手机号码黑名单（手机验证）。多个值以“;”字符间隔 -->
        <phone_magic_code></phone_magic_code> <!-- 万能验证码（手机验证）。多个值以“;”字符间隔 -->
        <timeout>10</timeout> <!-- 认证超时 -->
        <isfree>0</isfree> <!-- 认证是否收取费用。1代表收费，0代表免费 -->
        <fee_min></fee_min> <!-- 费率(每分钟) -->
        <fee_quarter></fee_quarter> <!-- 费率(每一刻钟/15分钟) -->
        <fee_halfhr></fee_halfhr> <!-- 费率(每30分钟)  -->
        <fee_hr></fee_hr> <!-- 费率(每小时) -->
        <fee_day></fee_day> <!-- 费率(每天)  -->
        <fee_week></fee_week> <!-- 费率(每周) -->
        <fee_month></fee_month> <!-- 费率(每月) -->
        <fee_year></fee_year> <!-- 费率(每年) -->
        <currency></currency> <!-- 币种 -->
        <trial_time>0</trial_time> <!-- 可试用时长(分钟) -->
        <trymac_chk>0</trymac_chk> <!-- 阻止同一MAC地址设备重复试用。1代表启用，0代表禁用 -->
        <whiteaddr></whiteaddr> <!-- 域名/IP地址白名单。多个值以“;”字符间隔 -->
        <blackaddr></blackaddr> <!-- 域名/IP地址黑名单。多个值以“;”字符间隔 -->
        <incoming_max></incoming_max> <!-- 每连接最大接收流量 -->
        <outgoing_max></outgoing_max> <!-- 每连接最大发送流量 -->
        <authpage_type>1</authpage_type> <!-- 认证页面类型。0: 自定义URL; 1~99: 默认认证页面; 9999: 自定义HTML -->
        <authpage_url></authpage_url> <!-- 自定义认证页面URL -->
        <authpage_html></authpage_html> <!-- 自定义HTML -->
        <postauthpage_type></postauthpage_type> <!-- 认证后页面类型。0: 自定义URL; 1: 默认页面; 9999: 自定义HTML -->
        <postauthpage_url></postauthpage_url> <!-- 自定义认证后页面URL -->
        <postauthpage_html></postauthpage_html> <!-- 自定义认证后页面HTML -->
    </data>
</result>

5.3 创建新热点
请求参数说明：

返回数据示例与说明：

<?xml version="1.0" encoding="UTF-8"?>
<result>
    <status>
        <!-- code: 调用结果状态码。
            值为OK代表调用成功；如果为以ERR开头的文字，则代表错误 -->
        <code>OK</code>
        <!-- message: 调用结果状态说明（供调试参考）-->
        <message>HotSpot Created</message>
    </status>
<data> <!-- 仅在code为OK时出现 -->
        <!-- 创建的热点的HotSpot ID -->
        <hotspot_id>14006BD8DC6</hotspot_id>
    </data>
</result>

5.4 修改热点设置
请求参数说明：

返回数据示例与说明：

<?xml version="1.0" encoding="UTF-8"?>
<result>
    <status>
        <!-- code: 调用结果状态码。
            值为OK代表调用成功；如果为以ERR开头的文字，则代表错误 -->
        <code>OK</code>
        <!-- message: 调用结果状态说明（供调试参考）-->
        <message>HotSpot Updated</message>
    </status>
</result>

5.5 删除热点
请求参数说明：

返回数据示例与说明：

<?xml version="1.0" encoding="UTF-8"?>
<result>
    <status>
        <!-- code: 调用结果状态码。
            值为OK代表调用成功；如果为以ERR开头的文字，则代表错误 -->
        <code>OK</code>
        <!-- message: 调用结果状态说明（供调试参考）-->
        <message>HotSpot Deleted</message>
    </status>
</result>

5.6 查询电子招待券
请求参数说明：

返回数据示例与说明：

<?xml version="1.0" encoding="UTF-8"?>
<result>
    <status>
        <!-- code: 调用结果状态码。
            值为OK代表调用成功；如果为以ERR开头的文字，则代表错误 -->
        <code>OK</code>
        <!-- message: 调用结果状态说明（供调试参考）-->
        <message>Operation Completed</message>
    </status>
    <data> <!-- 仅在code为OK时出现 -->
        <record> <!-- 每个record标签代表一条电子招待券记录 -->
            <voucher_id>9</voucher_id> <!-- 电子招待券的唯一存储标识 -->
            <voucher>123</voucher> <!-- 电子招待券文本。如果是多个电子招待券，则以“;”间隔 -->
            <onceonly>0</onceonly> <!-- 1代表仅可使用一次；0代表不限制；2代表仅可使用一次且已使用过 -->
            <minute>30</minute> <!-- 使用时长(分钟) -->
            <end_time></end_time> <!-- 截止时间 -->
            <expiretime></expiretime> <!-- 有效期 -->
            <client_num>0</client_num> <!-- 最大用户数。0代表不限制 -->
        </record>
    </data>
</result>

本文章由 http://www.wifidog.pro/2015/03/23/wifidog-wiwiz-setup-api.html 整理编辑，转载请注明出处

wifidog认证Wiwiz Query API参考手册与接口规范

作者: 佐须之男
时间: March 23, 2015
分类: wifidog认证,wifidog安装,wifidog原理,wifidog分析,wifidog配置

功能描述
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:南非