文件
代理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-1,440分鐘，預設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和國家（或'any'）。 | 是 |
| 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次請求。