API参考

REST API 参考文档

通过程序化方式管理代理区域、查看用量统计、控制IP轮换。Base URL: https://api.Iphtml.io/v2

认证方式

所有API请求均通过API密钥进行认证。请在请求头中携带 Authorization Bearer Token。

HTTP Header

Authorization: Bearer YOUR_API_KEY

可在控制台的「API」页面获取您的API密钥。

速率限制

管理API限制为每分钟60次请求。超出限制将返回429状态码。

端点类型	限制	时间窗口
普通	60 req	1 min
流量日志	10 req	1 min
余额查询	30 req	1 min

错误码

状态码	说明
200	请求成功
400	请求参数有误
401	未授权 — API密钥无效或缺失
404	资源不存在
429	请求过于频繁，请稍后再试
500	服务器内部错误

获取代理凭据

GET /v2/proxy/credentials

获取您账号的代理用户名、密码及所有可用端点。

响应示例

200 OK — application/json

{
  "username":  "user_a1b2c3",
  "password":  "s3cr3tpass",
  "endpoints": {
    "residential_http":  "server.iphtml.biz:15000",
    "residential_socks5": "server.iphtml.biz:15001",
    "datacenter_http":   "stc.iphtml.biz:15000",
    "mobile_http":       "stc.iphtml.biz:15001",
    "static_http":       "stc.iphtml.io:15000"
  }
}

可用国家列表

GET /v2/proxy/countries

返回所有支持定向的国家列表，包含ISO代码及可用IP数量。

响应示例

200 OK

{
  "countries": [
    { "code": "US", "name": "United States", "ip_count": 15200000 },
    { "code": "GB", "name": "United Kingdom", "ip_count": 3100000  },
    { "code": "DE", "name": "Germany",        "ip_count": 2500000  }
    // ... 220+ total
  ],
  "total": 224
}

用量统计

GET /v2/account/usage

返回账号的流量用量、余额及请求统计信息。

查询参数

参数	类型	必填	说明
from	string	可选	开始日期 YYYY-MM-DD
to	string	可选	结束日期 YYYY-MM-DD
proxy_type	string	可选	residential \| datacenter \| mobile \| static

200 OK

{
  "balance_gb":    42.5,
  "used_gb":       7.5,
  "total_requests": 148320,
  "success_rate":  97.3,
  "period": {
    "from": "2025-01-01",
    "to":   "2025-01-31"
  }
}