WFilter NGF的API接口

来自WFilter上网行为管理系统文档和指南
跳转至: 导航搜索


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地址或者用户名。(用户名格式:“CN=用户名,OU=group ID,DC=wflocal”,需要urlencode。如:CN=test,DC=wflocal)
    • minutes:加入的时长(分钟)
  • 返回:TRUE or FALSE

5.3 列出虚拟组中的用户和IP

  • 命令:list_virtual_group
  • 参数:groupid
  • 返回:IP、用户列表

5.4 从虚拟组中移出

  • 命令:rm_virtual_group
  • 参数:IP或者用户名
  • 返回:TRUE or FALSE

5.5 关联用户名到IP

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

5.6 取消用户名关联

  • 命令: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
  • 参数:无

6.6 配置文件列表和格式

7 查询数据库

  • 命令:query_db
  • 参数:
    • 数据库名字,如:report.db
    • 查询SQL(urlencode),如:select count(*) from webreport
  • 数据库结构请参考:WFilter NGF的数据库结构

8 SDK下载

8.1 php

点击下载:php版本的SDK下载(最新更新日期:2022-08-05)

9 相关链接