获取节点列表

所需 OAuth scope：node:read

分页获取可用节点列表（不含敏感信息）。注意：该接口为 POST，且必须携带 JSON 请求体（至少为 {}），空请求体会返回 400。load 为综合负载百分比（带宽 50%、CPU 20%、内存 10%、连接数 20% 加权），节点无系统信息上报时不返回该字段。

鉴权：OAuth2 Access Token，Authorization: Bearer {{oauthAccessToken}}

OAuth2：支持 OAuth2 Access Token，需要 scope node:read

错误响应：

code	msg
401	authorization header is missing
401	invalid token
403	OAuth2权限不足，需要以下权限之一: node:read
400	请求参数错误
500	获取节点列表失败
500	获取节点系统信息失败

请求体可传 center=true 获取 center 地图中心坐标；无匹配坐标时省略 center。supported_protocols 未配置时可能为 null。

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

{
  "code": 200,
  "msg": "success",
  "data": {
    "nodes": [
      {
        "id": 1,
        "name": "香港-01",
        "region_code": "HK",
        "status": "online",
        "supported_protocols": [
          "tcp",
          "udp",
          "http",
          "https"
        ],
        "need_kyc": true,
        "beian_required": false,
        "frps_version": "0.69.2",
        "agent_version": "1.2.0",
        "sponsor": "LoliaFRP",
        "bandwidth": 100,
        "high_traffic": false,
        "traffic_ratio": 1,
        "remark": "",
        "load": 12.34
      }
    ],
    "total": 1,
    "page": 1,
    "limit": 20
  }
}

🟠401错误 401

🟠403错误 403

🟠400错误 400

🔴500错误 500

请求参数

请求示例代码

返回响应