REST API 참조

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

Base URLs

Product	Base URL
Residential Proxies	`https://shifter.io/api/v1/residential`
ISP Proxies	`https://shifter.io/api/v1/isp`
레거시 ISP 플랜 (고정 IP)	`https://shifter.io/api/v1/static-residential`
레거시 플랜	`https://shifter.io/api/v1/backconnect`

인증

Residential Proxies

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

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

ISP Proxies, 레거시 ISP 플랜 및 레거시 포트 플랜

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

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

{membership} 경로 파라미터는 패널의 플랜 페이지에 표시된 Membership ID(예: 68057) 또는 플랜 URL의 짧은 코드(예: Rxqk) 중 하나를 사용할 수 있습니다.

Errors

모든 엔드포인트는 표준 HTTP 상태를 반환합니다. 실패 시 응답 본문에는 error와 message를 포함한 JSON 객체가 포함됩니다.

{
  "error": "invalid_api_key",
  "message": "The provided api_key is missing or invalid"
}

Status	Meaning
`200`	성공
`400`	잘못된 요청 (형식이 잘못되었거나 필수 파라미터 누락)
`401`	유효하지 않거나 누락된 인증 정보
`403`	플랜에서 이 기능 또는 엔드포인트를 허용하지 않음
`404`	멤버십 또는 리소스를 찾을 수 없음
`429`	요청이 너무 많음, 백오프 후 재시도
`500`	내부 오류, 백오프 후 재시도

Method overrides

일부 레거시 관리 엔드포인트는 _method=PUT 폼 필드와 함께 POST를 PUT과 동등하게 처리합니다. HTTP 클라이언트가 비표준 메서드를 제거하는 경우에 유용합니다.

Proxy management APIs

Usage & Quota Read your bandwidth usage and remaining quota, per account or per plan.

Residential Proxies Enumerate the available countries, regions, cities, and ASNs.

ISP Proxies 위치를 찾고, 사용자 이름을 조회하고, IP를 배치하고, IP를 다른 도시나 ISP로 이동합니다.

Legacy ISP plans Pinned-IP ISP plans for existing customers: list IPs and manage the source-IP whitelist.

Legacy plans Authorized IPs, geo defaults, and port list for legacy port-based plans.