이 가이드는 API로 처음부터 새 프록시를 구매하는 방법을 설명합니다 — 사용 가능 항목 확인, 가격 계산, 주문, 구매한 IP 가져오기.
모든 요청은 계정 대시보드의 개인 API 키를 사용합니다 (API 키 발급 방법). 아래 예시에서 YOUR_API_KEY를 본인의 키로 바꾸세요. 계정 잔액으로 결제하려면 paymentId = 1을 사용하세요.
⚠️ 주문 단계에서 잔액이 차감됩니다. 항상 계산 단계에서 비용을 먼저 확인하세요.
전체 흐름 한눈에
잔액을 확인합니다.
주문 가능한 항목을 확인합니다(국가, 기간).
결제 수단을 선택합니다(또는 잔액 사용).
가격을 계산합니다.
주문합니다.
구매한 프록시를 가져옵니다.
1단계 — 잔액 확인
구매에 충분한 잔액이 있는지 확인하세요.
엔드포인트
GET https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/balance/get
응답
{
"status": "success",
"data": { "summ": 10 },
"errors": []
}
2단계 — 주문 가능 항목 확인
Reference List는 주문에 필요한 모든 것을 반환합니다: 국가, 기간, 타깃, 통신사, 로테이션(모바일). 필요한 countryId와 periodId를 복사하세요.
엔드포인트
GET https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/reference/list/{type}
경로 매개변수
이름 | 값 | 설명 |
type |
| 프록시 유형(ipv4, ipv6, mobile, isp, mix, mix_isp). |
예시
https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/reference/list/ipv4
응답
{
"status": "success",
"data": {
"items": [
{
"country": [ { "id": 561, "name": "France", "alpha3": "FRA" } ],
"period": [ { "id": "1m", "name": "1 month" } ]
}
]
},
"errors": []
}
3단계 — 결제 수단 선택
사용 가능한 결제 시스템을 조회하고 원하는 id를 paymentId로 복사하세요. 잔액으로 결제하려면 paymentId = 1을 사용하세요.
엔드포인트
GET https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/balance/payments/list
응답
{
"status": "success",
"data": {
"items": [
{ "id": "30", "name": "Visa / MasterCard" },
{ "id": "41", "name": "USDT (TRC-20)" },
{ "id": "29", "name": "PayPal" },
{ "id": "35", "name": "Binance" }
]
},
"errors": []
}
4단계 — 가격 계산
구매 전에 주문 가격을 계산하세요. 수량 및 대여 기간 할인은 웹사이트와 동일하게 적용됩니다. 이 단계에서는 비용이 청구되지 않습니다.
본문 필드는 프록시 유형에 따라 다릅니다. 공통 필드는 아래에 있으며, IPv6는 protocol, 모바일은 operatorId + rotationId, 레지덴셜은 tarifId를 함께 전달하세요 — 모두 Reference List에서.
엔드포인트
POST https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/order/calc
요청 본문
이름 | 유형 | 설명 |
countryId | Number | Reference List의 국가 ID(2단계). |
periodId | String | Reference List의 대여 기간 ID. |
quantity | Number | 주문할 프록시 수량. |
paymentId | Number | 결제 시스템 ID. |
coupon (선택) | String | 쿠폰 코드(있는 경우). |
authorization (선택) | String | 인증 방식. 로그인:비밀번호를 쓰려면 비워 두세요. |
customTargetName (선택) | String | 필요 시 사용자 지정 타깃 이름. |
예시
https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/order/calc
응답 — shows the total, your balance, the discount and the per-proxy price:
{
"status": "success",
"data": {
"warning": "",
"balance": 2000,
"total": 9,
"quantity": 5,
"currency": "USD",
"discount": 0.45,
"price": 1.8
},
"errors": []
}
5단계 — 주문하기(잔액 차감)
계산된 가격이 적절하면 주문하세요. 이 단계에서 잔액이 차감됩니다. 4단계와 동일한 매개변수를 사용하세요. 응답에서 orderId를 복사하세요.
엔드포인트
POST https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/order/make
요청 본문
이름 | 유형 | 설명 |
countryId | Number | Reference List의 국가 ID(2단계). |
periodId | String | Reference List의 대여 기간 ID. |
quantity | Number | 주문할 프록시 수량. |
paymentId | Number | 결제 시스템 ID. |
coupon (선택) | String | 쿠폰 코드(있는 경우). |
authorization (선택) | String | 인증 방식. 로그인:비밀번호를 쓰려면 비워 두세요. |
generateAuth (선택) | String | Y/N — 사용자 지정 인증 생성(기본값 N). |
예시
https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/order/make
응답 — returns the new order ID and your updated balance:
{
"status": "success",
"data": {
"orderId": 2426273,
"total": 16.2,
"listBaseOrderNumbers": [ "3388485_57471911" ],
"balance": 1776.88
},
"errors": []
}
6단계 — 구매한 프록시 가져오기
구매한 프록시를 가져옵니다. 이전 단계의 orderId로 필터링하면 정확히 무엇을 구매했는지 볼 수 있습니다.
엔드포인트
GET https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/proxy/list/{type}
응답
{
"status": "success",
"data": {
"items": [
{
"id": "0678564",
"order_id": "123456",
"ip": "31.6.33.97",
"protocol": "HTTP",
"port_http": 12345,
"port_socks": 12345,
"login": "ruht5734hg",
"password": "gou5h437g",
"country": "Belgium",
"country_alpha3": "BEL",
"status_type": "ACTIVE",
"date_start": "23.06.2024",
"date_end": "23.07.2024"
}
]
},
"errors": []
}
전체 API 참조
Order actions — 참조 목록, 계산 및 주문
Retrieve active proxy — 프록시 목록 조회
Balance — 잔액 및 결제 시스템