PeerBanHelper WebAPI
  1. Peer
PeerBanHelper WebAPI
  • API
    • 鉴权
      • 登录
      • 注销登录态
    • 元数据
      • 请求基本清单数据
      • 初始化
    • 基本统计
      • 统计计数器
      • 规则计数器
    • 封禁
      • 获取封禁列表
      • 获取封禁历史记录信息
      • 获取封禁排名
      • 解除封禁
      • (测试接口)手动添加封禁项
    • 下载器
      • 扫描本机设备上的下载器 WebUI
      • 获取下载器列表
      • 获取下载器元数据
      • 获取下载器种子列表
      • 获取下载器指定种子的Peers列表
      • 创建下载器
      • 编辑下载器
      • 测试下载器配置
      • 删除下载器
    • 推送渠道
      • 获取推送渠道列表
      • 获取推送渠道元数据
      • 创建推送渠道
      • 编辑推送渠道
      • 测试通知渠道
      • 删除推送渠道
    • 通用
      • 通用状态查询
      • 创建堆转储文件
      • 检查指定模块是否启用
      • 更改全局设置
      • 获取全局设置
      • 手动触发 JVM 崩溃模拟测试
      • 请求 NAT 类型刷新
      • 配置文件重载
    • 功能模块
      • AutoRangeBan
        • 获取模块内存基本元数据
      • BtnNetworkOnline
        • 获取 BTN 模块状态
      • ClientNameBlackList
        • 获取模块内存基本元数据
      • IPBlackList
        • 获取模块内存基本元数据
        • 测试IP黑名单规则
        • 添加IP黑名单规则
        • 删除IP黑名单规则
        • 添加端口黑名单规则
        • 删除端口黑名单规则
        • 添加ASN黑名单
        • 设置网络类型规则
        • 删除ASN黑名单规则
        • 添加国家/地区代码黑名单规则
        • 添加城市黑名单规则
        • 删除国家/地区代码黑名单规则
        • 删除城市黑名单规则
      • MultiDialingBlocker
        • 获取模块内存基本元数据
      • PeerIdBlacklist
        • 获取模块内存基本元数据
      • ProgressCheatBlocker
        • 获取模块内存基本元数据
        • 获取状态
      • 订阅规则
        • 查询更新间隔
        • 修改更新间隔
        • 新增订阅规则
        • 查询订阅规则
        • 更新订阅规则
        • 保存订阅规则
        • 删除订阅规则
        • 启用禁用规则
        • 订阅规则列表
        • 更新全部订阅规则
        • 查询全部订阅规则更新日志
        • 查询指定订阅规则更新日志
      • Friend
        • 未命名接口
      • Expression Engine
        • 列出所有脚本
        • 获取指定脚本内容
        • 创建/保存脚本
        • 删除指定脚本
        • 是否可编辑给定脚本
      • Laboratory
        • 列出所有实验状态
        • 检查指定实验是否已启用
        • 设置指定实验的开关状态
        • 获取实验室模块配置状态
        • 设置实验室模块配置状态
      • PTRBlacklist
      • SwarmTracking
        • 获取跟踪的 Peers 分页数据
        • 获取跟踪的 Peers 数量
    • 警报
      • 获取警报列表
      • 标记警报为已读
      • 标记警报为全部已读
      • 删除指定警报
    • 程序日志
      • 连接到日志 WebSocket
      • 获取程序日志
    • 统计图表(基础)
      • 封禁趋势统计(迁移自/api/statistic/analysis/date)
      • 统计通用数值查询
      • 统计通用日期归类查询
    • PBH Plus
      • 创建或更新免费 Basic 许可证
      • 获取当前许可证系统状态
      • 安装许可证
      • 卸载许可证
      • 获取免费 Basic 许可证的无交互验证码
    • Torrent
      • 获取PBH种子列表
      • 获取指定种子基本信息
      • 获取指定种子的访问历史列表
      • 获取指定种子的封禁历史列表
    • 图表
      • 区间唯一 IP 会话数量
      • 区间唯一 IP 会话图表(按日时间分桶)
      • 会话分析图表
      • 客户端分析图表
      • GeoIP
      • 趋势
      • 流量
    • Peer
      • 查询指定 IP 的基本信息
        GET
      • 查询指定 IP 的访问历史列表
        GET
      • 查询指定 IP 的封禁记录
        GET
      • 请求 BTN 接口查询 IP 信息(结构数据返回)
        GET
      • 请求 BTN 查询 IP 信息(iframe 地址返回)
        GET
    • 工具
      • 批量更换 Tracker
    • 后台任务(未完成)
      • 列出后台任务的有序列表
      • 获取指定任务元数据
      • 获取指定任务日志数据
      • 取消指定任务
    • 自动 STUN
      • 隧道列表
      • 获取指定隧道信息
      • 获取指定隧道连接表
      • 获取状态
      • 请求 NAT 类型刷新
      • 保存 AutoSTUN 配置
      • 强制重新启动 AutoSTUN 服务
    • 异步任务
      • 获取当前的异步任务列表
    • OOBE
      • 提交初始化 OOBE 数据
      • 扫描本机设备上的下载器 WebUI
      • 测试下载器
  • 下载器兼容层
    • IP BanList 提供端点
      GET
    • P2P Guard Plain BanList 提供端点
      GET
    • DAT/Emule BanList 提供端点
      GET
  • test
  • 数据模型
    • [WS] PBH 日志
      • [WS] 客户端通用请求
      • [WS] 客户端登录请求
      • [WS] 客户端历史日志拉取请求
    • Torrent 信息
    • Peer 信息
    • Peer 的 IP 的 ASN 信息
    • GeoData
    • 封禁条目元数据
    • SubRule 信息
    • DraftDownloader
    • BanLogDTO
    • 控制台日志记录
    • TorrentInfoDTO
    • PeerRecordEntity
    • AlertDTO
    • DraftPushProvider
    • PopulatedPeerDTO
    • 通用数值查询结果模型
    • 通用日期查询结果模型
    • PeerFlags
    • 流量日志
    • UserIPRuleAddRequest
    • UserIPTestResult
    • 程序日志条目
    • DownloaderBasicInfo
    • BanLogDTO
    • PeerAddressWrapper
    • IPGeoData
    • BakedBanMetadata
    • BanDTO
    • DownloaderWrapperDTO
    • TorrentWrapper
    • PopulatedPeerDTO
    • DraftDownloader
    • BackgroundTaskDTO
    • TunnelInfo
    • NATType
    • BackgroundTaskStdResp
    • V1License
    • V2License
    • PowCaptchaData
    • NetworkTypeDTO
    • NicTrafficComputedData
    • BTN IP 查询结果
  1. Peer

