레거시 플랜 관리 API

이 페이지는 레거시 포트 기반 플랜을 위한 관리 API를 다룹니다 — 트래픽 기반 게이트웨이가 아닌 고정된 포트 범위를 사용하는 기존 고객(그랜드파더링 대상)을 위한 것입니다. 이 엔드포인트를 사용하여 소스 IP를 화이트리스트에 추가하고, 포트별 지역 기본값을 설정하고, 할당된 포트 목록을 가져올 수 있습니다.

참고

플랜이 새로운 트래픽 기반 Residential Proxies 모델(단일 게이트웨이 p.shifter.io:443)을 사용 중이라면, 대신 Residential Proxies API를 사용하십시오. 새 모델에서는 타겟팅이 플랜 기본값으로 저장되는 것이 아니라 요청마다 사용자명에 인코딩됩니다.

인증

모든 엔드포인트는 api_token 쿼리 파라미터로 인증합니다. 패널의 Account → API Tokens에서 토큰을 생성하십시오.

?api_token=YOUR_API_TOKEN

{membership} 경로 파라미터는 패널의 플랜 페이지에 표시되는 플랜 ID입니다.

승인된 IP

레거시 플랜은 소스 IP로만 인증합니다 — 스크래퍼가 접속하는 IP를 화이트리스트에 등록하십시오.

승인된 IP 목록 조회

GET https://shifter.io/api/v1/backconnect/{membership}/authorized-ips

Parameter	In	Required	Description
membership	path	yes	The plan ID
api_token	query	yes	Your account API token

예시:

curl "https://shifter.io/api/v1/backconnect/MEMBERSHIP_ID/authorized-ips?api_token=YOUR_API_TOKEN"

응답:

{
  "ips": ["198.51.100.10", "203.0.113.42"]
}

승인된 IP 업데이트

PUT https://shifter.io/api/v1/backconnect/{membership}/authorized-ips

제공된 값으로 승인된 IP 목록을 대체합니다.

Parameter	In	Required	Description
membership	path	yes	The plan ID
api_token	query	yes	Your account API token
ips[]	body	yes	Array of IPv4 addresses to whitelist

예시 (폼 인코딩, 메서드 오버라이드 사용):

curl -X POST "https://shifter.io/api/v1/backconnect/MEMBERSHIP_ID/authorized-ips?api_token=YOUR_API_TOKEN" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "_method=PUT&ips[]=198.51.100.10&ips[]=203.0.113.42"

지역 기본값

레거시 포트는 플랜별로 지역이 할당됩니다. 한 번 설정하면 플랜 내 모든 포트가 설정된 국가(또는 고급 필터) 내의 IP를 통해 라우팅됩니다.

현재 지역 할당 조회

GET https://shifter.io/api/v1/backconnect/{membership}/geo

Parameter	In	Required	Description
membership	path	yes	The plan ID
api_token	query	yes	Your account API token

응답:

{
  "geo": ["us", "gb"],
  "advanced_geo": []
}

지역 할당 업데이트

PUT https://shifter.io/api/v1/backconnect/{membership}/geo

Parameter	In	Required	Description
membership	path	yes	The plan ID
api_token	query	yes	Your account API token
geo[]	body	yes	Array of ISO-3166-1 alpha-2 country codes
advanced_geo[]	body	no	Array of advanced geo filters (city or ASN)

curl -X POST "https://shifter.io/api/v1/backconnect/MEMBERSHIP_ID/geo?api_token=YOUR_API_TOKEN" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "_method=PUT&geo[]=us&geo[]=uk&geo[]=ca"

프록시 목록 조회

GET https://shifter.io/api/v1/backconnect/{membership}/proxies

레거시 플랜의 각 포트에 대한 host:port 항목 목록을 반환합니다.

Parameter	In	Required	Description
membership	path	yes	The plan ID
api_token	query	yes	Your account API token

응답:

{
  "proxies": [
    { "host": "apollo.p.shifter.io", "port": 10001 },
    { "host": "zeus.p.shifter.io", "port": 10002 },
    { "host": "cronos.p.shifter.io", "port": 10003 }
  ]
}

메서드 오버라이드

프록시를 인식하는 많은 HTTP 클라이언트는 비표준 메서드를 제거합니다. 관리 API는 _method=PUT 폼 필드가 포함된 POST를 PUT과 동등한 것으로 허용합니다.

참고 자료

• 레거시 포트 모델
• 인증 — 레거시 인증이 Residential Proxies 및 ISP Proxies와 어떻게 다른지