IPKite

代理API文件與連接方法

IPKite開發者API文檔：包含代理接入代碼範例、餘額查詢、購買記錄及代理列表管理API。

取得API金鑰

住宅代理快速入門

購買住宅代理後，會員頁面會顯示代理用戶名和密碼。連接地址只有一個，透過在用戶名中添加值來指定國家、城市和會話。使用以下指令即可立即測試連接。

  • 購買方式: 在會員頁面選擇所需GB數購買住宅代理。
  • 確認步驟: 在會員頁面查看代理使用者名稱(USERNAME)與密碼(PASSWORD)。
  • 連接: 使用gw.ipkite.com地址和HTTP 7000端口或SOCKS5 7100端口發送請求。
curl -x http://USERNAME:PASSWORD@gw.ipkite.com:7000 https://example.com/

代理連線資訊格式

所有住宅代理連接使用相同的地址。HTTP和HTTPS請求發送到7000端口，SOCKS5連接發送到7100端口。在使用者名稱後用連字符(-)附加參數，並選擇所需參數。

項目值說明
地址gw.ipkite.com所有住宅代理連接的訪問地址
HTTP/HTTPS 端口7000使用 HTTP 代理連接 HTTP 和 HTTPS 網站
SOCKS5 端口7100支援 SOCKS5 的工具與應用程式連接
cc兩個字母的國家代碼（小寫）例如：cc-us, cc-gb, cc-de
city城市名稱（小寫，無空格）例如：city-newyork, city-london
sess英文·數字會話名稱使用相同值期間保持相同IP
ttl1~1,440(分鐘)固定會話的維持時間
USERNAME-cc-us-city-newyork-sess-a1b2c3-ttl-30:PASSWORD@gw.ipkite.com:7000

輪換代理與固定會話範例

如果不在使用者名稱後加上 sess 值，則會作為每次請求分配新 IP 的輪換代理運行。如果加上 sess 和 ttl，則會成為在 ttl 設定的時間（1~1,440 分鐘）內保持相同 IP 的固定會話。需要新 IP 時，只需更改 sess 值即可。

curl -x http://USERNAME:PASSWORD@gw.ipkite.com:7000 https://example.com/
curl -x http://USERNAME:PASSWORD@gw.ipkite.com:7000 https://example.com/

國家/城市定位範例

使用 cc 參數從 174 個國家·地區中選擇一個，並使用 city 參數進一步縮小到主要城市。國家·城市定位適用於輪換和固定會話。

curl -x http://USERNAME-cc-de:PASSWORD@gw.ipkite.com:7000 https://example.com/

Python requests 代理範例

在 Python requests 中，HTTP 和 HTTPS 使用相同的代理地址。如需 SOCKS5 連接，請安裝 requests[socks] 並將地址改為 socks5h://。

import requests

proxy = "http://USERNAME-cc-us-sess-a1b2c3-ttl-30:PASSWORD@gw.ipkite.com:7000"
proxies = {"http": proxy, "https": proxy}

r = requests.get("https://example.com/", proxies=proxies, timeout=30)
print(r.status_code)

Node.js 代理範例

在 Node.js 中，可使用 undici 的 ProxyAgent 或 https-proxy-agent 套件進行連接。兩種方法只需輸入一行代理地址即可。

import { ProxyAgent, fetch } from "undici";

const agent = new ProxyAgent("http://USERNAME-cc-de:PASSWORD@gw.ipkite.com:7000");
const res = await fetch("https://example.com/", { dispatcher: agent });
console.log(res.status);

開發者API驗證與基礎地址

開發者API採用REST方式，所有回應均為JSON格式。在帳戶頁面產生API金鑰後，僅會顯示一次以ipk_live_開頭的金鑰，請立即妥善保存。所有請求需在Authorization標頭中加入Bearer與API金鑰發送。

  • 基礎地址: https://ipkite.com/api/v1
  • 認證標頭: Authorization: Bearer <API金鑰>
  • 呼叫限制: 每分鐘120次
  • 回應格式: JSON，成功時返回"ok": true
curl https://ipkite.com/api/v1/balance \
  -H "Authorization: Bearer ipk_live_YOUR_API_KEY"

開發者API端點

方法路徑內容主要回應值
GET/balance當前餘額balance, currency
GET/orders交易明細列表code, product, summary, amount, status, created_at
GET/proxies已購代理列表住宅：username, password, host, http_port, socks_port, traffic_gb_left / 固定IP：ip, port, username, password, country, expires_at
{"ok":true,"balance":"25.00","currency":"USD"}

API錯誤回應與呼叫限額

若無API金鑰或金鑰錯誤，將返回HTTP 401與以下回應。請檢查標頭名稱、Bearer後空格及金鑰完整性。呼叫限額為每分鐘120次，定期檢查餘額或剩餘流量時，每分鐘查詢一次即可充裕使用限額。

{"ok":false,"error":"unauthorized"}
代理API文件，住宅代理連接方法與程式碼範例集 | IPKite