请求 BTN 接口查询 IP 信息(结构数据返回)

开发中
GET
/api/peer/{ip}/btnQuery

请求参数

Authorization
在 Header 添加参数
Authorization
,其值为在 Bearer 之后拼接 Token
示例:
Authorization: Bearer ********************
Path 参数

请求示例代码

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/peer//btnQuery' \
--header 'Authorization: Bearer <token>'

返回响应

🟢200成功
application/json
Body

示例
{
    "success": true,
    "asyncTask": null,
    "message": null,
    "data": {
        "color": "gray",
        "labels": [],
        "bans": {
            "duration": 604800000,
            "total": 1,
            "records": [
                {
                    "populate_time": 1765193901746,
                    "torrent": "id=1651",
                    "peer_ip": "189.196.219.70",
                    "peer_port": 42526,
                    "peer_id": "-qB5030-",
                    "peer_client_name": "qBittorrent 5.0.3",
                    "peer_progress": 0.01161103043705225,
                    "peer_flags": "U I H P",
                    "reporter_progress": 1.0,
                    "to_peer_traffic": 7637011,
                    "from_peer_traffic": 0,
                    "module_name": "com.ghostchu.peerbanhelper.module.impl.rule.ProgressCheatBlocker",
                    "rule": "已超过允许的进度倒退最大值",
                    "description": "客户端进度:1.16%,实际进度:2.11%,上次记录进度:95.43%,本次回退进度:94.27%,差值:10.00%",
                    "structured_data": null
                }
            ]
        },
        "swarms": {
            "duration": 900000,
            "total": 4,
            "records": [
                {
                    "torrent": "id=1651",
                    "peer_ip": "189.196.219.70",
                    "peer_port": 42526,
                    "peer_id": "-qB5030-",
                    "peer_client_name": "qBittorrent 5.0.3",
                    "peer_progress": 0.01161103043705225,
                    "from_peer_traffic": 0,
                    "to_peer_traffic": 7637011,
                    "from_peer_traffic_offset": 0,
                    "to_peer_traffic_offset": 7637011,
                    "flags": "U I H P",
                    "first_time_seen": 1765193901510,
                    "last_time_seen": 1765193901510,
                    "user_progress": 1.0
                },
                {
                    "torrent": "id=1651",
                    "peer_ip": "189.196.219.70",
                    "peer_port": 42994,
                    "peer_id": "-qB5030-",
                    "peer_client_name": "qBittorrent 5.0.3",
                    "peer_progress": 0.9542815685272217,
                    "from_peer_traffic": 0,
                    "to_peer_traffic": 7635982,
                    "from_peer_traffic_offset": 0,
                    "to_peer_traffic_offset": 7635982,
                    "flags": "U I H P",
                    "first_time_seen": 1765191864498,
                    "last_time_seen": 1765191864498,
                    "user_progress": 1.0
                },
                {
                    "torrent": "id=1651",
                    "peer_ip": "189.196.219.70",
                    "peer_port": 57391,
                    "peer_id": "-qB5030-",
                    "peer_client_name": "qBittorrent 5.0.3",
                    "peer_progress": 0.8272859454154968,
                    "from_peer_traffic": 0,
                    "to_peer_traffic": 7635459,
                    "from_peer_traffic_offset": 0,
                    "to_peer_traffic_offset": 7635459,
                    "flags": "U I H P",
                    "first_time_seen": 1765191809496,
                    "last_time_seen": 1765191809496,
                    "user_progress": 1.0
                },
                {
                    "torrent": "id=1651",
                    "peer_ip": "189.196.219.70",
                    "peer_port": 57476,
                    "peer_id": "-qB5030-",
                    "peer_client_name": "qBittorrent 5.0.3",
                    "peer_progress": 0.010885341092944145,
                    "from_peer_traffic": 0,
                    "to_peer_traffic": 7634944,
                    "from_peer_traffic_offset": 0,
                    "to_peer_traffic_offset": 7634944,
                    "flags": "U I P",
                    "first_time_seen": 1765188560258,
                    "last_time_seen": 1765188723504,
                    "user_progress": 1.0
                }
            ],
            "concurrent_download_torrents_count": 4
        },
        "traffic": {
            "duration": 604800000,
            "to_peer_traffic": 38180407,
            "from_peer_traffic": 0,
            "share_ratio": -1.0
        },
        "torrents": {
            "duration": 604800000,
            "count": 1
        }
    }
}
修改于 2025-12-08 09:53:58
上一页
查询指定 IP 的封禁记录
下一页
请求 BTN 查询 IP 信息(iframe 地址返回)
Built with