获取静态 IP 详情 (Get IP Detail)
1. 接口描述
根据 IP 的内部唯一标识 proxyId(通常从订单 IP 列表接口获得),获取该代理的完整连接配置和属性明细。该接口是获取代理服务器具体连接凭证(IP、端口、账号、密码)的核心接口。
- 请求方式:
POST - 接口地址:
https://api.cueip.com/api/static-proxy/ip-detail - 内容类型:
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)
| 字段名 | 类型 | 是否必填 | 描述 | 示例 |
|---|---|---|---|---|
| proxyId | String | 是 | IP 内部唯一标识 ID | 86 |
4. 请求示例
http
POST /api/static-proxy/ip-detail
Host: api.cueip.com
Content-Type: application/json
{
"proxyId": "86"
}5. 响应参数说明
成功响应 (200 OK)
| 字段名 | 类型 | 描述 |
|---|---|---|
code | Integer | 状态码,0 表示成功 |
data | Object | IP 详细属性对象 |
├ id | Integer | 数据库自增 ID |
├ proxyId | String | 系统生成的 IP 唯一编号 (业务标识) |
├ orderNo | String | 所属订单编号 |
├ proxyIp | String | 代理服务器 IP/域名 |
├ proxyPort | Integer | 代理服务器端口 |
├ account | String | 认证用户名 |
├ password | String | 认证密码 |
├ ip | String | 该出口对应的实际出口 IP (Exit IP) |
├ regionCn | String | 归属地(中文) |
├ regionEn | String | 归属地(英文) |
├ expireTime | String | 到期时间 (格式:yyyy-MM-dd HH:mm:ss) |
├ status | Integer | 状态 (1: 正常, 2: 已过期) |
msg | String | 提示信息 |
响应示例
json
{
"code": 0,
"data": {
"id": 86,
"proxyId": "ST260423f923bb",
"orderNo": "MO202604231536109260001",
"proxyIp": "69.17.5.72",
"proxyPort": 1337,
"account": "n9u1h8chi3v3",
"password": "py5ebe6rymxw",
"ip": "178.95.159.100",
"resType": 2,
"regionCn": "马来西亚",
"regionEn": "Malaysia",
"createTime": "2026-04-23 15:37:10",
"expireTime": "2026-05-23 15:36:45",
"status": 1
},
"msg": "success"
}