ドキュメント
プロキシAPIと統合ドキュメント
ネットワークごとに1つのホストと1つのログインで任意のHTTPまたはSOCKS5クライアントに接続し、ユーザー名のキーでロケーションとセッションを選択し、REST APIでプランを管理します。
ホストとポート
各ネットワークには1つのホストがあります。HTTPとHTTPSは最初のポートを共有し、SOCKS5は2番目のポートを使用します。ユーザー名とパスワードはダッシュボードのプランから取得され、両方のプロトコルで同じです。
| ネットワーク | ホスト | HTTP(S) | SOCKS5 |
|---|---|---|---|
| 住宅プロキシ | res.proxyhive.cc | 7000 | 7001 |
| モバイルプロキシ | mob.proxyhive.cc | 7100 | 7101 |
| 固定ISPプロキシ | isp.proxyhive.cc | 8000 | 8001 |
| データセンタープロキシ | dc.proxyhive.cc | 7200 | 7201 |
静的ISPプランは共有ホストではなく、各アドレスに独自のポートをリストします：ip:portにプランのユーザー名とパスワードで接続します。
ユーザー名キー
キーはハイフンでユーザー名に追加され、任意の順序で組み合わせることができます。キーなしの場合、回転プランは任意の国のランダムなアドレスを返します。
| キー | 機能 | ネットワーク |
|---|---|---|
| country-us | 2文字のISO国コード。 | 住宅用、モバイル、データセンター |
| state-texas | 米国の州または第一レベルの地域。 | 住宅用 |
| city-new_york | 都市、小文字、スペースはアンダースコア。 | 住宅用、モバイル |
| carrier-tmobile | モバイルキャリア名（小文字、スペースなし） | モバイル |
| session-a1b2c3 | セッションごとに1つのIPを保持、6〜10文字の英数字。 | 住宅用、モバイル、データセンター |
| ttl-30 | セッションがIPを保持する分数、1〜1,440。デフォルト10。 | 住宅用、モバイル、データセンター |
USER-country-de-city-berlin-session-k7p2x9-ttl-60:PASS@res.proxyhive.cc:7000
コードサンプル
USERとPASSをプランのログインに置き換えます。サンプルはゲートウェイを介して1つのリクエストを送信し、応答を表示します。
curl -x res.proxyhive.cc:7000 -U "USER-country-us:PASS" \ https://example.com
製品を選択
REST API
ベースアドレスhttps://proxyhive.cc/api/v1。応答はJSONで、常にokを含みます。公開エンドポイントはキー不要。アカウントエンドポイントにはアカウントページのAPIキーをAuthorization: Bearerヘッダーに含めます。
| メソッド | パス | 機能 | キー |
|---|---|---|---|
| GET | /plans | id、product、size、rate、priceを含む全プラン。 | いいえ |
| GET | /locations | プールサイズ、都市、キャリアを含む国。 | いいえ |
| GET | /balance | USDでのクレジット残高。 | はい |
| POST | /orders | プランを購入：プランidと国（または任意）。 | はい |
| GET | /orders | ログイン、残りトラフィック、有効期限を含むあなたのプラン。 | はい |
| GET | /orders/{id} | コードによる1つのプラン。 | はい |
curl -X POST https://proxyhive.cc/api/v1/orders \
-H "Authorization: Bearer phk_..." \
-H "Content-Type: application/json" \
-d '{"plan": "res-100", "country": "any"}'{
"ok": true,
"order": {
"id": "HO-7K2M9QXR4T",
"product": "resi",
"plan": "res-100",
"quantity": 100,
"unit": "GB",
"status": "active",
"gateway": { "host": "res.proxyhive.cc", "http_port": 7000, "socks5_port": 7001, "username": "...", "password": "..." }
}
}エラーと制限
失敗した呼び出しはok: falseでエラーコードとメッセージを返します：unauthorized (401)、bad_planまたはbad_country (400)、funds (402、必要な金額を含む)、network (503、課金なし)、rate_limited (429)。各APIキーは1分間に300リクエストを送信できます。