콘텐츠로 이동
로그인 가입하기

REST API 참조

이 섹션에서는 프록시 관리 API, 즉 지오 조회, 인증된 소스 IP, 지오 기본값, 그리고 Residential Proxies, ISP Proxies, 레거시 포트 기반 플랜의 프록시 목록에 대한 프로그래밍 방식 제어를 다룹니다.

제품기본 URL
Residential Proxieshttps://shifter.io/api/v1/residential
ISP Proxieshttps://shifter.io/api/v1/static-residential
레거시 플랜https://shifter.io/api/v1/backconnect

api_key를 쿼리 파라미터로 전달하세요. 키는 패널Account → API Keys에서 생성할 수 있습니다.

Terminal window
curl "https://shifter.io/api/v1/residential/geo/countries?api_key=YOUR_API_KEY"

계정의 API 토큰을 api_token 쿼리 파라미터로 사용하세요. 토큰은 패널Account → API Tokens에서 생성할 수 있습니다.

Terminal window
curl "https://shifter.io/api/v1/static-residential/YOUR_MEMBERSHIP_ID/proxies?api_token=YOUR_API_TOKEN"

ISP 및 레거시 엔드포인트의 {membership} 경로 파라미터는 플랜 ID이며, 패널의 플랜 페이지에 표시됩니다.

모든 엔드포인트는 표준 HTTP 상태를 반환합니다. 실패 시 응답 본문에는 errormessage가 포함된 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 클라이언트가 비표준 메소드를 제거하는 경우에 유용합니다.