当前提供以下接口:
| 功能 | 方法 | 路径 |
|---|---|---|
| 查询代理列表 | GET | /openapi/static/node/list |
| 查询交易详情 | GET | /openapi/static/trade/detail |
| 节点续费 | POST | /openapi/static/node/renew |
完整请求地址由 QuarkIP 提供的 API 域名和接口路径组成:
https://{domain}/openapi/static/...请将 {domain} 替换为 QuarkIP 为您的账号或接入环境提供的实际域名。
开始前的准备
调用 API 前,请准备以下信息:
- API 域名
user-idaccess-key
这两项凭证必须放在每个 OpenAPI 请求的 Header 中。请勿将 access-key 写入公开网页、前端代码、截图或公开代码仓库。
发起第一次请求
下面的请求用于获取第一页代理列表,每页返回 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}将示例中的占位内容替换为您的实际信息后发送请求。请求成功时,响应中的 code 为 0,节点数据位于 info.items 中:
{
"code": 0,
"msg": "Ok",
"info": {
"items": [],
"item_total": 0,
"page_no": 1,
"page_limit": 20
}
}如果账号下暂无符合条件的节点,items 可能为空数组。
下一步
- 如需了解请求头和响应结构,请阅读 OpenAPI 鉴权与通用响应格式
- 如需查看节点字段的具体含义,请阅读 查询静态代理节点列表
- 如果请求失败,请阅读 OpenAPI 错误码与排查方法