Skip to content

获取静态 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-IDString应用唯一标识 (appId)10001
X-NONCEString随机数k9m2Pq7wL1
X-TIMESTAMPLong当前 Unix 时间戳 (秒)1713165000
X-SIGNString动态签名d3b1...

签名生成逻辑请参考:签名生成指南

3. 请求参数说明 (Body)

字段名类型是否必填描述示例
proxyIdStringIP 内部唯一标识 ID86

4. 请求示例

http
POST /api/static-proxy/ip-detail
Host: api.cueip.com
Content-Type: application/json

{
    "proxyId": "86"
}

5. 响应参数说明

成功响应 (200 OK)

字段名类型描述
codeInteger状态码,0 表示成功
dataObjectIP 详细属性对象
idInteger数据库自增 ID
proxyIdString系统生成的 IP 唯一编号 (业务标识)
orderNoString所属订单编号
proxyIpString代理服务器 IP/域名
proxyPortInteger代理服务器端口
accountString认证用户名
passwordString认证密码
ipString该出口对应的实际出口 IP (Exit IP)
regionCnString归属地(中文)
regionEnString归属地(英文)
expireTimeString到期时间 (格式:yyyy-MM-dd HH:mm:ss)
statusInteger状态 (1: 正常, 2: 已过期)
msgString提示信息

响应示例

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"
}