根据资源类型获取节点列表 (Node List)
1. 接口描述
通过传入静态代理的资源类型标识符(Identifier),获取该类型下所有可供选购的地理位置节点列表。
- 请求方式:
POST - 接口地址:
https://api.cueip.com/api/static-proxy/node - 内容类型:
application/json
2. 请求头规范 (Header)
所有请求必须包含以下安全校验字段
| 字段名 | 类型 | 是否必填 | 描述 | 示例 |
|---|---|---|---|---|
| X-APP-ID | String | 是 | 应用唯一标识 (appId) | 10001 |
| X-NONCE | String | 是 | 随机数 | k9m2Pq7wL1 |
| X-TIMESTAMP | Long | 是 | 当前 Unix 时间戳 (秒) | 1713165000 |
| X-SIGN | String | 是 | 动态签名 | d3b1... |
签名生成逻辑请参考:签名生成指南
3. 请求参数说明 (Body)
| 字段名 | 类型 | 是否必填 | 描述 | 示例 |
|---|---|---|---|---|
| identifier | String | 是 | 资源类型唯一标识符 | StaticISPProxy |
4. 请求示例
http
POST /api/static-proxy/node
Host: api.cueip.com
X-APP-ID: 10001
X-NONCE: 738291
X-TIMESTAMP: 1713167000
X-SIGN: b8e2a...
Content-Type: application/json
{
"identifier": "StaticISPProxy"
}5. 响应参数说明
成功响应 (200 OK)
| 字段名 | 类型 | 描述 |
|---|---|---|
code | Integer | 状态码,0 表示成功 |
msg | String | 提示信息 |
data | Array | 节点数据列表 |
└ node | String | 节点名称 (中文,含城市或国家) |
└ nodeEn | String | 节点名称 (英文) |
└ region | String | 区域/城市代码 (下单传参使用) |
响应示例
json
{
"code": 0,
"data": [
{
"node": "中国-香港",
"nodeEn": "China-Hong Kong",
"region": "hk"
},
{
"node": "英国",
"nodeEn": "United Kingdom",
"region": "gb"
},
],
"msg": "success"
}