PeerBanHelper WebAPI(v8)
  1. 下载器
PeerBanHelper WebAPI(v8)
  • API
    • 鉴权
      • 登录
      • 注销登录态
    • 元数据
      • 请求基本清单数据
      • 初始化
    • 基本统计
      • 统计计数器
    • 封禁
      • 获取封禁列表
      • 获取封禁历史记录信息
      • 获取封禁排名
      • 解除封禁
    • 下载器
      • 获取下载器列表
        GET
      • 获取下载器元数据
        GET
      • 获取下载器种子列表
        GET
      • 获取下载器指定种子的Peers列表
        GET
      • 创建下载器
        PUT
      • 编辑下载器
        PATCH
      • 测试下载器配置
        POST
      • 删除下载器
        DELETE
    • 推送渠道
      • 获取推送渠道列表
      • 获取推送渠道元数据
      • 创建推送渠道
      • 编辑推送渠道
      • 测试通知渠道
      • 删除推送渠道
    • 通用
      • 通用状态查询
      • 创建堆转储文件
      • 检查指定模块是否启用
      • 更改全局设置
      • 获取全局设置
      • 配置文件重载
      • 手动触发 JVM 崩溃模拟测试
    • 功能模块
      • AutoRangeBan
        • 获取模块内存基本元数据
      • BtnNetworkOnline
        • 获取 BTN 模块状态
      • ClientNameBlackList
        • 获取模块内存基本元数据
      • IPBlackList
        • 获取模块内存基本元数据
        • 测试IP黑名单规则
        • 添加IP黑名单规则
        • 删除IP黑名单规则
        • 添加端口黑名单规则
        • 删除端口黑名单规则
        • 添加ASN黑名单
        • 删除ASN黑名单规则
        • 添加国家/地区代码黑名单规则
        • 添加城市黑名单规则
        • 删除国家/地区代码黑名单规则
        • 删除城市黑名单规则
      • MultiDialingBlocker
        • 获取模块内存基本元数据
      • PeerIdBlacklist
        • 获取模块内存基本元数据
      • ProgressCheatBlocker
        • 获取模块内存基本元数据
        • 获取状态
      • 订阅规则
        • 查询更新间隔
        • 修改更新间隔
        • 新增订阅规则
        • 查询订阅规则
        • 更新订阅规则
        • 保存订阅规则
        • 删除订阅规则
        • 启用禁用规则
        • 订阅规则列表
        • 更新全部订阅规则
        • 查询全部订阅规则更新日志
        • 查询指定订阅规则更新日志
      • Friend
        • 未命名接口
      • Expression Engine
        • 列出所有脚本
        • 获取指定脚本内容
        • 创建/保存脚本
        • 删除指定脚本
        • 是否可编辑给定脚本
      • Laboratory
        • 列出所有实验状态
        • 检查指定实验是否已启用
        • 设置指定实验的开关状态
        • 获取实验室模块配置状态
        • 设置实验室模块配置状态
      • SwarmTracking
        • 获取跟踪的 Peers 数量
        • 获取跟踪的 Peers 分页数据
    • 警报
      • 获取警报列表
      • 标记警报为已读
      • 标记警报为全部已读
      • 删除指定警报
    • 程序日志
      • 获取程序日志
    • 统计图表(基础)
      • 封禁趋势统计(迁移自/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. 下载器

获取下载器指定种子的Peers列表

GET
http://127.0.0.1:9897/api/downloaders/{downloaderId}/torrent/{torrentId}/peers
最后修改时间:2025-06-05 06:40:18
责任人:未设置

请求参数

Authorization
在 Header 添加参数
Authorization
,其值为在 Bearer 之后拼接 Token
示例:
Authorization: Bearer ********************
Path 参数
downloaderId
string 
必需
下载器唯一识别 ID
示例值:
{{$string.uuid}}
torrentId
string 
种子 ID
必需
示例值:
a14bcdff48db709f02cad31c65ee3022b22e9756

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location -g --request GET 'http://127.0.0.1:9897/api/downloaders/{{$string.uuid}}/torrent/a14bcdff48db709f02cad31c65ee3022b22e9756/peers'

返回响应

🟢200成功
application/json
Body
success
boolean 
必需
message
null 
必需
data
array [object {3}] 
必需
peer
object (PopulatedPeerDTO) 
Peer 数据
必需
geo
object (IPGeoData)  | null 
必需
GeoIP 未加载或者无数据时可能为空
ptrRecord
string  | null 
PTR 反查记录
必需
DNS PTR 反查记录
示例
{"success":true,"message":null,"data":[{"peer":{"address":{"port":65460,"ip":"123.245.60.21"},"rawIp":"123.245.60.21","id":"-qB4640-","clientName":"qBittorrent/4.6.4","downloaded":163099,"downloadSpeed":1433,"uploaded":0,"uploadSpeed":0,"progress":1.0,"flags":null},"geo":{"city":{"name":"辽宁省 沈阳市 浑南区","iso":86210112,"location":{"latitude":34.7732,"longitude":113.722,"timeZone":"Asia/Shanghai","accuracyRadius":1000},"cnProvince":"辽宁省","cnCity":"沈阳市","cnDistricts":"浑南区"},"country":{"name":"China","iso":"CN"},"as":{"number":4134,"organization":"Chinanet","ipAddress":"123.245.60.21","network":{"ipAddress":"123.245.0.0","prefixLength":17}},"network":{"isp":"中国电信","netType":"宽带"}},"ptrRecord":null},{"peer":{"address":{"port":62336,"ip":"183.152.208.12"},"rawIp":"183.152.208.12","id":"-qB5100-","clientName":"qBittorrent/5.1.0","downloaded":115413,"downloadSpeed":0,"uploaded":0,"uploadSpeed":0,"progress":1.0,"flags":null},"geo":{"city":{"name":"浙江省 舟山市 普陀区","iso":86330903,"location":{"latitude":34.7732,"longitude":113.722,"timeZone":"Asia/Shanghai","accuracyRadius":1000},"cnProvince":"浙江省","cnCity":"舟山市","cnDistricts":"普陀区"},"country":{"name":"China","iso":"CN"},"as":{"number":4134,"organization":"Chinanet","ipAddress":"183.152.208.12","network":{"ipAddress":"183.152.0.0","prefixLength":13}},"network":{"isp":"中国电信","netType":"宽带"}},"ptrRecord":null},{"peer":{"address":{"port":30967,"ip":"2408:8215:5b13:cea0:496b:587e:20ad:d7e7"},"rawIp":"2408:8215:5b13:cea0:496b:587e:20ad:d7e7","id":"-BC0213-","clientName":"BitComet 2.13","downloaded":104957,"downloadSpeed":629,"uploaded":0,"uploadSpeed":0,"progress":0.366,"flags":null},"geo":{"city":{"name":"山东省 临沂市 兰山区","iso":86371302,"location":{"latitude":34.7732,"longitude":113.722,"timeZone":"Asia/Shanghai","accuracyRadius":1000},"cnProvince":"山东省","cnCity":"临沂市","cnDistricts":"兰山区"},"country":{"name":"China","iso":"CN"},"as":{"number":4837,"organization":"CHINA UNICOM China169 Backbone","ipAddress":"2408:8215:5b13:cea0:496b:587e:20ad:d7e7","network":{"ipAddress":"2408:8214:0:0:0:0:0:0","prefixLength":31}},"network":{"isp":"中国联通","netType":"宽带"}},"ptrRecord":null},{"peer":{"address":{"port":41015,"ip":"2408:8244:600:199c:be24:11ff:fec7:2fc"},"rawIp":"2408:8244:600:199c:be24:11ff:fec7:2fc","id":"-qB5020-","clientName":"qBittorrent/5.0.2","downloaded":48778,"downloadSpeed":634,"uploaded":0,"uploadSpeed":0,"progress":1.0,"flags":null},"geo":{"city":{"name":"安徽省 合肥市 包河区","iso":86340111,"location":{"latitude":34.7732,"longitude":113.722,"timeZone":"Asia/Shanghai","accuracyRadius":1000},"cnProvince":"安徽省","cnCity":"合肥市","cnDistricts":"包河区"},"country":{"name":"China","iso":"CN"},"as":{"number":140726,"organization":"UNICOM AnHui province network","ipAddress":"2408:8244:600:199c:be24:11ff:fec7:2fc","network":{"ipAddress":"2408:8244:0:0:0:0:0:0","prefixLength":36}},"network":{"isp":"中国联通","netType":"宽带"}},"ptrRecord":null},{"peer":{"address":{"port":56378,"ip":"240e:350:6f8a:2000:2099:e0f0:f2ab:5e95"},"rawIp":"240e:350:6f8a:2000:2099:e0f0:f2ab:5e95","id":"-qB5100-","clientName":"","downloaded":199098,"downloadSpeed":0,"uploaded":0,"uploadSpeed":0,"progress":1.0,"flags":null},"geo":{"city":{"name":"广西壮族自治区 钦州市 钦北区","iso":86450703,"location":{"latitude":34.7732,"longitude":113.722,"timeZone":"Asia/Shanghai","accuracyRadius":1000},"cnProvince":"广西壮族自治区","cnCity":"钦州市","cnDistricts":"钦北区"},"country":{"name":"China","iso":"CN"},"as":{"number":4134,"organization":"Chinanet","ipAddress":"240e:350:6f8a:2000:2099:e0f0:f2ab:5e95","network":{"ipAddress":"240e:350:6800:0:0:0:0:0","prefixLength":37}},"network":{"isp":"中国电信","netType":"宽带"}},"ptrRecord":null},{"peer":{"address":{"port":39397,"ip":"66.135.23.129"},"rawIp":"66.135.23.129","id":"","clientName":"","downloaded":0,"downloadSpeed":0,"uploaded":0,"uploadSpeed":0,"progress":0.0,"flags":null},"geo":{"city":{"name":"Piscataway","iso":5102713,"location":{"latitude":40.5511,"longitude":-74.4606,"timeZone":"America/New_York","accuracyRadius":20},"cnProvince":null,"cnCity":null,"cnDistricts":null},"country":{"name":"United States","iso":"US"},"as":{"number":20473,"organization":"AS-VULTR","ipAddress":"66.135.23.129","network":{"ipAddress":"66.135.0.0","prefixLength":19}},"network":{"isp":"AS-VULTR","netType":null}},"ptrRecord":null},{"peer":{"address":{"port":54321,"ip":"59.149.122.218"},"rawIp":"59.149.122.218","id":"-qB5100-","clientName":"qBittorrent/5.1.0","downloaded":554,"downloadSpeed":0,"uploaded":0,"uploadSpeed":0,"progress":1.0,"flags":null},"geo":{"city":{"name":null,"iso":null,"location":{"latitude":22.2578,"longitude":114.1657,"timeZone":"Asia/Hong_Kong","accuracyRadius":10},"cnProvince":null,"cnCity":null,"cnDistricts":null},"country":{"name":"中国Hong Kong","iso":"HK"},"as":{"number":9269,"organization":"Hong Kong Broadband Network Ltd.","ipAddress":"59.149.122.218","network":{"ipAddress":"59.149.0.0","prefixLength":17}},"network":{"isp":"Hong Kong Broadband Network Ltd.","netType":null}},"ptrRecord":null},{"peer":{"address":{"port":4
🟠429IP地址因频繁失败尝试而被封禁
🟠403未登录或Token错误
🔴500内部服务器错误
修改于 2025-06-05 06:40:18
上一页
获取下载器种子列表
下一页
创建下载器
Built with