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

复杂查询快照记录

开发中
POST
/api/snapshot/query

请求参数

Body 参数application/json
page
integer 
必需
pageSize
integer 
必需
timeFrom
integer 
开始时间
必需
timeTo
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
peerIp
string 
可选
不使用查询条件时请勿传递此参数
peerIpCompareMethod
enum<string> 
字符串查询枚举
可选
不使用查询条件时请勿传递此参数
枚举值:
CONTAINSNOT_CONTAINSEQUALSNOT_EQUALSSTARTS_WITHNOT_STARTS_WITHENDS_WITHNOT_ENDS_WITH
torrentIdentifier
string 
可选
不使用查询条件时请勿传递此参数
torrentIdentifierCompareMethod
enum<string> 
字符串查询枚举
可选
不使用查询条件时请勿传递此参数
枚举值:
CONTAINSNOT_CONTAINSEQUALSNOT_EQUALSSTARTS_WITHNOT_STARTS_WITHENDS_WITHNOT_ENDS_WITH
torrentSize
integer 
可选
不使用查询条件时请勿传递此参数
torrentSizeCompareMethod
enum<string> 
数值查询枚举
可选
不使用查询条件时请勿传递此参数
枚举值:
LESS_THANLESS_THAN_EQUALGREATER_THANGREATER_THAN_EQUALEQUAL
peerPort
integer 
可选
不使用查询条件时请勿传递此参数
peerPortCompareMethod
enum<string> 
数值查询枚举
可选
不使用查询条件时请勿传递此参数
枚举值:
LESS_THANLESS_THAN_EQUALGREATER_THANGREATER_THAN_EQUALEQUAL
fromPeerTraffic
integer 
可选
不使用查询条件时请勿传递此参数
fromPeerTrafficSpeedCompareMethod
enum<string> 
数值查询枚举
可选
不使用查询条件时请勿传递此参数
枚举值:
LESS_THANLESS_THAN_EQUALGREATER_THANGREATER_THAN_EQUALEQUAL
toPeerTraffic
string 
可选
不使用查询条件时请勿传递此参数
toPeerTrafficCompareMethod
enum<string> 
数值查询枚举
可选
不使用查询条件时请勿传递此参数
枚举值:
LESS_THANLESS_THAN_EQUALGREATER_THANGREATER_THAN_EQUALEQUAL
toPeerTrafficSpeed
string 
可选
不使用查询条件时请勿传递此参数
toPeerTrafficSpeedCompareMethod
enum<string> 
数值查询枚举
可选
不使用查询条件时请勿传递此参数
枚举值:
LESS_THANLESS_THAN_EQUALGREATER_THANGREATER_THAN_EQUALEQUAL
peerProgress
number 
可选
不使用查询条件时请勿传递此参数
peerProgressCompareMethod
enum<string> 
数值查询枚举
可选
不使用查询条件时请勿传递此参数
枚举值:
LESS_THANLESS_THAN_EQUALGREATER_THANGREATER_THAN_EQUALEQUAL
downloaderProgress
number 
可选
不使用查询条件时请勿传递此参数
downloaderProgressCompareMethod
enum<string> 
数值查询枚举
可选
不使用查询条件时请勿传递此参数
枚举值:
LESS_THANLESS_THAN_EQUALGREATER_THANGREATER_THAN_EQUALEQUAL
orConnector
boolean 
是否使用 OR 条件连接
可选
不使用查询条件时请勿传递此参数
sortBy
array[string]
有序排序字段
可选
不使用查询条件时请勿传递此参数
sortOrder
string 
排序方式
可选
不使用查询条件时请勿传递此参数
示例
{
  "page": 0,
  "pageSize": 0,
  "timeFrom": 0,
  "timeTo": 0,
  "peerId": "string",
  "peerIdCompareMethod": "CONTAINS",
  "peerClientName": "string",
  "peerClientNameCompareMethod": "CONTAINS",
  "peerIp": "string",
  "peerIpCompareMethod": "CONTAINS",
  "torrentIdentifier": "string",
  "torrentIdentifierCompareMethod": "CONTAINS",
  "torrentSize": 0,
  "torrentSizeCompareMethod": "LESS_THAN",
  "peerPort": 0,
  "peerPortCompareMethod": "LESS_THAN",
  "fromPeerTraffic": 0,
  "fromPeerTrafficSpeedCompareMethod": "LESS_THAN",
  "toPeerTraffic": "string",
  "toPeerTrafficCompareMethod": "LESS_THAN",
  "toPeerTrafficSpeed": "string",
  "toPeerTrafficSpeedCompareMethod": "LESS_THAN",
  "peerProgress": 0,
  "peerProgressCompareMethod": "LESS_THAN",
  "downloaderProgress": 0,
  "downloaderProgressCompareMethod": "LESS_THAN",
  "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/snapshot/query' \
--header 'Content-Type: application/json' \
--data-raw ''

返回响应

🟢200成功
application/json
Body
success
boolean 
必需
message
null 
必需
data
object 
必需
page
integer 
必需
size
integer 
必需
total
integer 
必需
results
array[object (Snapshot) {15}] 
必需
示例
{
  "success": true,
  "message": null,
  "data": {
    "page": 0,
    "size": 10,
    "total": 14101,
    "results": [
      {
        "id": 14308,
        "appId": "7355608",
        "submitId": "5c11e390-203d-436d-92c8-9ce8e6a71ab7",
        "peerIp": "N/A",
        "peerPort": 62535,
        "peerId": "N/A",
        "peerClientName": "N/A",
        "torrent": {
          "id": 31,
          "identifier": "52624c810d0eea655fe5dc08e36c05965da9e7b91a453f459cf4e050b9fc3ee2",
          "size": 702869834
        },
        "fromPeerTraffic": 0,
        "fromPeerTrafficSpeed": 0,
        "toPeerTraffic": 0,
        "toPeerTrafficSpeed": 0,
        "peerProgress": 0,
        "downloaderProgress": 0.06347353356467991,
        "flags": "K ? I"
      },
      {
        "id": 14307,
        "appId": "7355608",
        "submitId": "b4c802e8-3a0c-4be9-996b-b26ac03d790f",
        "peerIp": "-BC0207-",
        "peerPort": 12226,
        "peerId": "-BC0207-",
        "peerClientName": "BitComet 2.07",
        "torrent": {
          "id": 33,
          "identifier": "659165bdf383e450e56de69e70632bec36e163ff8a3dceeea86e6ea8e5c033cc",
          "size": 645552523
        },
        "fromPeerTraffic": 458118,
        "fromPeerTrafficSpeed": 153,
        "toPeerTraffic": 0,
        "toPeerTrafficSpeed": 0,
        "peerProgress": 1,
        "downloaderProgress": 0.04139446915305449,
        "flags": "D ? I E"
      },
      {
        "id": 14306,
        "appId": "7355608",
        "submitId": "59c2e2ae-c8d4-43dd-9afe-797b4ca04806",
        "peerIp": "-qB4350-",
        "peerPort": 64573,
        "peerId": "-qB4350-",
        "peerClientName": "qBittorrent/4.3.5",
        "torrent": {
          "id": 39,
          "identifier": "216edc5cf7ae3828149f711f304d3481967c17f22ddc77c7f83ed688f516c19d",
          "size": 2785610844
        },
        "fromPeerTraffic": 566752,
        "fromPeerTrafficSpeed": 928,
        "toPeerTraffic": 0,
        "toPeerTrafficSpeed": 0,
        "peerProgress": 1,
        "downloaderProgress": 0.02494409588821948,
        "flags": "D ? I H E"
      },
      {
        "id": 14305,
        "appId": "7355608",
        "submitId": "c76d7366-c210-42e9-87be-6aabf9d7178e",
        "peerIp": "-qB4650-",
        "peerPort": 6870,
        "peerId": "-qB4650-",
        "peerClientName": "qBittorrent/4.6.5",
        "torrent": {
          "id": 74,
          "identifier": "899f5c7054eae8b0fbc05ac575cec2f407b769efe6d3390b17248436d79e5dee",
          "size": 507820038
        },
        "fromPeerTraffic": 190740,
        "fromPeerTrafficSpeed": 302,
        "toPeerTraffic": 0,
        "toPeerTrafficSpeed": 0,
        "peerProgress": 1,
        "downloaderProgress": 0.12805342667474653,
        "flags": "D ? I H E P"
      },
      {
        "id": 14304,
        "appId": "7355608",
        "submitId": "80931c12-2e11-4450-8eaf-652e5071b6a8",
        "peerIp": "-qB4330-",
        "peerPort": 13220,
        "peerId": "-qB4330-",
        "peerClientName": "qBittorrent/4.3.3",
        "torrent": {
          "id": 5,
          "identifier": "7b3ea964cc7ce7ebde42d4cdd25372c2a3da3ec7b5bcb340c04fe72058990ac1",
          "size": 51004236175
        },
        "fromPeerTraffic": 287279,
        "fromPeerTrafficSpeed": 464,
        "toPeerTraffic": 0,
        "toPeerTrafficSpeed": 0,
        "peerProgress": 1,
        "downloaderProgress": 0.0031563884899213474,
        "flags": "D ? I X E"
      },
      {
        "id": 14303,
        "appId": "7355608",
        "submitId": "d8e2d6d0-0c21-4d4f-a829-e66972ed7afb",
        "peerIp": "N/A",
        "peerPort": 29574,
        "peerId": "N/A",
        "peerClientName": "N/A",
        "torrent": {
          "id": 4,
          "identifier": "e39a9920ba61ae5ac840d53cb2b6b692d03bb629d29fca632585a01330b51f69",
          "size": 17406575718
        },
        "fromPeerTraffic": 0,
        "fromPeerTrafficSpeed": 0,
        "toPeerTraffic": 0,
        "toPeerTrafficSpeed": 0,
        "peerProgress": 0,
        "downloaderProgress": 0.0015361256822242033,
        "flags": "K ? I"
      },
      {
        "id": 14302,
        "appId": "7355608",
        "submitId": "0a46456e-3cd9-453b-ad48-576e8ae032ec",
        "peerIp": "-qB445A-",
        "peerPort": 9158,
        "peerId": "-qB445A-",
        "peerClientName": "qBittorrent Enhanced/4.4.5.10",
        "torrent": {
          "id": 32,
          "identifier": "1229c85b915ad532d112301bd304c5d70cabc4598f53d4f8be7159e47392817f",
          "size": 15543247626
        },
        "fromPeerTraffic": 188650,
        "fromPeerTrafficSpeed": 302,
        "toPeerTraffic": 0,
        "toPeerTrafficSpeed": 0,
        "peerProgress": 1,
        "downloaderProgress": 0.013337415512394412,
        "flags": "D ? I E"
      },
      {
        "id": 14301,
        "appId": "7355608",
        "submitId": "dfd16c87-223e-4cee-9bcf-6b87c9a290ca",
        "peerIp": "-BC0208-",
        "peerPort": 54926,
        "peerId": "-BC0208-",
        "peerClientName": "BitComet 2.08",
        "torrent": {
          "id": 14,
          "identifier": "7a87eb13d1afc7642d99f8ea77520553c72fb585d2c55d95fdde9becb1199b87",
          "size": 18808659828
        },
        "fromPeerTraffic": 91045,
        "fromPeerTrafficSpeed": 464,
        "toPeerTraffic": 0,
        "toPeerTrafficSpeed": 0,
        "peerProgress": 1,
        "downloaderProgress": 0.0038824397202022703,
        "flags": "D ? I E"
      },
      {
        "id": 14300,
        "appId": "7355608",
        "submitId": "099d08a4-92f6-46ac-b6d6-a3efd415ed91",
        "peerIp": "-qB4520-",
        "peerPort": 54207,
        "peerId": "-qB4520-",
        "peerClientName": "qBittorrent 4.5.2",
        "torrent": {
          "id": 72,
          "identifier": "9e5e5a85e2cf07d8d146926fbaf9df62ef7cd943a07ddc0bee8bb0a770ba3d1a",
          "size": 781554877
        },
        "fromPeerTraffic": 526294,
        "fromPeerTrafficSpeed": 739,
        "toPeerTraffic": 0,
        "toPeerTrafficSpeed": 0,
        "peerProgress": 1,
        "downloaderProgress": 0.019726502199281907,
        "flags": "D ? I E"
      },
      {
        "id": 14299,
        "appId": "7355608",
        "submitId": "499508df-b032-49c5-8504-92b41c4db2d1",
        "peerIp": "-qB4650-",
        "peerPort": 55809,
        "peerId": "-qB4650-",
        "peerClientName": "qBittorrent 4.6.5",
        "torrent": {
          "id": 36,
          "identifier": "14ab37aa836d05a7c65c0263b59949610e302dd68573ccee5555fb9a37398bca",
          "size": 299700792
        },
        "fromPeerTraffic": 472990,
        "fromPeerTrafficSpeed": 240,
        "toPeerTraffic": 0,
        "toPeerTrafficSpeed": 0,
        "peerProgress": 1,
        "downloaderProgress": 0.44572259922489627,
        "flags": "D ? I E"
      }
    ]
  }
}
修改于 2024-08-18 09:42:46
上一页
查询最近快照
下一页
列出我的用户应用程序
Built with