PeerBanHelper WebAPI
  1. 封禁
PeerBanHelper WebAPI
  • API
    • 鉴权
      • 登录
      • 注销登录态
    • 元数据
      • 请求基本清单数据
      • 初始化
    • 基本统计
      • 统计计数器
      • 规则计数器
    • 封禁
      • 获取封禁列表
        GET
      • 获取封禁历史记录信息
        GET
      • 获取封禁排名
        GET
      • 解除封禁
        DELETE
    • 下载器
      • 获取下载器列表
      • 获取下载器元数据
      • 获取下载器种子列表
      • 获取下载器指定种子的Peers列表
      • 创建下载器
      • 编辑下载器
      • 测试下载器配置
      • 删除下载器
    • 推送渠道
      • 获取推送渠道列表
      • 获取推送渠道元数据
      • 创建推送渠道
      • 编辑推送渠道
      • 测试通知渠道
      • 删除推送渠道
    • 通用
      • 通用状态查询
      • 创建堆转储文件
      • 检查指定模块是否启用
      • 更改全局设置
      • 获取全局设置
      • 配置文件重载
    • 功能模块
      • AutoRangeBan
        • 获取模块内存基本元数据
      • BtnNetworkOnline
        • 获取 BTN 模块状态
      • ClientNameBlackList
        • 获取模块内存基本元数据
      • IPBlackList
        • 获取模块内存基本元数据
        • 测试IP黑名单规则
        • 添加IP黑名单规则
        • 删除IP黑名单规则
        • 添加端口黑名单规则
        • 删除端口黑名单规则
        • 添加ASN黑名单
        • 删除ASN黑名单规则
        • 添加国家/地区代码黑名单规则
        • 添加城市黑名单规则
        • 删除国家/地区代码黑名单规则
        • 删除城市黑名单规则
      • MultiDialingBlocker
        • 获取模块内存基本元数据
      • PeerIdBlacklist
        • 获取模块内存基本元数据
      • ProgressCheatBlocker
        • 获取模块内存基本元数据
        • 获取状态
      • 订阅规则
        • 查询更新间隔
        • 修改更新间隔
        • 新增订阅规则
        • 查询订阅规则
        • 更新订阅规则
        • 保存订阅规则
        • 删除订阅规则
        • 启用禁用规则
        • 订阅规则列表
        • 更新全部订阅规则
        • 查询全部订阅规则更新日志
        • 查询指定订阅规则更新日志
      • Friend
        • 未命名接口
      • Expression Engine
        • 列出所有脚本
        • 获取指定脚本内容
        • 创建/保存脚本
        • 删除指定脚本
        • 是否可编辑给定脚本
      • Laboratory
        • 列出所有实验状态
        • 检查指定实验是否已启用
        • 设置指定实验的开关状态
        • 获取实验室模块配置状态
        • 设置实验室模块配置状态
      • PTRBlacklist
    • 警报
      • 获取警报列表
      • 标记警报为已读
      • 标记警报为全部已读
      • 删除指定警报
    • 程序日志
      • 连接到日志 WebSocket
      • 获取程序日志
    • 统计图表(基础)
      • 封禁趋势统计(迁移自/api/statistic/analysis/date)
      • 统计通用数值查询
      • 统计通用日期归类查询
    • PBH Plus
      • 创建或更新免费许可证
      • 验证捐赠密钥状态
      • 设置捐赠密钥
    • Torrent
      • 获取PBH种子列表
      • 获取指定种子基本信息
      • 获取指定种子的访问历史列表
      • 获取指定种子的封禁历史列表
    • 图表
      • GeoIP
      • 趋势
      • 流量
    • Peer
      • 查询指定 IP 的基本信息
      • 查询指定 IP 的访问历史列表
      • 查询指定 IP 的封禁记录
    • 工具
      • 批量更换 Tracker
  • 下载器兼容层
    • IP BanList 提供端点
      GET
    • P2P Guard Plain BanList 提供端点
      GET
    • DAT/Emule BanList 提供端点
      GET
  1. 封禁

获取封禁列表

GET
/api/bans

