Wiwiz HotSpot Builder是什么？
Wiwiz是一个有线/无线网络热点管理系统，利用它你可以为你的热点创建一个强制门户/强制认证页面（captive portal）。
Wiwiz更是一个基于云的开放平台，提供了丰富的扩展、定制功能与开发接口。很多商家、系统集成商和软件公司都使用Wiwiz设置、定制或二次开发出了商用WiFi或网络认证产品。
Wiwiz HotSpot Builder由两部分构成 – Wiwiz Web控制面板 和 一个叫做Wiwiz HotSpot Builder Utility的客户端。
典型的应用情景是，部署了Wiwiz HotSpot Builder的机器充当无线（或有线）局域网中的Internet网关。当网络中的一个用户试图使用Internet时，他需要首先打开Web浏览器并访问任意一个HTTP地址，然后一个特殊的页面（通常用于认证目的）将会被显示出来。而用户在使用Internet前需要在此页面完成认证。

谁使用Wiwiz HotSpot Builder？
答案可能会是：

• 提供无线Internet接入的WISP
• 旅馆、餐厅、咖啡店或酒吧…的经营者
• 公司、办公室、工作室…的管理员
• 公共场所，如图书馆、医院、公园等的管理员
• 想要有偿或无偿分享自己的Internet连接给其他人的人
  …

主要特性与功能？
可以创建免费的热点
● 可以创建收费的热点：

• 可同时设置多种费率，如每分钟，每小时费率，每日费率，每周费率，每月费率…
• 可设置试用时间
• 支持多种币种，包括美元，港元，欧元，日元和人民币
  ● 多种可组合的用户认证方式，包括：
• 用户协议 – 热点管理员可自定义服务条款内容，并要求热点用户认同条款后通过认证
• 用户登录 – 要求用户登录Wiwiz.com注册账户或自定义账户后通过认证
• 电子招待券 – 热点管理员可设置认证码，并要求用户输入后通过认证
• Wiwiz Auth API – 与第三方系统集成整合
• 手机验证
• 可定制风格的认证页面，含15个页面模板
• 用户自定义的认证页面及认证后页面
  ● 热点客户端访问控制
• 可查看当前连接
• 可阻塞或放行特定的热点用户
  ● 支持黑/白地址列表(IP地址或域名)
  ● 支持向热点用户推送消息
  ……

Wiwiz是ISP或WISP吗？
不是。我们提供软件及相关的服务，使您可以分享Internet连接。但是我们并不是ISP或WISP，也就是说您不能从我们这里得到的Internet接入的服务。
请注意，您需要确保您分享您Internet连接行为的合法性或者您的ISP/WISP允许您这样做。

如何用Wiwiz HotSpot Builder创建带有Web认证功能的Wi-Fi热点或有线网络？
拥有一个Wiwiz热点是非常简单的。
第一步：注册成为Wiwiz.com用户并在Wiwiz Web控制面板中创建一个热点。
第二步：下载并安装Wiwiz HotSpot Builder Utility。推荐购买Wiwiz商店中已预装了Wiwiz HotSpot Builder Utility的路由器或认证网关。如使用第三方设备或计算机，请继续向下阅读。

如何安装Wiwiz HotSpot Builder Utility？有什么系统需求？
可以由以下几种简单的方式安装：
● 最简单地，你可以使用一个安装了DD-WRT或OpenWrt固件并安装配置了Wiwiz HotSpot Builder Utility的无线路由器（如Cisco Linksys WRT54G系列）来构筑一个热点。
● 如果你的无线路由器不支持DD-WRT或OpenWrt，那么你可以使用你的计算机来代替。典型地，你需要准备：

• 一台安装了VMWare或VirtualBox的虚拟机软件的计算机
• 一个无线路由器
  ● 或者你可以使用一台安装了Linux系统的计算机

什么是认证后页面？
网络用户在认证页面输入有效的认证信息后，进行认证，一旦通过认证，浏览器将会首先跳转至一个页面，这个页面就是“认证后页面”。它的作用相当于网络用户的一个上网起始页。

