亿牛云1. 接口概览
这一页只负责回答三个问题：独享代理有哪些常用接口动作、每个动作返回什么、进一步调试该去哪里。如果你已经进入联调或排障阶段，请直接查看 独享代理开发手册。
接口动作
获取当前 IP
查看当前正在使用的独享代理出口 IP，以及剩余可用时间。
接口动作
手动切换 IP
主动切换到新的独享代理出口 IP，并返回切换前的 IP 信息。
接口动作
获取统计信息
查询当前 IP、上一个 IP、历史使用记录，以及切换与复用相关配置。
2. 动作速查
三个接口动作结构相似，但返回字段不同。这里统一改为 Tab 速查，避免重复的“浏览器 / curl / 字段说明”长段落和目录层级污染。
获取当前 IP
接口地址
浏览器调用
直接访问接口地址，输入用户名和密码后即可查看当前出口 IP。
curl 调用
curl -u username:password http://s1.ip.16yun.cn:887/ip示例返回
[
{
"ip": "180.102.181.64",
"ttl": 262.87515091896057
}
]
| 字段 | 含义 |
|---|---|
| ip | 当前的外网 IP；若返回 null，通常表示正在切换中，暂时没有可用 IP。 |
| ttl | 当前 IP 的剩余可用时间，单位为秒；-1 表示不会自动过期，需要手动切换。 |
手动切换 IP
接口地址
浏览器调用
直接访问接口地址，输入用户名和密码，即可触发一次手动切换。
curl 调用
curl -u username:password http://s1.ip.16yun.cn:887/switch-ip示例返回
[
{
"last_ip": "180.102.181.64",
"result": true
}
]
| 字段 | 含义 |
|---|---|
| last_ip | 切换前的 IP，便于确认本次切换动作是否生效。 |
| result | 切换结果，true 表示成功，false 表示失败。 |
获取统计信息
接口地址
浏览器调用
直接访问接口地址，输入用户名和密码，可查看当前 IP 状态与历史使用记录。
curl 调用
curl -u username:password http://s1.ip.16yun.cn:887/ip-status示例返回
[
{
"all_ip": [
[
"121.237.160.177",
"2017-03-23 14:03:39"
],
[
"49.65.179.204",
"2017-03-23 13:48:19"
]
],
"all_ip_exprie_tm": 7200,
"changeip_time": 300,
"ip": "121.237.160.177",
"last_ip": "117.62.144.170"
}
]
| 字段 | 含义 |
|---|---|
| all_ip | 曾经使用过的 IP 及对应时间。 |
| last_ip | 切换前的 IP。 |
| ip | 当前的 IP。 |
| changeip_time | IP 智能调度间隔，单位为秒；如果为 0，表示关闭。 |
| all_ip_exprie_tm | 历史 IP 在多久以内不允许重复使用，单位为秒。 |
3. 使用说明
- 三个接口都采用同一套认证方式：浏览器访问时输入账号密码，程序调用时使用
curl -u username:password或等价认证配置。 - 这一页只保留动作概览和字段速查，不展开完整调试路径，也不重复错误码说明。
- 如果你需要确认链路是否正常、排查 407 或判断代理是否真正生效，请进入 独享代理开发手册。
4. 继续调试
如果你已经从这一页确认了接口用途和返回字段，但仍需要继续联调，可按下面顺序进入更详细的说明页：
- 先看 独享代理开发手册，确认认证参数、curl 验证链路和常见问题。
- 如果已经定位到具体错误，再查看 HTTP 错误码说明。