レガシーISPプラン(固定IP)

レガシーISPプランでは、固定のIPリストが提供され、各IPはポート1337で、国のみによって配置されています。このAPIを使用して、それらのIPを一覧表示し、送信元IPのホワイトリストを管理します。

認証

すべてのエンドポイントは、api_tokenクエリパラメータで認証します。パネルのAccount → API Tokensでトークンを生成してください。

?api_token=YOUR_API_TOKEN

{membership}パスパラメータには、プランの数値ID(パネルのプランページに表示される番号)またはAPI ID(プランのパネルURL末尾にある短いコード、例えばhttps://shifter.io/panel/membership/DeeJ)のいずれの形式も指定できます。どちらも同じプランに解決されます。

プロキシの一覧表示

GET https://shifter.io/api/v1/static-residential/{membership}/proxies

レガシープラン内のすべてのIPを、それぞれip:portの形式で返します。同じポート(1337)と同じユーザー名/パスワードがプール全体に適用されるため、変わるのはIPのみです。認証情報はこのレスポンスには含まれておらず、パネル内にあります。

パラメータ	場所	必須	説明
`membership`	path	yes	プランID(数値またはAPI ID)
`api_token`	query	yes	アカウントのAPIトークン

例:

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

レスポンス:

{
  "error": null,
  "code": 200,
  "data": [
    "185.199.108.153:1337",
    "185.199.108.154:1337",
    "185.199.108.155:1337"
  ]
}

各エントリはip:portの形式です。ポート(1337)とユーザー名/パスワードはプール内のすべてのIPで共通であり、変わるのはIPのみです。認証情報はパネルのMy Plansにあるプランページに記載されています。レガシープランでは、IPが配置される国は購入時に一度選択され、その後は固定されます。

承認済み送信元IP

送信元IPをホワイトリストに登録することで、スクレイパーがリクエストごとにHTTP Basic認証を省略できるようになります。ホワイトリスト登録はレガシープラン全体に適用され、ホワイトリストに登録された送信元はそのプラン内の任意のIPを使用できます。現行のISP Proxiesプランはこのipホワイトリスト登録に対応しておらず、ユーザー名とパスワードのみで認証します。

承認済みIPの一覧表示

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

パラメータ	場所	必須	説明
`membership`	path	yes	プランID
`api_token`	query	yes	アカウントのAPIトークン

レスポンス:

{
  "error": null,
  "code": 200,
  "data": [
    "198.51.100.10",
    "203.0.113.42"
  ]
}

承認済みIPの更新

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

指定された値で承認済みIPのリストを置き換えます。

パラメータ	場所	必須	説明
`membership`	path	yes	プランID
`api_token`	query	yes	アカウントのAPIトークン
`ips[]`	body	yes	ホワイトリストに登録するIPv4アドレスの配列

例(フォームエンコード、メソッドオーバーライド使用):

curl -X POST "https://shifter.io/api/v1/static-residential/YOUR_PLAN_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"

始める

プロキシ

API

リソース