我用Wiwiz作为WiFi网络的认证方案，那么每个SSID一定要各自对应一个HotSpot ID吗？
如果你有多个网络需要使用Wiwiz作为认证方式，那么你需要对每一个网络各自绑定一个HotSpot ID（即Wiwiz热点）。
但是如果你有多个子网络，例如，对于无线网络，如果存在多个SSID/AP，但是为了扩大同属于一个网络的覆盖范围，且实际上共享着同一个Internet连接，那么一般无需为每个SSID各自绑定一个HotSpot ID。

是否有认证连接数的限制？
对于一般的认证方式是没有任何限制的。但有两种认证方式例外：

• Wiwiz Auth API
• 自定义账户登录
  这两种认证方式默认的最大同时认证连接数是200/每热点(每HotSpot ID)

本文章由 http://www.wifidog.pro/2015/03/24/wifidog%E5%AE%89%E8%A3%85%E9%85%8D%E7%BD%AE.html 整理编辑，转载请注明出处

1.系统需求
硬件
-已安装了DD-WRT固件的无线路由器（需要Wifidog支持）。
2.设置步骤
将无线路由器接入Internet。
设置好无线配置等。

点击“服务”->“热点”标签页（参考下图）。

按照以下配置各项目（参考下图）：
Wifidog守护进程：　　　　　　选择“启用”
网关ID：　　　　　　　　　　填写Web控制面板中创建的热点的Hotspot ID
Web服务器名：　　　　　　　填写“Wiwiz”
端口：　　　　　　　　　　　使用默认值
最大用户数：　　　　　　　　使用默认值，或可按实际需要填写
检查间隔 (秒)：　　　　　　　使用默认值
客户端超时：　　　　　　　　使用默认值
鉴权服务器主机名：　　　　　填写“cp.wiwiz.com”
鉴权服务器SSL启用：　　　　选择“禁用”
鉴权服务器HTTP端口：　　　使用默认值
鉴权服务器路径：　　　　　　填写“/as/s/”

然后，点击“应用”按钮（参考下图）。

最后，你可以使用一个Wi-Fi客户端(如带WLAN适配器的PC或者支持Wi-Fi的移动电话)测试一下你的热点：

• 搜索可用Wi-Fi热点，并连接到你的热点。
• 打开Web浏览器，输入任何一个HTTP开头的网址。如果你的热点的认证页面能够显示出来，就说明你的热点已经正常运转了。

本文章由 http://www.wifidog.pro/2015/03/24/wifidog%E9%85%8D%E7%BD%AE-3.html 整理编辑，转载请注明出处

1. 功能描述
开发者可以调用Wiwiz HotSpot API根据指定的地理位置信息查询周边的Wiwiz热点。

2. 使用条件与准备工作
已拥有Wiwiz账户。

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

4. 接口说明
URL:

http://cp.wiwiz.com/as/s/hotspots_around/?ver=1.0&username={用户名}&lon={经度}&lat={纬度}&r={范围（米）}

示例：

http://cp.wiwiz.com/as/s/hotspots_around/?ver=1.0&username=wiwiz&lon=116.403703&lat=39.91519&r=2000

5. 请求参数说明

6. 返回结果

JSON示例：
{
    "quantity":"4",
    "data":[
        {
             "ssid":"Wiwiz",
             "merchant_name":"商家名称",
             "merchant_intro":"商家介绍信息",
             "address":"商家地址",
             "longitude":"116.403945",
             "latitude":"39.915281",
             "usernum":"500"
        },
        ......
    ]
}

*注：usernum代表已使用过该热点的累计用户数（不是当前连接的用户数）。

7. 注意事项
(1) 同一Wiwiz账户每日最多可调用本接口5000次。如需增加，请联系客服。
(2) 同一IP地址每秒最多调用本接口10次。

8. 报错信息格式与说明
JSON示例：

{"error_code":"ERROR_CODE", "error_msg":"ERROR_MESSAGE"}

本文章由 http://www.wifidog.pro/2015/03/24/wifidog%E5%8E%9F%E7%90%86-2.html 整理编辑，转载请注明出处

紧接上文。

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 整理编辑，转载请注明出处