프록시 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 | 1분 동안 요청이 너무 많음 |
