View Categories

查询静态代理列表

接口用途

此接口用于查询账号下的静态代理节点。您可以获取代理连接信息、网络类型、所在国家或地区、购买时间、过期时间和自动续费状态。

请求信息

GET /openapi/static/node/list

完整地址：

https://{domain}/openapi/static/node/list

请求时必须携带 user-id 和 access-key Header。

Query 参数

参数是否必填类型说明
node_id否string代理 ID；查询多个代理时使用英文逗号分隔
page_no否int页码，默认值为 1
page_limit否int每页数量，默认为100，最大值为 100

查询第一页、每页 20 条记录：

GET /openapi/static/node/list?page_no=1&page_limit=20 HTTP/1.1
Host: {domain}
client-id: {your-user-id}
access-key: {your-access-key}

查询指定代理：

GET https://{domain}/openapi/static/node/list?node_id={node-id}

查询多个指定代理：

GET https://{domain}/openapi/static/node/list?node_id={node-id-1},{node-id-2}

返回字段

节点记录位于 info.items 数组中。

字段类型说明
node_idstring代理 ID
network_typeint网络类型：1 为 IPv4 机房代理，2 为 IPv6 代理，3 为住宅 IPv4 代理
region_idint产品 ID
endpoint_hoststring用于建立代理连接的主机地址
display_ipstring展示 IP
endpoint_portstring代理连接端口
access_userstring代理认证用户名
access_secretstring代理认证密码
link_typestring连接协议，例如 http 或 socks5
auto_renewint自动续费状态，值为 0 或 1
valid_untilint过期时间，Unix 时间戳（秒）
acquired_atint购买时间，Unix 时间戳（秒）
geo_codestring国家或地区代码
memostring代理备注

成功响应示例

以下内容仅为格式示例，IP、账号和密码均为示例值：

{
  "code": 0,
  "msg": "Ok",
  "info": {
    "items": [
      {
        "node_id": "xK9mP2nQ",
        "network_type": 1,
        "region_id": 101,
        "endpoint_host": "1.2.3.4",
        "display_ip": "1.2.3.4",
        "endpoint_port": "10001",
        "access_user": "user_abc",
        "access_secret": "pass_xyz",
        "link_type": "http",
        "auto_renew": 0,
        "valid_until": 1756656000,
        "acquired_at": 1754064000,
        "geo_code": "US",
        "memo": "note"
      }
    ],
    "item_total": 1,
    "page_no": 1,
    "page_limit": 20
  }
}

使用返回的代理信息

建立代理连接时，通常需要使用以下字段：

  • 服务器：endpoint_host
  • 端口：endpoint_port
  • 用户名：access_user
  • 密码：access_secret
  • 协议：link_type

access_secret 属于敏感信息。请避免将完整节点响应写入公开日志。

分页建议

如果 item_total 大于当前已获取的记录数，请增加 page_no 继续查询。单页的 page_limit 不得超过 100。