Sparkle
  1. ClientDiscovery 客户端发现
Sparkle
  • API
    • BanHistory 封禁历史
      • 查询最近封禁记录
      • 复杂查询封禁记录
    • ClientDiscovery 客户端发现
      • 查询最近新客户端发现记录
        GET
      • 复杂查询客户端发现记录
        POST
    • Snapshot 快照记录
      • 查询最近快照
      • 复杂查询快照记录
    • UserApplication 用户应用程序
      • 列出我的用户应用程序
      • 获取指定用户应用程序信息
      • 重置指定用户应用程序的 AppSecret
      • 编辑指定用户应用程序
      • 创建新的用户应用程序
      • 删除指定用户应用程序
    • User 用户
      • 用户个人基本信息
      • 读取指定用户个人基本信息
      • 登出会话
    • Github OAuth2 登录
      GET
  • BTN兼容客户端协议通讯
    • 能力
      • 提交 Peers
      • 提交 Bans
      • 请求云端规则
    • 请求 BTN 配置文件
      GET
  1. ClientDiscovery 客户端发现

复杂查询客户端发现记录

开发中
POST
/api/clientdiscovery/query

请求参数

Body 参数application/json
page
integer 
必需
pageSize
integer 
必需
foundAtTimeFrom
integer 
发现时间区间开始时间
可选
不使用查询条件时请勿传递此参数
foundAtTimeTo
integer 
发现时间区间结束时间
可选
不使用查询条件时请勿传递此参数
lastSeenAtTimeFrom
integer 
最后发现时间区间开始时间
可选
不使用查询条件时请勿传递此参数
lastSeenAtTimeTo
integer 
最后发现时间区间结束时间
可选
不使用查询条件时请勿传递此参数
peerId
string 
可选
不使用查询条件时请勿传递此参数
peerIdCompareMethod
enum<string> 
字符串查询枚举
可选
不使用查询条件时请勿传递此参数
枚举值:
CONTAINSNOT_CONTAINSEQUALSNOT_EQUALSSTARTS_WITHNOT_STARTS_WITHENDS_WITHNOT_ENDS_WITH
peerClientName
string 
可选
不使用查询条件时请勿传递此参数
peerClientNameCompareMethod
enum<string> 
字符串查询枚举
可选
不使用查询条件时请勿传递此参数
枚举值:
CONTAINSNOT_CONTAINSEQUALSNOT_EQUALSSTARTS_WITHNOT_STARTS_WITHENDS_WITHNOT_ENDS_WITH
orConnector
boolean 
是否使用 OR 条件连接
可选
不使用查询条件时请勿传递此参数
sortBy
array[string]
有序排序字段
可选
不使用查询条件时请勿传递此参数
sortOrder
string 
排序方式
可选
不使用查询条件时请勿传递此参数
示例
{
    "page": 0,
    "pageSize": 0,
    "foundAtTimeFrom": 0,
    "foundAtTimeTo": 0,
    "lastSeenAtTimeFrom": 0,
    "lastSeenAtTimeTo": 0,
    "peerId": "string",
    "peerIdCompareMethod": "CONTAINS",
    "peerClientName": "string",
    "peerClientNameCompareMethod": "CONTAINS",
    "orConnector": true,
    "sortBy": [
        "string"
    ],
    "sortOrder": "string"
}

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://btn-prod.ghostchu-services.top/api/clientdiscovery/query' \
--header 'Content-Type: application/json' \
--data-raw '{
    "page": 0,
    "pageSize": 0,
    "foundAtTimeFrom": 0,
    "foundAtTimeTo": 0,
    "lastSeenAtTimeFrom": 0,
    "lastSeenAtTimeTo": 0,
    "peerId": "string",
    "peerIdCompareMethod": "CONTAINS",
    "peerClientName": "string",
    "peerClientNameCompareMethod": "CONTAINS",
    "orConnector": true,
    "sortBy": [
        "string"
    ],
    "sortOrder": "string"
}'

返回响应

