REST APIリファレンス

このセクションでは、プロキシ管理APIについて説明します。これは、Residential Proxies、レガシーの固定IP ISPプラン、レガシーのポートベースプランに対する、ジオルックス、認可済みソースIP、ジオデフォルト、プロキシリストのプログラムによる制御です。現行のISP Proxiesプランには管理APIはありません。プロキシラインはパネル内のプランページに記載されています。ISP Proxiesを参照してください。

ベースURL

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

認証

Residential Proxies

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

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

レガシーISPプランおよびレガシーポートプラン

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

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

{membership}パスパラメータには、パネル内のプランページに表示されるMembership ID（例: 68057）、またはプランのURLに含まれる短縮コード（例: Rxqk）のいずれかを指定できます。

エラー

すべてのエンドポイントは標準の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クライアントが非標準のメソッドを取り除いてしまう場合に便利です。

プロキシ管理API

使用状況とクォータアカウント単位またはプラン単位で、帯域幅の使用状況と残りのクォータを確認します。

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

レガシーISPプラン既存顧客向けの固定IP ISPプラン。IPの一覧表示とソースIPホワイトリストの管理を行います。

レガシープランレガシーのポートベースプランに対する、認可済みIP、ジオデフォルト、ポートリストです。