短效代理IP开发手册
总览
API接口
| 接口名称 | 接口功能 |
|---|---|
| https://api.jiutianip.com/getdip | 获取短效IP |
| https://api.jiutianip.com/getiptime | 获取短效IP的可用时长 |
| https://api.jiutianip.com/getsurplus | 获取订单IP余量 |
测试代理可用性
错误码一览
| HTTP返回码 | Response body 内容 | 说明 |
|---|---|---|
| 407 | Proxy Auth Required | 情况一：用户名密码验证失败 情况二：白名单验证失败 |
| 471 | Auth Type Error | 认证方式检测失败 |
| 472 | Illegal Request Forbidden | 非法的请求 |
| 473 | Foreign Client Forbidden | 海外客户端 |
| 474 | Request Rate Over Limit | http请求超频、tcp连接建立超频 |
| 475 | IP As Host Forbidden | 目标地址不允许以IP地址访问 |
| 476 | Foreign Host Forbidden | 海外目标地址 |
| 477 | Miss Host | 无法解析目标主机地址 |
| 478 | Bandwidth Over Limit | 带宽超限 |
| 479 | Real-name Auth Required | 需要实名认证 |
| 480 | Host DNS Failed | 解析目标地址失败 |
| 481 | Target Port Forbidden | 目标地址端口号拒绝 |
| 482 | Public Host Required | 目标地址不是公网IP |
| 483 | Proxy Port Error | 使用了错误的端口号 |
| 484 | Proxy Auth Expired | 认证信息过期 |
| 485 | CN Client Forbidden | 中国大陆客户端禁止 |
| 486 | Backend Proxy Bandwidth Over Limit | 上级代理带宽超限 |
| 487 | Backend Proxy Refused | 上级代理拒绝连接 |
| 488 | Insufficient Traffic | 剩余流量不足 |
| 489 | Proxy Auth Invalid | 认证信息无效 |
| 490 | Unauthorized IP Usage | 未分配的ip，禁止使用 |
| 503 | Service Unavailable | 情况一：连接目标地址网络异常 情况二：获取上级代理失败 情况三：设置上级代理失败 |
开发建议
1.
2.
3.
4.
5.
使用gzip详解 使用gzip压缩传输数据可显著提升访问速度，方法非常简单：
只需在http请求的header里加上：
Accept-Encoding: gzip
收到HTTP Response后检查header里是否包含：
Content-Encoding: gzip
如果包含，则对body进行gzip解压，就能得到原始内容。
代码样例
修改于 2026-03-27 09:53:21