代理API文件
經HTTPS傳輸JSON。在 Authorization 標頭中傳送API金鑰。每分鐘最多 300 次請求。
基本地址
https://wingproxy.com/api/v1
驗證
標頭 Authorization: Bearer YOUR_API_KEY。首次充值後在API金鑰頁面建立金鑰。
curl https://wingproxy.com/api/v1/account \ -H "Authorization: Bearer YOUR_API_KEY"
GET /account
餘額和流量。
回應示例
{
"balance": "42.50",
"traffic_left_gb": "8.73",
"traffic_used_gb": "1.27"
}GET /prices
各流量包大小的每GB價格。
回應示例
[
{ "from_gb": 1, "per_gb": "4.00" },
{ "from_gb": 10, "per_gb": "3.50" }
]POST /traffic {"gb": 10}
用餘額購買流量。
回應示例
{
"id": 311,
"gb": 10,
"price": "35.00",
"status": "added"
}GET /list?country=de&session=sticky&minutes=10&count=5&format=hostport
建立代理字串。country:國家代碼,留空即任何國家。session:rotating(預設)或 sticky。minutes:1至120(預設10,只限 sticky)。count:1至1000(預設10)。format:hostport(host:port:user:pass,預設)或 url(user:pass@host:port)。protocol:http(預設)或 socks5。
回應示例
{
"lines": [ "gate.example:8000:user-country-de-session-a1b2-time-10:pass" ]
}GET /usage
過去30日的每日流量。
回應示例
[
{ "day": "2026-10-13", "gb": "0.84" }
]錯誤
發生錯誤時會返回非2xx狀態碼,以及包含錯誤代碼的JSON內容。
| unauthorized | 缺少API金鑰或金鑰錯誤 |
| not_allowed | 首次充值後即可使用API |
| bad_request | 欄位缺少或錯誤 |
| not_enough_balance | 請先充值 |
| not_added | 流量未能加入,款項已退回餘額 |
| checking | 購買尚未確認,我們會核實後加入流量或退回款項 |
| no_login | 請先購買流量,屆時會建立你的代理登入資料 |
| rate_limited | 一分鐘內請求次數過多 |
