サブアカウント

サブアカウントは、プロキシのユーザー名に追加するラベルで、これを使って送信されたトラフィックが個別に集計されるようになります。顧客、プロジェクト、チームごとに1つ使うことで、別のプランや認証情報を用意せずに、誰が何を使ったかを確認できます。

サブアカウントはResidential Proxiesプランで利用できます。

サブアカウントの使い方

ユーザー名の直後に-subaccount-NAMEを追加します。ターゲティングおよびセッションオプションは通常どおりその後に続けます。

customer-USERNAME-subaccount-client_a-country-us-sid-abc123-ttl-600:PASSWORD@p.shifter.io:443

curl -x customer-USERNAME-subaccount-client_a:PASSWORD@p.shifter.io:443 \
  http://ip-info.com/json

パネルでResidentialプランを開き、Sub-accountsに移動します。名前を入力すると、完全なユーザー名とプロキシ行がそのままコピーできる形で表示されます。同じページにあるProxy GeneratorにもSub-accountフィールドがあり、ターゲティングとセッションを含むエンドポイントを作成できます。

ルール	詳細
使用可能文字	1文字から16文字の英数字またはアンダースコア(`A-Z`、`a-z`、`0-9`、`_`)。ハイフンは使用不可: ハイフンはユーザー名のオプションを区切るために使われます
大文字小文字	大文字小文字を区別します: `Client_A`と`client_a`は別々のサブアカウントです
範囲	プランごと: 2つのプランで同じ名前を使うと、それぞれ別のサブアカウントになります
作成	不要です。サブアカウントは最初のリクエストから数分後に表示されます
保持期間	最後のリクエストから365日後まで一覧に表示されます。その期間内に同じ名前を再利用すると、以前の履歴が引き継がれます

パネルでは、プランページに各サブアカウントの本日、過去7日間、過去30日間のトラフィックが一覧表示され、プランページとダッシュボードのトラフィックチャートは、メインアカウントと任意のサブアカウントを切り替えて表示できます。

認証

両方のエンドポイントは、Usage & Quota APIと同様に、アカウントのapi_tokenをクエリパラメータとして受け取ります。パネルのAccount → API Tokensで生成してください。各エンドポイントのレート制限は1分あたり30リクエストです。

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

サブアカウント一覧の取得

GET https://shifter.io/api/v1/memberships/{membership}/subaccounts

過去365日間にそのプランで確認されたすべてのサブアカウントを、名前順に並べて返します。

パラメータ	場所	必須	説明
`membership`	path	はい	Membership IDまたは短いコード
`api_token`	query	はい	アカウントのAPIトークン

例:

curl "https://shifter.io/api/v1/memberships/68057/subaccounts?api_token=YOUR_API_TOKEN"

レスポンス:

{
  "error": null,
  "code": 200,
  "data": {
    "id": "Rxqk",
    "subaccounts": ["BigReseller_7", "client_a", "client_b"]
  }
}

サブアカウントのトラフィックを一度も送信していないプランは、空のリストを返します。

期間を指定したサブアカウントの使用量

GET https://shifter.io/api/v1/memberships/{membership}/subaccounts/{subaccount}/usage

2つの時点の間で1つのサブアカウントが使用したトラフィックです。

パラメータ	場所	必須	説明
`membership`	path	はい	Membership IDまたは短いコード
`subaccount`	path	はい	サブアカウント名(大文字小文字を正確に指定)
`api_token`	query	はい	アカウントのAPIトークン
`start`	query	はい	期間の開始(その時刻を含む)
`end`	query	はい	期間の終了(その時刻を含まない)

startとendには、日付(2026-10-01)または完全なタイムスタンプ(2026-10-01T09:00:00)を指定でき、両者の間隔は最大366日です。時刻はトラフィックカウンターの動作基準であるパリ時間で読み取られます。

例:

curl "https://shifter.io/api/v1/memberships/68057/subaccounts/client_a/usage?start=2026-10-01&end=2026-11-01&api_token=YOUR_API_TOKEN"

レスポンス:

{
  "error": null,
  "code": 200,
  "data": {
    "id": "Rxqk",
    "subaccount": "client_a",
    "start": "2026-10-01T00:00:00",
    "end": "2026-11-01T00:00:00",
    "granularity": "day",
    "bytes": 412380000000,
    "gb": 412.38,
    "upload_bytes": 18230000000,
    "download_bytes": 394150000000,
    "requests": 9184402
  }
}

粒度

トラフィックはバケット単位で集計され、指定した期間に触れるバケットはすべて丸ごとカウントされます。

過去7日間以内に始まる期間は、1時間単位のバケットを使用します("granularity": "hour")。
それより古い期間は、1日単位のバケットを使用するため("granularity": "day")、2026-09-01T15:00:00から始まる期間は9月1日全体をカウントします。

日単位の正確な数値が必要な場合は、期間として丸1日を使用してください。

期間内にトラフィックがないサブアカウント、または期限が切れたサブアカウントは、ゼロを返します。

エラー

ステータス	意味
`400`	プランがResidential Proxiesプランでない、サブアカウント名が無効、または`start`/`end`が未指定、順序が逆、もしくは366日を超えている
`401`	`api_token`が未指定または無効
`403`	プランが所属していないワークスペースに存在する
`404`	プランが見つからない
`429`	レート制限に達しました。バックオフして再試行してください
`503`	サブアカウントのデータが一時的に利用できません。バックオフして再試行してください

始める

プロキシ

API

リソース