Proxy-seller

レジデンシャルプロキシ

Updated:

レジデンシャルプロキシのパッケージ、リスト、およびセッションをプログラムで管理する。

「パッケージ」とは、定期利用プランのことです。トラフィック制限と有効期限が設定されています。パッケージ内には「リスト」を作成します。これは、GEOおよびローテーションルールによってフィルタリングされたIPアドレスのグループに名前を付けたものです。リストのログインIDとパスワードを使用してプロキシに接続し、1つのパッケージに、用途に応じて複数のリストを登録することができます。

リスト

プロキシリストの作成、設定、削除

読む

GEThttps://proxy-seller.com/personal/api/v2/{apiKey}/proxy/list
既存のIPリストを取得する
パッケージ内の、認証情報、GEO、ローテーション、ホワイトリストを含むすべてのリスト。
GEThttps://proxy-seller.com/personal/api/v2/{apiKey}/resident/geo
すべての場所を取得する
リストを作成する際の、有効な国・地域・都市・ISPの値に関する参照情報。

執筆

POSThttps://proxy-seller.com/personal/api/v2/{apiKey}/resident/list/add
リストを作成する
カスタム名、GEOフィルター、認証方法を指定して、新しいリストを作成してください。
POSThttps://proxy-seller.com/personal/api/v2/{apiKey}/resident/list/rename
名称変更リスト
認証情報や設定に影響を与えることなく、リストの表示名を変更する。
POSThttps://proxy-seller.com/personal/api/v2/{apiKey}/resident/list/rotation
ローテーション設定の変更
固定表示、リクエストごと、または時間ベースのローテーション(1~3600秒)を設定してください。
DELETEhttps://proxy-seller.com/personal/api/v2/{apiKey}/resident/list/delete
削除リスト
パッケージからリストを削除してください。アクティブな接続は、約60秒以内に切断されます。

パッケージ

GEThttps://proxy-seller.com/personal/api/v2/{apiKey}/resident/package
パッケージ情報
ローテーション、トラフィック制限、有効期限、パッケージキー。
POSThttps://proxy-seller.com/personal/api/v2/{apiKey}/resident/consumption
消費コスト
リストおよび日付範囲別の支出レポート。
POSThttps://proxy-seller.com/personal/api/v2/{apiKey}/resident/traffic/details
トラフィックの使用状況
特定の日付範囲におけるリストごとの帯域幅使用量。

その他の操作

すべての住宅用エンドポイントに共通

  1. ベースURL

    https://proxy-seller.com/personal/api/v2/{YourApiKey}/resident/
  2. 認証

    URLパス内のAPIキー — リクエストURL全体をログに記録してはなりません。

  3. エラーモデル

    ビジネスエラーが発生した場合、HTTP 200 が返され、errors[] にエラー情報が格納されます。

プロキシの設定が完了したら

Cases (FAQ)common scenarios and troubleshootingOpenBalancecheck funds before extending trafficOpen

よくある質問(FAQ)

パッケージ — ご契約内容(トラフィック制限+有効期限)。一覧 — パッケージ内に格納され、地理的フィルタおよびホワイトリストフィルタが適用された、名前付きログイン/パスワードのセット。セッション — 特定の出口IPを単一の接続に一時的に紐付けるもので、オンザフライで形成される_s_… ログイン時の接尾辞。

パッケージレベルでは、リストは単に認証情報とフィルタに過ぎません。consumption-cost ログインごとに集計されます(つまりリストごと)が、実際の引き落としはパッケージプールに反映されます。

各ポートには独立した出口IPが割り当てられます。同時リクエストにはこれらを並行して使用してください。1つのポート=その時点での1つの出口IPとなります。

メインパッケージ内のリストには、認証情報/フィルタバンドルが含まれますが、そのトラフィックはパッケージのプールを上限なしで共有します。サブパッケージは、独自の有効期限とオン/オフの切り替え機能を備えた固定のトラフィック枠(traffic_limit)を確保し、削除時には未使用のトラフィックを親パッケージに返却します。 その中に作成するリストも同様に機能します。ただし、課金はサブパッケージの割り当て分に対して行われます。

APIキーを開示することなく、特定のユーザー(クライアント、チーム、キャンペーンなど)に対して厳格なトラフィック上限を設定する必要がある場合は、サブパッケージを使用してください。管理はすべて、引き続きご自身のキーを通じて行われます。ご自身のクォータ内で認証情報や地理的な隔離のみが必要な場合は、プレーンリストを使用してください。

例:https://proxy-seller.com/personal/api/v2/{YourApiKey}/resident/.... サブユーザーのバリエーションでは、/residentsubuser/....

同一IPアドレスでのHTTPおよびSOCKS5。

住宅パッケージの自動更新機能は、公開APIの対象外となっています。/extend-proxies (/prolong/calc/{type},/prolong/make/{type}) は IP ベースの型のみを受け付けます —ipv4,ipv6,mobile,isp,mix,mix_isp.resident そのリストには含まれておらず、また/resident/prolong endpoint.

ダッシュボードから、期限が切れる前に住宅パッケージを更新してください。expired_at 報告者:get-package-information。有効期限切れ時の具体的な動作(アクティブな接続、未使用トラフィックの繰り越しなど)については、API仕様書には記載されていません。統合においてこれが重要となる場合は、サポートに確認してください。

On this page