Dokumen API Proxy dan cara menghubungkan
Kami telah merangkum cara menghubungkan IPKite proxy residensial ke kode dan alat, serta API pengembang untuk memeriksa saldo, riwayat pembelian, dan daftar proxy, dilengkapi dengan contoh.
Mulai cepat dengan residential proxy
Setelah membeli residential proxy, nama pengguna dan kata sandi proxy akan muncul di layar member. Alamat koneksi hanya satu, dan Anda dapat menentukan negara, kota, dan sesi dengan menambahkan nilai ke nama pengguna. Anda dapat langsung memeriksa koneksi dengan satu perintah di bawah ini.
- Pembelian: Pilih jumlah GB yang diinginkan di halaman anggota untuk membeli residential proxy.
- Verifikasi: Periksa nama pengguna (USERNAME) dan kata sandi (PASSWORD) proxy di halaman anggota.
- Koneksi: Kirim permintaan ke alamat gw.ipkite.com dengan port HTTP 7000 atau SOCKS5 7100.
curl -x http://USERNAME:PASSWORD@gw.ipkite.com:7000 https://example.com/Format informasi koneksi proxy
Semua koneksi proxy residential menggunakan alamat yang sama. Permintaan HTTP dan HTTPS dikirim ke port 7000, koneksi SOCKS5 ke port 7100. Tambahkan parameter setelah nama pengguna dengan tanda hubung (-), dan pilih parameter yang diinginkan.
| Item | Harga | Penjelasan |
|---|---|---|
| Alamat | gw.ipkite.com | Alamat koneksi untuk semua proxy residential |
| Port HTTP/HTTPS | 7000 | Hubungkan ke situs HTTP dan HTTPS dengan proxy HTTP |
| Port SOCKS5 | 7100 | Terhubung di alat dan aplikasi yang mendukung SOCKS5 |
| cc | Kode negara dua huruf (huruf kecil) | Contoh: cc-us, cc-gb, cc-de |
| city | Nama kota (huruf kecil, tanpa spasi) | Contoh: city-newyork, city-london |
| sess | Nama Sesi Alfanumerik | Pertahankan IP yang sama selama menggunakan nilai yang sama |
| ttl | 1-1,440 (menit) | Waktu untuk mempertahankan Sesi Tetap |
USERNAME-cc-us-city-newyork-sess-a1b2c3-ttl-30:PASSWORD@gw.ipkite.com:7000Contoh proxy rotasi dan sesi tetap
Jika Anda tidak menambahkan nilai sess ke nama pengguna, proxy akan beroperasi sebagai proxy rotasi yang memberikan IP baru setiap permintaan. Jika Anda menambahkan sess dan ttl, itu akan menjadi sesi tetap yang mempertahankan IP yang sama untuk waktu yang ditentukan oleh ttl (1-1.440 menit). Anda hanya perlu mengubah nilai sess jika membutuhkan IP baru.
curl -x http://USERNAME:PASSWORD@gw.ipkite.com:7000 https://example.com/
curl -x http://USERNAME:PASSWORD@gw.ipkite.com:7000 https://example.com/Contoh targeting negara dan kota
Gunakan parameter cc untuk memilih dari 174 negara·wilayah, dan parameter city untuk mempersempit ke kota utama. Targeting negara·kota bisa digunakan bersama Rotating dan Sticky Session.
curl -x http://USERNAME-cc-de:PASSWORD@gw.ipkite.com:7000 https://example.com/Contoh Proxy Python requests
Di Python requests, masukkan alamat proxy yang sama untuk HTTP dan HTTPS di nilai proxies. Untuk SOCKS5, instal requests[socks] dan ubah alamat menjadi socks5h://.
import requests
proxy = "http://USERNAME-cc-us-sess-a1b2c3-ttl-30:PASSWORD@gw.ipkite.com:7000"
proxies = {"http": proxy, "https": proxy}
r = requests.get("https://example.com/", proxies=proxies, timeout=30)
print(r.status_code)Contoh Proxy Node.js
Di Node.js, Anda bisa menggunakan ProxyAgent dari undici atau paket https-proxy-agent untuk terhubung. Kedua metode hanya memerlukan satu baris alamat proxy.
import { ProxyAgent, fetch } from "undici";
const agent = new ProxyAgent("http://USERNAME-cc-de:PASSWORD@gw.ipkite.com:7000");
const res = await fetch("https://example.com/", { dispatcher: agent });
console.log(res.status);Autentikasi dan alamat dasar API Pengembang
API Pengembang menggunakan metode REST dan semua respons dalam format JSON. Saat Anda mengeluarkan kunci API di halaman akun, kunci yang dimulai dengan ipk_live_ hanya akan ditampilkan sekali, jadi segera simpan di tempat yang aman. Semua permintaan harus menyertakan header Authorization dengan Bearer dan kunci API.
- Alamat dasar: https://ipkite.com/api/v1
- Header Autentikasi: Authorization: Bearer <API Key>
- Batas panggilan: 120 kali per menit
- Format respons: JSON, jika sukses "ok": true
curl https://ipkite.com/api/v1/balance \
-H "Authorization: Bearer ipk_live_YOUR_API_KEY"Endpoint API Pengembang
| Metode | Rute | Konten | Nilai respons utama |
|---|---|---|---|
| GET | /balance | Saldo saat ini | balance, currency |
| GET | /orders | Daftar detail pembelian. | code, product, summary, amount, status, created_at |
| GET | /proxies | Daftar proxy yang dibeli | Residential: username, password, host, http_port, socks_port, traffic_gb_left / IP tetap: ip, port, username, password, country, expires_at |
{"ok":true,"balance":"25.00","currency":"USD"}Respon kesalahan API dan batas panggilan
Jika kunci API tidak ada atau tidak cocok, Anda akan menerima respon HTTP 401 seperti di bawah. Pastikan nama header, spasi setelah Bearer, dan seluruh kunci sudah benar. Batas panggilan adalah 120 kali per menit, dan untuk memeriksa saldo atau sisa traffic secara berkala, cukup lakukan sekali per menit untuk tetap dalam batas yang nyaman.
{"ok":false,"error":"unauthorized"}