レジデンシャルプロキシ
Updated:
レジデンシャルプロキシのパッケージ、リスト、およびセッションをプログラムで管理する。
「パッケージ」とは、定期利用プランのことです。トラフィック制限と有効期限が設定されています。パッケージ内には「リスト」を作成します。これは、GEOおよびローテーションルールによってフィルタリングされたIPアドレスのグループに名前を付けたものです。リストのログインIDとパスワードを使用してプロキシに接続し、1つのパッケージに、用途に応じて複数のリストを登録することができます。
リスト
プロキシリストの作成、設定、削除
読む
執筆
パッケージ
その他の操作
すべての住宅用エンドポイントに共通
ベースURL
https://proxy-seller.com/personal/api/v2/{YourApiKey}/resident/認証
URLパス内のAPIキー — リクエストURL全体をログに記録してはなりません。
エラーモデル
ビジネスエラーが発生した場合、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仕様書には記載されていません。統合においてこれが重要となる場合は、サポートに確認してください。