WFilter NGF的API接口

来自WFilter上网行为管理系统文档和指南
WFilter讨论 | 贡献2018年8月18日 (六) 11:12的版本

跳转至: 导航搜索


1 概述

WFilter NGF的API,主要提供如下功能:

  • 系统状态的监控
  • 带宽、客户端状态的监控
  • 行为管理

具体接口列表如下:

2 系统状态

2.1 获取网络接口列表

  • 命令:get_network_interfaces
  • 参数:无
  • 返回格式:JSON
  • 返回内容格式

2.2 获取网络接口状态

  • 命令:get_network_status
  • 参数:无
  • 返回格式:JSON
  • 返回内容格式

3 带宽、客户端状态

3.1 获取一段时间内的总带宽

  • 命令:list_bandwidth
  • 参数:时长(秒)
  • 返回格式:JSON
  • 返回内容格式

3.2 获取在线IP列表

  • 命令:list_online_users
  • 参数:记录条数(最大1000),搜索条件。
  • 返回格式:JSON
  • 返回内容格式

3.3 获取IP的所有在线连接

  • 命令:list_online_connections
  • 参数:IP
  • 返回格式:JSON
  • 返回内容格式

4 参数获取

4.1 获取用户组列表

  • 命令:list_group
  • 参数:无
  • 返回格式:JSON
  • 返回内容格式

4.2 获取本地账号列表

  • 命令:list_account
  • 参数:无
  • 返回格式:JSON
  • 返回内容格式

5 客户端行为管理

5.1 断开连接(踢用户下线),解封

  • 命令:kill_connection
  • 参数:
    • port : 该连接的本地端口,0 -- 所有端口
    • type : "ALL"--所有协议,"RESET"--重置,"REMOVE"--全部放行,其他--协议名称
    • minutes : N分钟(时长)
    • message : 推送的消息(urlencode)
  • 返回:TRUE or FALSE

5.2 把IP加入到虚拟组

  • 命令:add_virtual_group
  • 参数:
    • groupid:组ID
    • ip:客户机IP地址
    • minutes:加入的时长(分钟)
  • 返回:TRUE or FALSE

5.3 把IP从虚拟组中移出

  • 命令:rm_virtual_group
  • 参数:IP
  • 返回:TRUE or FALSE

5.4 关联用户名到IP

  • 命令:add_user
  • 参数:
    • ip: 要关联用户名的IP低至
    • user: 用户名(urlencode)
    • from: 来自于(比如:webauth, pppoe)
    • expire: 多少时间后过期(秒)
  • 返回:TRUE or FALSE

5.5 取消用户名关联

  • 命令:rm_user
  • 参数:ip或者用户名(urlencode)
  • 返回:TRUE or FALSE

6 配置的添加、修改和删除

6.1 获取配置文件

  • 命令:config_load
  • 参数cfgname:配置文件名
  • 返回:json格式的配置文件

6.2 添加配置

  • 命令:config_add
  • 参数:
    • cfgname:配置文件名
    • type:配置类型
    • name:配置段名称
    • values:JSON格式的配置段内容

6.3 修改配置

  • 命令:config_set
  • 参数:
    • cfgname:配置文件名
    • section:配置段名称
    • values:JSON格式的配置段内容

6.4 删除配置

  • 命令:config_del
  • 参数:
    • cfgname:配置文件名
    • section:要删除的配置段名称

6.5 应用新配置

  • 命令:config_apply
  • 参数:无

7 SDK下载

7.1 php

点击下载:php版本的SDK下载

8 相关链接