文档
代理API集成文档
通过每个网络对应单一主机和登录凭证连接任意HTTP/SOCKS5客户端，在用户名中使用密钥选择地理位置和会话，并通过REST API管理套餐。
主机与端口
每个网络对应一个主机。HTTP/HTTPS共享首个端口，SOCKS5使用第二个端口。用户名和密码来自控制面板中的套餐信息，两种协议通用。
| 网络类型 | 主机地址 | HTTP(S) | SOCKS5 |
|---|---|---|---|
| 住宅代理 | res.proxyhive.cc | 7000 | 7001 |
| 移动代理 | mob.proxyhive.cc | 7100 | 7101 |
| 静态ISP代理 | isp.proxyhive.cc | 8000 | 8001 |
| 数据中心代理 | dc.proxyhive.cc | 7200 | 7201 |
静态ISP套餐会列出每个独立IP及其专属端口（而非共享主机）：使用套餐的用户名密码连接ip:port。
用户名密钥
密钥通过连字符附加到用户名后，可任意顺序组合。无密钥时，轮换套餐将返回随机国家的IP地址。
| 密钥 | 功能说明 | 适用网络 |
|---|---|---|
| country-us | 两位ISO国家代码。 | 住宅/移动/数据中心 |
| state-texas | 美国州或一级行政区。 | 住宅代理 |
| city-new_york | 城市名称（小写，空格用下划线替代）。 | 住宅/移动代理 |
| carrier-tmobile | 一个移动运营商，小写，无空格。 | 移动代理 |
| session-a1b2c3 | 为会话保持固定IP（6-10位字母数字组合）。 | 住宅/移动/数据中心 |
| ttl-30 | 会话IP保持时长（1-1440分钟，默认10分钟）。 | 住宅/移动/数据中心 |
USER-country-de-city-berlin-session-k7p2x9-ttl-60:PASS@res.proxyhive.cc:7000
代码示例
将USER和PASS替换为您的套餐凭证。示例代码通过网关发送请求并打印响应。
curl -x res.proxyhive.cc:7000 -U "USER-country-us:PASS" \ https://example.com
选择产品
REST API
基础地址https://proxyhive.cc/api/v1。响应为JSON格式且始终包含ok字段。公共端点无需密钥；账户端点需在请求头添加Authorization: Bearer及账户页的API密钥。
| 请求方法 | 路径 | 功能说明 | 密钥 |
|---|---|---|---|
| GET | /plans | 所有套餐信息（含ID、产品类型、流量、单价及价格）。 | 否 |
| GET | /locations | 国家池规模及城市/运营商数据。 | 否 |
| GET | /balance | 账户余额（美元）。 | 是 |
| POST | /orders | 购买套餐：需提供套餐ID及目标国家（或任意）。 | 是 |
| GET | /orders | 名下套餐（含登录凭证、剩余流量及有效期）。 | 是 |
| GET | /orders/{id} | 通过代码查询单个套餐。 | 是 |
curl -X POST https://proxyhive.cc/api/v1/orders \
-H "Authorization: Bearer phk_..." \
-H "Content-Type: application/json" \
-d '{"plan": "res-100", "country": "any"}'{
"ok": true,
"order": {
"id": "HO-7K2M9QXR4T",
"product": "resi",
"plan": "res-100",
"quantity": 100,
"unit": "GB",
"status": "active",
"gateway": { "host": "res.proxyhive.cc", "http_port": 7000, "socks5_port": 7001, "username": "...", "password": "..." }
}
}错误与限制
失败调用返回ok: false及错误代码：unauthorized（401）、bad_plan/bad_country（400）、funds（402，附仍需支付金额）、network（503，未扣费）和rate_limited（429）。每个API密钥每分钟限300次请求。