ISPプロキシAPI

このAPIを使用して、ISPプロキシIPプールを列挙し、送信元IPホワイトリストを管理します。プロトコルレベルのプロキシ利用方法(host:port、認証情報)については、Products → ISP Proxiesを参照してください。

認証

すべてのエンドポイントは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すべてを、共有ポートおよび認証情報とともに返します。ポート(1337)とユーザー名/パスワードはプール全体で共通であり、変わるのはIPのみです。

Parameter	In	Required	Description
`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 → ISP Proxies で確認できます。ISP プロキシは米国、カナダ、英国、フランス、ドイツ、スペイン、イタリアで利用できます。IP の国は購入時に一度選択され、その後は固定されます。国の設定を参照してください。

許可された送信元IP

送信元IPをホワイトリストに登録すると、スクレイパーは各リクエストでHTTP Basic認証を省略できます。ホワイトリスト登録はアカウント単位であり、ホワイトリストに登録された任意の送信元は、プール内の任意の固定IPを使用できます。

許可されたIPの一覧取得

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

Parameter	In	Required	Description
`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のリストを置き換えます。

Parameter	In	Required	Description
`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

リソース