请求参数

Authorization
在 Header 添加参数
Authorization
,其值为在 Bearer 之后拼接 Token
示例:
Authorization: Bearer ********************
Query 参数
limit
integer 
限制数量
可选
示例值:
-1
lastBanTime
integer 
可选
我也不知道这是个什么参数
示例值:
-1
search
string 
搜索关键字
可选
示例值:
-HP00

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request GET 'http://127.0.0.1:9897/api/bans?limit=-1&lastBanTime=-1&search=-HP00'

返回响应

🟢200成功
application/json
Body
success
boolean 
必需
message
null 
必需
data
array [object {2}] 
必需
address
string 
必需
banMetadata
object 
必需
示例
{"success":true,"message":null,"data":[{"address":"113.211.211.93","banMetadata":{"downloader":"myqb","randomId":"8a7f2d05-7357-413a-b467-7018f5450567","torrent":{"id":"7e0c529ec72b021fd62b3a3b75db4a1305511904","size":747788201,"name":"[Erai-raws] Tsue to Tsurugi no Wistoria - 01 [720p][Multiple Subtitle][08FDD1BD].mkv","hash":"7e0c529ec72b021fd62b3a3b75db4a1305511904","progress":0.9561500957675582,"rtUploadSpeed":0,"rtDownloadSpeed":370836},"peer":{"address":{"port":47826,"ip":"113.211.211.93"},"rawIp":"113.211.211.93:47826","id":"","clientName":"","downloaded":0,"downloadSpeed":0,"uploaded":0,"uploadSpeed":0,"progress":0.0,"flags":"K ? I"},"geo":null,"reverseLookup":"N/A","context":"com.ghostchu.peerbanhelper.module.impl.rule.IPBlackRuleList","banAt":1722796046779,"unbanAt":1723055246779,"rule":"all-in-one","description":"匹配 IP黑名单订阅 规则: all-in-one, IP 地址: 113.211.211.93"}},{"address":"2001:e68:5474:e0b4:299e:cd84:bfb1:938e","banMetadata":{"downloader":"myqb","randomId":"dfb30478-83de-453a-ba6c-5b994855812d","torrent":{"id":"3ff2762c7fd9a2de49237a16f9cdb0b2720a8c88","size":3697745942,"name":"[GM-Team][国漫][成何体统][What A Scandal][2024][01-06][HEVC][GB][4K]","hash":"3ff2762c7fd9a2de49237a16f9cdb0b2720a8c88","progress":0.20741938576373942,"rtUploadSpeed":0,"rtDownloadSpeed":155647},"peer":{"address":{"port":55619,"ip":"2001:e68:5474:e0b4:299e:cd84:bfb1:938e"},"rawIp":"[2001:e68:5474:e0b4:299e:cd84:bfb1:938e]:55619","id":"","clientName":"","downloaded":0,"downloadSpeed":0,"uploaded":0,"uploadSpeed":0,"progress":0.0,"flags":"K ? I P"},"geo":null,"reverseLookup":"N/A","context":"com.ghostchu.peerbanhelper.module.impl.rule.IPBlackRuleList","banAt":1722795945405,"unbanAt":1723055145405,"rule":"all-in-one","description":"匹配 IP黑名单订阅 规则: all-in-one, IP 地址: 2001:e68:5474:e0b4:299e:cd84:bfb1:938e"}},{"address":"24.50.234.71","banMetadata":{"downloader":"myqb","randomId":"55d419e9-3cc0-4c3b-8311-244ee11097a5","torrent":{"id":"e71f121e0711833f4b0b9fa27e707b66e2185196","size":994341976,"name":"[SubsPlease] Monogatari Series - Off & Monster Season - 01 (720p) [1B3C835F].mkv","hash":"e71f121e0711833f4b0b9fa27e707b66e2185196","progress":1.0,"rtUploadSpeed":112277,"rtDownloadSpeed":0},"peer":{"address":{"port":24185,"ip":"24.50.234.71"},"rawIp":"24.50.234.71:24185","id":"-qB4650-","clientName":"qBittorrent 4.6.5","downloaded":0,"downloadSpeed":0,"uploaded":0,"uploadSpeed":0,"progress":0.0,"flags":"K ? I E P"},"geo":null,"reverseLookup":"N/A","context":"com.ghostchu.peerbanhelper.module.impl.rule.IPBlackRuleList","banAt":1722795787916,"unbanAt":1723054987916,"rule":"all-in-one","description":"匹配 IP黑名单订阅 规则: all-in-one, IP 地址: 24.50.234.71"}},{"address":"24.50.234.31","banMetadata":{"downloader":"myqb","randomId":"3b968c4a-4117-4521-ab45-2dda336823d0","torrent":{"id":"e71f121e0711833f4b0b9fa27e707b66e2185196","size":994341976,"name":"[SubsPlease] Monogatari Series - Off & Monster Season - 01 (720p) [1B3C835F].mkv","hash":"e71f121e0711833f4b0b9fa27e707b66e2185196","progress":0.8575079284392998,"rtUploadSpeed":3705,"rtDownloadSpeed":544792},"peer":{"address":{"port":52915,"ip":"24.50.234.31"},"rawIp":"24.50.234.31:52915","id":"-qB4650-","clientName":"qBittorrent 4.6.5","downloaded":0,"downloadSpeed":0,"uploaded":0,"uploadSpeed":0,"progress":0.0,"flags":"K ? I E P"},"geo":null,"reverseLookup":"N/A","context":"com.ghostchu.peerbanhelper.module.impl.rule.IPBlackRuleList","banAt":1722795574851,"unbanAt":1723054774851,"rule":"all-in-one","description":"匹配 IP黑名单订阅 规则: all-in-one, IP 地址: 24.50.234.31"}},{"address":"2001:e68:5431:e218:5fbe:dc79:bc25:61d","banMetadata":{"downloader":"myqb","randomId":"cb15fa53-00da-4cd5-95dc-5e152ceb3e14","torrent":{"id":"e71f121e0711833f4b0b9fa27e707b66e2185196","size":994341976,"name":"[SubsPlease] Monogatari Series - Off & Monster Season - 01 (720p) [1B3C835F].mkv","hash":"e71f121e0711833f4b0b9fa27e707b66e2185196","progress":0.716512283697455,"rtUploadSpeed":0,"rtDownloadSpeed":348491},"peer":{"address":{"port":41531,"ip":"2001:e68:5431:e218:5fbe:dc79:bc25:61d"},"rawIp":"[2001:e68:5431:e218:5fbe:dc79:bc25:61d]:41531","id":"","clientName":"","downloaded":0,"downloadSpeed":0,"uploaded":0,"uploadSpeed":0,"progress":0.0,"flags":"K ? I H X P"},"geo":null,"reverseLookup":"N/A","context":"com.ghostchu.peerbanhelper.module.impl.rule.IPBlackRuleList","banAt":1722795285562,"unbanAt":1723054485562,"rule":"all-in-one","description":"匹配 IP黑名单订阅 规则: all-in-one, IP 地址: 2001:e68:5431:e218:5fbe:dc79:bc25:61d"}},{"address":"24.50.234.139","banMetadata":{"downloader":"myqb","randomId":"3aed3196-1fd4-475d-bf6d-70d88ec6491a","torrent":{"id":"e71f121e0711833f4b0b9fa27e707b66e2185196","size":994341976,"name":"[SubsPlease] Monogatari Series - Off & Monster Season - 01 (720p) [1B3C835F].mkv","hash":"e71f121e0711833f4b0b9fa27e707b66e2185196","progress":0.5639661017388247,"rtUploadSpeed":0,"rtDownloadSpeed":306002},"peer":{"address":{"port":42857,"ip":"24.50.234.139"},"rawIp":"24.50.234.139:42857","id":"-qB4450-","clientName":"qBi
🟠429IP地址因频繁失败尝试而被封禁
🟠403未登录或Token错误
🔴500内部服务器错误
修改于 2025-01-01 19:09:36
上一页
规则计数器
下一页
获取封禁历史记录信息
Built with