文件
代理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及國家（或任意）。 | 是 |
| 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個請求。