レガシープラン管理API

このページでは、レガシーのポートベースプラン向けの管理APIについて説明します。これは、トラフィックベースのゲートウェイではなく、固定のポート範囲を持つ既存顧客向けのプランです。これらのエンドポイントを使用して、送信元IPをホワイトリストに登録し、ポートごとのジオデフォルトを設定し、割り当てられたポート一覧を取得します。

認証

すべてのエンドポイントは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

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

例:

curl "https://shifter.io/api/v1/backconnect/YOUR_PLAN_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の一覧を置き換えます。

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

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

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

ジオデフォルト

レガシーポートにはプランごとのジオ割り当てがあります。一度設定すれば、プラン内のすべてのポートが、設定された国(または高度なフィルタ)内のIPを経由してルーティングされます。

現在のジオ割り当ての取得

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

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

レスポンス:

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

ジオ割り当ての更新

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

パラメーター	場所	必須	説明
`membership`	path	はい	プランID
`api_token`	query	はい	お使いのアカウントAPIトークン
`geo[]`	body	はい	ISO-3166-1 alpha-2国コードの配列
`advanced_geo[]`	body	いいえ	高度なジオフィルター（都市またはASN）の配列

curl -X POST "https://shifter.io/api/v1/backconnect/YOUR_PLAN_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エントリの一覧を返します。

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

レスポンス:

{
  "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と同等のものとして受け付けます。

レガシープラン管理API

認証

認証済みIP

認可済みIPの一覧取得

認可済みIPの更新

ジオデフォルト

現在のジオ割り当ての取得

ジオ割り当ての更新

プロキシ一覧

メソッドオーバーライド

関連項目