REST APIリファレンス

このセクションでは、プロキシ管理API について説明します。これは、Residential Proxies、ISP Proxies、およびレガシーなポートベースプランにおける、ジオルックス、認証済み送信元IP、ジオデフォルト、プロキシリストに対するプログラムによる制御です。

ベースURL

製品	ベースURL
Residential Proxies	`https://shifter.io/api/v1/residential`
ISP Proxies	`https://shifter.io/api/v1/static-residential`
レガシープラン	`https://shifter.io/api/v1/backconnect`

api_key をクエリパラメータとして渡します。キーはパネルの Account → API Keys で作成できます。

curl "https://shifter.io/api/v1/residential/geo/countries?api_key=YOUR_API_KEY"

アカウントのAPIトークンを api_token クエリパラメータとして使用します。パネルの Account → API Tokens で生成してください。

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

ISPおよびレガシーエンドポイントにおける {membership} パスパラメータは、プランIDであり、パネルのプランページに表示されます。

すべてのエンドポイントは標準的なHTTPステータスを返します。失敗時のレスポンスボディには、error と message を含むJSONオブジェクトが含まれます。

{
  "error": "invalid_api_key",
  "message": "The provided api_key is missing or invalid"
}

ステータス	意味
`200`	成功
`400`	不正なリクエスト（必須パラメータの形式不正または欠落）
`401`	認証情報が無効または欠落している
`403`	プランがこの機能またはエンドポイントを許可していない
`404`	メンバーシップまたはリソースが見つからない
`429`	リクエストが多すぎる。バックオフして再試行してください
`500`	内部エラー。バックオフして再試行してください

一部のレガシー管理エンドポイントは、_method=PUT フォームフィールドを伴う POST をPUTと同等のものとして受け付けます。これは、HTTPクライアントが非標準のメソッドを除去してしまう場合に有用です。

Residential Proxies 利用可能な国、地域、都市、ASNを列挙します。

ISP Proxies 固定IPの一覧表示と、送信元IPホワイトリストの管理を行います。

Legacy plans レガシーなポートベースプランにおける、認証済みIP、ジオデフォルト、ポートリストです。