- API
- 鉴权
- 元数据
- 基本统计
- 封禁
- 下载器
- 推送渠道
- 通用
- 功能模块
- 警报
- 程序日志
- 统计图表（基础）
- PBH Plus
- Torrent
- 图表
- Peer
- 工具
- 下载器兼容层
获取下载器指定种子的Peers列表
GET
/api/downloaders/{downloaderName}/torrent/{torrentId}/peers
请求参数
Authorization
在 Header 添加参数
Authorization
，其值为在 Bearer 之后拼接 Token示例：
Authorization: Bearer ********************Path 参数
downloaderName
string
必需
示例值:
qbittorrent-001
torrentId
string
必需
示例值:
a14bcdff48db709f02cad31c65ee3022b22e9756
示例代码
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/downloaders/qbittorrent-001/torrent/a14bcdff48db709f02cad31c65ee3022b22e9756/peers'返回响应
🟢200成功
application/json
Body
array of:
peer
object (Peer 信息)
Peer信息
address
object
Peer 连接信息
id
string
BitTorrent BEP PeerID
clientName
string
BitTorrent BEP Client Name (User-Agent)
downloaded
integer
已下载字节数
downloadSpeed
integer
下载速度（单位由下载器决定）
uploaded
integer
已上传字节数
uploadSpeed
integer
上传速度（单位由下载器决定）
progress
number <float>
下载进度
>= 0<= 1
flags
object (PeerFlags)
BitTorrent BEP 标志
geo
GeoIP信息
Any of
city
object
城市/位置信息
country
object
国家/地区信息
as
object
自治系统信息
network
object
网络属性信息（由 GeoCN 提供）
示例
[
{
"peer": {
"address": {
"port": 50933,
"ip": "2804:1b3:a8c0:6fe9:3888:6117:b3f2:f889"
},
"id": "-qB4650-",
"clientName": "qBittorrent/4.6.5",
"downloaded": 1105920,
"downloadSpeed": 0,
"uploaded": 0,
"uploadSpeed": 0,
"progress": 1,
"flags": {
"interesting": true,
"choked": false,
"remoteInterested": false,
"remoteChoked": true,
"supportsExtensions": false,
"outgoingConnection": false,
"localConnection": false,
"handshake": false,
"connecting": false,
"onParole": false,
"seed": false,
"optimisticUnchoke": false,
"snubbed": false,
"uploadOnly": false,
"endGameMode": false,
"holePunched": false,
"i2pSocket": false,
"utpSocket": true,
"sslSocket": false,
"rc4Encrypted": true,
"plainTextEncrypted": false,
"fromTracker": false,
"fromDHT": true,
"fromPEX": true,
"fromLSD": false,
"fromResumeData": false,
"fromIncoming": false,
"ltStdString": "d ? I H X E P"
}
},
"geo": {
"city": {
"name": "圣保罗",
"iso": 3448439,
"location": {
"latitude": -23.6283,
"longitude": -46.6409,
"timeZone": "America/Sao_Paulo",
"accuracyRadius": 10
}
},
"country": {
"name": "巴西",
"iso": "BR"
},
"as": {
"number": 18881,
"organization": "TELEFONICA BRASIL S.A",
"ipAddress": "2804:1b3:a8c0:6fe9:3888:6117:b3f2:f889",
"network": {
"ipAddress": "2804:1b3:8000:0:0:0:0:0",
"prefixLength": 34
}
},
"network": {
"isp": "TELEFONICA BRASIL S.A",
"netType": null
}
}
},
{
"peer": {
"address": {
"port": 24997,
"ip": "2a02:1210:520c:6500:64d7:3e76:ac32:6d47"
},
"id": "-qB4610-",
"clientName": "qBittorrent/4.6.1",
"downloaded": 1293936,
"downloadSpeed": 184,
"uploaded": 0,
"uploadSpeed": 0,
"progress": 1,
"flags": {
"interesting": true,
"choked": false,
"remoteInterested": false,
"remoteChoked": false,
"supportsExtensions": false,
"outgoingConnection": false,
"localConnection": false,
"handshake": false,
"connecting": false,
"onParole": false,
"seed": false,
"optimisticUnchoke": false,
"snubbed": false,
"uploadOnly": false,
"endGameMode": false,
"holePunched": false,
"i2pSocket": false,
"utpSocket": true,
"sslSocket": false,
"rc4Encrypted": true,
"plainTextEncrypted": false,
"fromTracker": false,
"fromDHT": true,
"fromPEX": true,
"fromLSD": false,
"fromResumeData": false,
"fromIncoming": false,
"ltStdString": "D ? I H X E P"
}
},
"geo": {
"city": {
"name": "巴塞尔",
"iso": 2661604,
"location": {
"latitude": 47.5702,
"longitude": 7.6187,
"timeZone": "Europe/Zurich",
"accuracyRadius": 5
}
},
"country": {
"name": "瑞士",
"iso": "CH"
},
"as": {
"number": 3303,
"organization": "Bluewin",
"ipAddress": "2a02:1210:520c:6500:64d7:3e76:ac32:6d47",
"network": {
"ipAddress": "2a02:1210:4000:0:0:0:0:0",
"prefixLength": 35
}
},
"network": {
"isp": "Bluewin",
"netType": null
}
}
},
{
"peer": {
"address": {
"port": 46779,
"ip": "2a02:2121:6c5:bc81::7c08:c1ff"
},
"id": "-LT12J0-",
🟠429IP地址因频繁失败尝试而被封禁
🟠403未登录或Token错误
🔴500内部服务器错误
修改于 2025-06-05 06:13:00