🟢200成功
application/json
Body
success
boolean 
必需
message
null 
必需
data
object 
必需
page
integer 
必需
size
integer 
必需
total
integer 
必需
results
array[object (ClientDiscovery) {7}] 
必需
示例
{"success":true,"message":null,"data":{"page":0,"size":10,"total":178,"results":[{"hash":4426014693617597602,"clientName":"PicoTorrent/0.25.0","peerId":"-PI0250-","foundAt":1723917640160,"foundBy":{"id":1,"avatar":"https://avatars.githubusercontent.com/u/30802565?v=4","nickname":"Ghost_chu","registerAt":1723916701954,"lastSeenAt":1723970980524},"lastSeenAt":1723917640160,"lastSeenBy":{"id":1,"avatar":"https://avatars.githubusercontent.com/u/30802565?v=4","nickname":"Ghost_chu","registerAt":1723916701954,"lastSeenAt":1723970980524}},{"hash":9201763804250530118,"clientName":"FDM/6.19.1.5263","peerId":"FD6!0Dqm","foundAt":1723917640160,"foundBy":{"id":1,"avatar":"https://avatars.githubusercontent.com/u/30802565?v=4","nickname":"Ghost_chu","registerAt":1723916701954,"lastSeenAt":1723970980524},"lastSeenAt":1723917640160,"lastSeenBy":{"id":1,"avatar":"https://avatars.githubusercontent.com/u/30802565?v=4","nickname":"Ghost_chu","registerAt":1723916701954,"lastSeenAt":1723970980524}},{"hash":1924153443651185380,"clientName":"BitComet 0.2.0.3","peerId":"-BC0203-","foundAt":1723917640160,"foundBy":{"id":1,"avatar":"https://avatars.githubusercontent.com/u/30802565?v=4","nickname":"Ghost_chu","registerAt":1723916701954,"lastSeenAt":1723970980524},"lastSeenAt":1723917640160,"lastSeenBy":{"id":1,"avatar":"https://avatars.githubusercontent.com/u/30802565?v=4","nickname":"Ghost_chu","registerAt":1723916701954,"lastSeenAt":1723970980524}},{"hash":7995241842093682355,"clientName":"BitComet 1.65","peerId":"-BC0165-","foundAt":1723917630139,"foundBy":{"id":1,"avatar":"https://avatars.githubusercontent.com/u/30802565?v=4","nickname":"Ghost_chu","registerAt":1723916701954,"lastSeenAt":1723970980524},"lastSeenAt":1723917640160,"lastSeenBy":{"id":1,"avatar":"https://avatars.githubusercontent.com/u/30802565?v=4","nickname":"Ghost_chu","registerAt":1723916701954,"lastSeenAt":1723970980524}},{"hash":-6864482821831246914,"clientName":"BitWombat 1.4.0.15","peerId":"-BW140F-","foundAt":1723917620138,"foundBy":{"id":1,"avatar":"https://avatars.githubusercontent.com/u/30802565?v=4","nickname":"Ghost_chu","registerAt":1723916701954,"lastSeenAt":1723970980524},"lastSeenAt":1723917630139,"lastSeenBy":{"id":1,"avatar":"https://avatars.githubusercontent.com/u/30802565?v=4","nickname":"Ghost_chu","registerAt":1723916701954,"lastSeenAt":1723970980524}},{"hash":259876593963295251,"clientName":"FD6bf7.EaoYfbwYu-fpH","peerId":"FD6bf7.E","foundAt":1723917610121,"foundBy":{"id":1,"avatar":"https://avatars.githubusercontent.com/u/30802565?v=4","nickname":"Ghost_chu","registerAt":1723916701954,"lastSeenAt":1723970980524},"lastSeenAt":1723917640160,"lastSeenBy":{"id":1,"avatar":"https://avatars.githubusercontent.com/u/30802565?v=4","nickname":"Ghost_chu","registerAt":1723916701954,"lastSeenAt":1723970980524}},{"hash":-7586219835262457321,"clientName":"uTorrent 3.5.4.28","peerId":"-UT354S-","foundAt":1723917610121,"foundBy":{"id":1,"avatar":"https://avatars.githubusercontent.com/u/30802565?v=4","nickname":"Ghost_chu","registerAt":1723916701954,"lastSeenAt":1723970980524},"lastSeenAt":1723917620138,"lastSeenBy":{"id":1,"avatar":"https://avatars.githubusercontent.com/u/30802565?v=4","nickname":"Ghost_chu","registerAt":1723916701954,"lastSeenAt":1723970980524}},{"hash":1726289678122464971,"clientName":"PI 0.2.5","peerId":"-PI0250-","foundAt":1723917600075,"foundBy":{"id":1,"avatar":"https://avatars.githubusercontent.com/u/30802565?v=4","nickname":"Ghost_chu","registerAt":1723916701954,"lastSeenAt":1723970980524},"lastSeenAt":1723917630139,"lastSeenBy":{"id":1,"avatar":"https://avatars.githubusercontent.com/u/30802565?v=4","nickname":"Ghost_chu","registerAt":1723916701954,"lastSeenAt":1723970980524}},{"hash":-4652905658087988364,"clientName":"Mainline 7.4.3","peerId":"M7-4-3--","foundAt":1723917600075,"foundBy":{"id":1,"avatar":"https://avatars.githubusercontent.com/u/30802565?v=4","nickname":"Ghost_chu","registerAt":1723916701954,"lastSeenAt":1723970980524},"lastSeenAt":1723917600075,"lastSeenBy":{"id":1,"avatar":"https://avatars.githubusercontent.com/u/30802565?v=4","nickname":"Ghost_chu","registerAt":1723916701954,"lastSeenAt":1723970980524}},{"hash":6490110098099321683,"clientName":"qBittorrent/4.2.5","peerId":"-qB4250-","foundAt":1723917600075,"foundBy":{"id":1,"avatar":"https://avatars.githubusercontent.com/u/30802565?v=4","nickname":"Ghost_chu","registerAt":1723916701954,"lastSeenAt":1723970980524},"lastSeenAt":1723917640160,"lastSeenBy":{"id":1,"avatar":"https://avatars.githubusercontent.com/u/30802565?v=4","nickname":"Ghost_chu","registerAt":1723916701954,"lastSeenAt":1723970980524}}]}}
修改于 2024-08-18 09:29:19
上一页
查询最近新客户端发现记录
下一页
查询最近快照
Built with