REST API 참조
이 섹션에서는 프록시 관리 API를 다룹니다. 즉 Residential Proxies, 레거시 고정 IP(pinned-IP) ISP 플랜, 레거시 포트 기반 플랜에 대한 지오 조회, 인증된 소스 IP, 지오 기본값, 프록시 목록의 프로그래밍 방식 제어입니다. 현재 ISP Proxies 플랜에는 관리 API가 없으며, 프록시 라인은 패널의 플랜 페이지에 있습니다. ISP Proxies를 참고하세요.
Base URLs
섹션 제목: “Base URLs”| Product | Base URL |
|---|---|
| Residential Proxies | https://shifter.io/api/v1/residential |
| Legacy ISP plans (pinned IPs) | https://shifter.io/api/v1/static-residential |
| Legacy plans | https://shifter.io/api/v1/backconnect |
Authentication
섹션 제목: “Authentication”Residential Proxies
섹션 제목: “Residential Proxies”api_key를 쿼리 파라미터로 전달하세요. 패널의 Account → API Keys에서 키를 생성할 수 있습니다.
curl "https://shifter.io/api/v1/residential/geo/countries?api_key=YOUR_API_KEY"Legacy ISP plans and legacy port plans
섹션 제목: “Legacy ISP plans and legacy port plans”계정의 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
섹션 제목: “Errors”모든 엔드포인트는 표준 HTTP 상태를 반환합니다. 실패 시 응답 본문에는 error와 message를 포함한 JSON 객체가 포함됩니다.
{ "error": "invalid_api_key", "message": "The provided api_key is missing or invalid"}| Status | Meaning |
|---|---|
200 | Success |
400 | Bad request (malformed or missing required parameter) |
401 | Invalid or missing credentials |
403 | Plan does not allow this feature or endpoint |
404 | Membership or resource not found |
429 | Too many requests, retry with backoff |
500 | Internal error, retry with backoff |
Method overrides
섹션 제목: “Method overrides”일부 레거시 관리 엔드포인트는 _method=PUT 폼 필드와 함께 POST를 PUT과 동등하게 처리합니다. HTTP 클라이언트가 비표준 메서드를 제거하는 경우에 유용합니다.
Proxy management APIs
섹션 제목: “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.
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.