이 가이드는 회전이 포함된 지역 타깃 레지덴셜 목록을 만드는 방법을 설명합니다.
모든 요청은 계정 대시보드의 개인 API 키를 사용합니다 (API 키 발급 방법). 아래 예시에서 YOUR_API_KEY를 본인의 키로 바꾸세요. 계정 잔액으로 결제하려면 paymentId = 1을 사용하세요.
1단계 — 패키지 확인
레지덴셜 패키지가 활성 상태이고 트래픽이 남아 있는지 확인하세요. package_key를 복사하세요.
엔드포인트
GET https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/resident/package
응답
{
"status": "success",
"data": {
"rotation": 60,
"traffic_limit": "7516192768",
"traffic_usage": "10",
"traffic_left": "10",
"package_key": "1234567890abcdefedcb",
"expired_at": "d.m.Y",
"is_active": true,
"tarif_id": 2
},
"errors": []
}
2단계 — 사용 가능한 위치 조회
정확한 GEO 값을 알 수 있도록 사용 가능한 위치(국가 / 지역 / 도시 / ISP)를 내려받으세요. 응답은 전체 GEO 트리가 포함된 JSON/ZIP입니다.
엔드포인트
GET https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/resident/geo
응답
[
{
"code": "US",
"name": "United States",
"regions": [
{ "name": "Washington", "cities": [ { "name": "Garfield", "isps": [ "FIRST-STEP" ] } ] }
]
}
]
3단계 — 목록 생성
제목, geo 객체(2단계), export 설정, 회전 값으로 목록을 생성하세요.
엔드포인트
POST https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/resident/list/add
요청 본문
이름 | 유형 | 설명 |
title | String | 목록 이름. |
whitelist (선택) | String | 인증용 IP. 로그인:비밀번호를 쓰려면 비워 두세요. |
geo | object | GEO 데이터베이스의 |
export | object | 객체: |
rotation | Number | 로테이션: |
예시
https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/resident/list/add
응답
{
"status": "success",
"data": {
"id": 561,
"title": "US Washington Garfield FIRST-STEP",
"login": "3c8aa1d4",
"password": "AZT62Dx3",
"geo": { "country": "US", "region": "Washington", "city": "Garfield", "isp": "FIRST-STEP" },
"export": { "ports": 10000, "ext": "txt" }
},
"errors": []
}
4단계 — 새 목록 확인
생성을 확인하고 연결 정보를 얻으려면 레지덴셜 목록을 조회하세요.
엔드포인트
GET https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/resident/lists
응답
{
"status": "success",
"data": [
{ "id": 561, "title": "US Washington", "login": "3c8aa1d4", "rotation": 60 }
],
"errors": []
}