이 가이드는 동일한 IP 주소를 유지하기 위해 이미 보유한 프록시를 API로 갱신(연장)하는 방법을 설명합니다. 제때 갱신하세요 — 프록시가 만료되면 IP를 잃을 수 있습니다.
모든 요청은 계정 대시보드의 개인 API 키를 사용합니다 (API 키 발급 방법). 아래 예시에서 YOUR_API_KEY를 본인의 키로 바꾸세요. 계정 잔액으로 결제하려면 paymentId = 1을 사용하세요.
⚠️ 마지막 단계에서 잔액이 차감됩니다. 항상 계산 단계에서 비용을 먼저 확인하세요.
전체 흐름 한눈에
갱신할 프록시를 찾아 ID를 복사합니다.
결제 수단을 선택합니다(또는 잔액 사용).
갱신 비용을 계산합니다.
갱신을 실행합니다.
1단계 — 갱신할 프록시 찾기
활성 프록시 목록을 조회하고 연장할 각 프록시의 id를 복사하세요. can_prolong: true인 프록시만 갱신할 수 있습니다. 프록시 유형(ipv4, ipv6, mobile, isp, mix, mix_isp)을 메모하세요 — 다음 단계에서 필요합니다.
엔드포인트
GET https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/proxy/list/{type}
경로 매개변수
이름 | 값 | 설명 |
type (선택) |
| 가져올 프록시 유형. 생략하면 모든 유형이 반환됩니다. |
선택적 쿼리 매개변수
이름 | 유형 | 설명 |
latest | String | Y/N — 마지막 주문의 프록시만 반환합니다. |
orderId | String | 특정 orderId 또는 baseOrderNumber의 프록시를 반환합니다. |
country | String | 알파-3 국가 코드(예: FRA, USA). |
ends | String | Y — 곧 만료될 프록시만. |
예시
https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/proxy/list/ipv4
응답
{
"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",
"can_prolong": true,
"date_start": "23.06.2024",
"date_end": "23.07.2024",
"auto_renew": "N"
}
]
},
"errors": []
}
갱신할 각 프록시의 id를 복사하세요. can_prolong이 true인지 확인하세요.
2단계 — 결제 수단 선택
사용 가능한 결제 시스템을 조회하고 원하는 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": []
}
3단계 — 갱신 비용 계산
결제 전에 비용을 계산하세요. 수량 및 대여 기간 할인은 웹사이트와 동일하게 적용됩니다. 이 단계에서는 비용이 청구되지 않습니다.
엔드포인트
POST https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/prolong/calc/{type}
요청 본문
이름 | 유형 | 설명 |
ids | Number / Array | 단일 ID 또는 |
periodId | String | 갱신 기간의 ID. 사용 가능한 기간은 |
paymentId | String | 결제 시스템 ID. |
coupon (선택) | String | 쿠폰 코드(있는 경우). |
예시
https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/prolong/calc/ipv4
응답 — shows the total, your balance, the discount and the proxies being renewed:
{
"status": "success",
"data": {
"warning": "",
"balance": 40.4,
"total": 35.1,
"quantity": 5,
"currency": "USD",
"discount": 0.22,
"items": [ ... proxies being renewed ... ],
"orders": 2
},
"errors": []
}
잔액이 부족하면 Insufficient funds 경고가 표시됩니다:
{
"status": "error",
"data": {
"warning": "Insufficient funds. Total $2. Not enough $33.10",
"balance": 2,
"total": 35.1
},
"errors": []
}
4단계 — 갱신 실행(잔액 차감)
계산된 비용이 적절하면 갱신 주문을 생성하세요. 이 단계에서 잔액이 차감됩니다. 3단계와 동일한 매개변수를 사용하세요.
엔드포인트
POST https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/prolong/make/{type}
요청 본문
이름 | 유형 | 설명 |
ids | Number / Array | 단일 ID 또는 |
periodId | String | 갱신 기간의 ID( |
paymentId | String | 결제 시스템 ID. |
coupon (선택) | String | 쿠폰 코드(있는 경우). |
예시
https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/prolong/make/ipv4
응답 — returns the new order ID and your updated balance:
{
"status": "success",
"data": {
"orderId": 3388536,
"total": 35.1,
"listBaseOrderNumbers": [ "1000000_57471911" ],
"balance": 40.4
},
"errors": []
}
프록시는 동일한 IP를 유지하며 만료일이 갱신됩니다.
전체 API 참조
Extend proxies — 갱신 계산 및 실행
Retrieve active proxy — 프록시 목록 조회
Balance — 잔액 및 결제 시스템