Dokumen
Dokumen API dan integrasi Proxy
Sambungkan mana-mana klien HTTP atau SOCKS5 dengan satu hos dan satu log masuk setiap rangkaian, pilih lokasi dan sesi dengan kunci dalam nama pengguna, dan urus pelan dengan API REST.
Host dan port
Setiap rangkaian mempunyai satu hos. HTTP dan HTTPS berkongsi port pertama, SOCKS5 menggunakan port kedua. Nama pengguna dan kata laluan datang dari pelan dalam dashboard anda dan sama untuk kedua-dua protokol.
| Rangkaian | Hos | HTTP(S) | SOCKS5 |
|---|---|---|---|
| Proksi perumahan | res.proxyhive.cc | 7000 | 7001 |
| Proksi mudah alih | mob.proxyhive.cc | 7100 | 7101 |
| Proksi ISP statik | isp.proxyhive.cc | 8000 | 8001 |
| Proksi pusat data | dc.proxyhive.cc | 7200 | 7201 |
Pelan ISP statik menyenaraikan setiap alamat dengan port sendiri dan bukannya hos bersama: sambungkan ke ip:port dengan nama pengguna dan kata laluan pelan anda.
Kunci nama pengguna
Kunci ditambahkan pada nama pengguna anda dengan tanda sempang dan boleh digabungkan dalam mana-mana urutan. Tanpa kunci, pelan rotating mengembalikan alamat rawak dalam mana-mana negara.
| Kunci | Apa yang dilakukannya | Rangkaian |
|---|---|---|
| country-us | Kod negara ISO dua huruf. | Residential, mobile, datacenter |
| state-texas | Negeri AS atau wilayah peringkat pertama. | Residential |
| city-new_york | Bandar, huruf kecil, ruang sebagai garis bawah. | Residential, mobile |
| carrier-tmobile | Satu pembawa mudah alih, huruf kecil, tiada ruang. | Mobile |
| session-a1b2c3 | Menyimpan satu IP untuk sesi, 6 hingga 10 huruf atau digit. | Residential, mobile, datacenter |
| ttl-30 | Minit sesi memegang IPnya, 1 hingga 1,440. Lalai 10. | Residential, mobile, datacenter |
USER-country-de-city-berlin-session-k7p2x9-ttl-60:PASS@res.proxyhive.cc:7000
Contoh kod
Gantikan USER dan PASS dengan log masuk pelan anda. Contoh menghantar satu permintaan melalui gateway dan mencetak jawapan.
curl -x res.proxyhive.cc:7000 -U "USER-country-us:PASS" \ https://example.com
API REST
Alamat asas https://proxyhive.cc/api/v1. Jawapan adalah JSON dan selalu membawa ok. Titik akhir awam tidak memerlukan kunci; titik akhir akaun memerlukan header Authorization: Bearer dengan kunci API dari halaman akaun anda.
| Kaedah | Laluan | Apa yang dilakukannya | Kunci |
|---|---|---|---|
| GET | /plans | Setiap pelan dengan id, produk, saiz, kadar dan harga. | Tidak |
| GET | /locations | Negara dengan saiz pool, bandar dan pembawa. | Tidak |
| GET | /balance | Saldo anda dalam USD. | Ya |
| POST | /orders | Beli pelan: id pelan dan negara (atau mana-mana). | Ya |
| GET | /orders | Pelan anda dengan log masuk, trafik yang tinggal dan tamat tempoh. | Ya |
| GET | /orders/{id} | Satu pelan dengan kodnya. | Ya |
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": "..." }
}
}Ralat dan had
Panggilan gagal menjawab ok: false dengan kod ralat dan mesej: unauthorized (401), bad_plan atau bad_country (400), funds (402, dengan jumlah yang masih diperlukan), network (503, tiada apa yang dicaj) dan rate_limited (429). Setiap kunci API boleh menghantar 300 permintaan seminit.
Mulakan dengan ProxyHive
Buat akaun dalam beberapa saat, tambah kredit dengan kripto dan salin log masuk proksi pertama anda. Setiap pelan bermula pada $30.