REST API 참조
이 섹션에서는 프록시 관리 API, 즉 지오 조회, 인증된 소스 IP, 지오 기본값, 그리고 Residential Proxies, ISP Proxies, 레거시 포트 기반 플랜의 프록시 목록에 대한 프로그래밍 방식 제어를 다룹니다.
기본 URL
섹션 제목: “기본 URL”| 제품 | 기본 URL |
|---|---|
| Residential Proxies | https://shifter.io/api/v1/residential |
| ISP Proxies | https://shifter.io/api/v1/static-residential |
| 레거시 플랜 | https://shifter.io/api/v1/backconnect |
Residential Proxies
섹션 제목: “Residential Proxies”api_key를 쿼리 파라미터로 전달하세요. 키는 패널의 Account → API Keys에서 생성할 수 있습니다.
curl "https://shifter.io/api/v1/residential/geo/countries?api_key=YOUR_API_KEY"ISP Proxies 및 레거시 플랜
섹션 제목: “ISP Proxies 및 레거시 플랜”계정의 API 토큰을 api_token 쿼리 파라미터로 사용하세요. 토큰은 패널의 Account → API Tokens에서 생성할 수 있습니다.
curl "https://shifter.io/api/v1/static-residential/YOUR_MEMBERSHIP_ID/proxies?api_token=YOUR_API_TOKEN"ISP 및 레거시 엔드포인트의 {membership} 경로 파라미터는 플랜 ID이며, 패널의 플랜 페이지에 표시됩니다.
모든 엔드포인트는 표준 HTTP 상태를 반환합니다. 실패 시 응답 본문에는 error와 message가 포함된 JSON 객체가 담겨 있습니다.
{ "error": "invalid_api_key", "message": "The provided api_key is missing or invalid"}| 상태 | 의미 |
|---|---|
200 | 성공 |
400 | 잘못된 요청 (형식이 잘못되었거나 필수 파라미터 누락) |
401 | 유효하지 않거나 누락된 인증 정보 |
403 | 플랜에서 이 기능 또는 엔드포인트를 허용하지 않음 |
404 | 멤버십 또는 리소스를 찾을 수 없음 |
429 | 요청이 너무 많음, 백오프 후 재시도 |
500 | 내부 오류, 백오프 후 재시도 |
메소드 오버라이드
섹션 제목: “메소드 오버라이드”일부 레거시 관리 엔드포인트는 _method=PUT 폼 필드가 포함된 POST를 PUT과 동등하게 처리합니다. 이는 HTTP 클라이언트가 비표준 메소드를 제거하는 경우에 유용합니다.
프록시 관리 API
섹션 제목: “프록시 관리 API” Residential Proxies 사용 가능한 국가, 지역, 도시, ASN을 열거합니다.
ISP Proxies 고정 IP 목록을 확인하고 소스 IP 화이트리스트를 관리합니다.
Legacy plans 레거시 포트 기반 플랜의 인증된 IP, 지오 기본값, 포트 목록입니다.