이 가이드는 문제가 있는 IP를 새 IP로 교체하는 방법을 설명합니다. 프록시 하나당 하루 1회 IP 교체를 요청할 수 있습니다. 처리에 시간이 걸릴 수 있습니다.
모든 요청은 계정 대시보드의 개인 API 키를 사용합니다 (API 키 발급 방법). 아래 예시에서 YOUR_API_KEY를 본인의 키로 바꾸세요. 계정 잔액으로 결제하려면 paymentId = 1을 사용하세요.
1단계 — 교체할 프록시 찾기
활성 프록시 목록을 조회하고 교체할 각 프록시의 id를 복사하세요. 프록시 유형을 메모하세요.
엔드포인트
GET https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/proxy/list/{type}
응답
{
"status": "success",
"data": {
"items": [
{ "id": "0678564", "ip": "31.6.33.97", "country_alpha3": "BEL", "status_type": "ACTIVE", "can_prolong": true, "date_end": "23.07.2024" }
]
},
"errors": []
}
2단계 — 교체 요청
프록시 ids, type(교체 사유), 선택적 코멘트와 함께 교체 요청을 보내세요. 응답으로 새 IP가 반환됩니다.
엔드포인트
POST https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/proxy/replace
요청 본문
이름 | 유형 | 설명 |
ids | Number / Array | 단일 ID 또는 |
type | String | 교체 사유 — 아래 허용 값을 참고하세요. |
comment (선택) | String | 요청에 포함할 선택적 코멘트. |
허용되는 type 값: NOT_WORK, INCORRECT_LOCATION, CANT_CHANGE_NETWORK, LOW_SPEED, CUSTOM.
예시
https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/proxy/replace
응답
{
"status": "success",
"data": {
"ok": {
"ips": [ "31.6.33.97" ],
"msg": "Replacement request submitted"
}
},
"errors": []
}
전체 API 참조
Retrieve active proxy — 프록시 목록 조회