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