Dokumen API proksi dan kaedah sambungan
Panduan menyambungkan proxy residen IPKite ke kod dan alat, serta API pembangun untuk memeriksa baki, sejarah pembelian dan senarai proxy dengan contoh.
Permulaan pantas proxy residential
Apabila anda membeli proksi kediaman, nama pengguna dan kata laluan proksi akan dipaparkan pada skrin ahli. Alamat sambungan adalah satu, dan anda menentukan negara, bandar, dan sesi dengan menambahkan nilai pada nama pengguna. Anda boleh menyemak sambungan dengan segera menggunakan satu baris arahan di bawah.
- Pembelian: Pilih GB yang dikehendaki pada skrin ahli untuk membeli residential proxy.
- Semak: Sahkan nama pengguna (USERNAME) dan kata laluan (PASSWORD) proxy dalam halaman ahli.
- Sambungan: Hantar permintaan ke alamat gw.ipkite.com pada port HTTP 7000 atau SOCKS5 7100.
curl -x http://USERNAME:PASSWORD@gw.ipkite.com:7000 https://example.com/Format maklumat sambungan proksi
Semua sambungan proksi kediaman menggunakan alamat yang sama. Permintaan HTTP dan HTTPS dihantar ke port 7000, sambungan SOCKS5 dihantar ke port 7100. Tambahkan parameter selepas nama pengguna dengan tanda sempang (-), dan pilih parameter yang anda mahukan.
| Item | Harga | Penerangan |
|---|---|---|
| Alamat | gw.ipkite.com | Alamat sambungan untuk semua sambungan proksi kediaman |
| Port HTTP/HTTPS | 7000 | Sambung ke laman HTTP dan HTTPS menggunakan proksi HTTP |
| Port SOCKS5 | 7100 | Terhubung di alat dan aplikasi yang mendukung SOCKS5 |
| cc | Kod negara dua huruf (huruf kecil) | Contoh: cc-us, cc-gb, cc-de |
| city | Nama bandar (huruf kecil, tanpa jarak) | Contoh: city-newyork, city-london |
| sess | Nama sesi alfanumerik | Kekalkan IP yang Sama Semasa Menggunakan Nilai yang Sama |
| ttl | 1-1,440 (minit) | Tempoh untuk mengekalkan sesi melekat |
USERNAME-cc-us-city-newyork-sess-a1b2c3-ttl-30:PASSWORD@gw.ipkite.com:7000Contoh proxy berputar dan sesi tetap
Jika tidak menambah nilai sess pada nama pengguna, ia akan berfungsi sebagai proksi berputar dengan IP baru setiap permintaan. Dengan menambah sess dan ttl, anda akan mendapat sesi tetap dengan IP yang sama untuk tempoh yang ditetapkan (1-1,440 minit). Tukar nilai sess apabila memerlukan 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 bandar
Pilih salah satu dari 174 negara/wilayah dengan parameter cc, dan persempit ke kota utama dengan parameter city. Targeting negara/kota dapat digunakan bersama dengan sesi rotating dan sticky.
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 terhubung dengan 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 dapat terhubung menggunakan ProxyAgent dari undici atau paket https-proxy-agent. 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);Pengesahan API Pembangun dan Alamat Asas
API Pembangun adalah dalam gaya REST dan semua respons adalah dalam JSON. Apabila anda mengeluarkan kunci API dari skrin akaun, kunci yang bermula dengan ipk_live_ akan dipaparkan sekali sahaja, jadi simpan dengan segera di tempat yang selamat. Masukkan Bearer dan kunci API dalam header Authorization setiap permintaan.
- Alamat asas: https://ipkite.com/api/v1
- Header pengesahan: Authorization: Bearer <API key>
- Had panggilan: 120 kali seminit
- Format respons: JSON, "ok": true jika berjaya
curl https://ipkite.com/api/v1/balance \
-H "Authorization: Bearer ipk_live_YOUR_API_KEY"Endpoint API Pembangun
| Kaedah | Laluan | Kandungan | Nilai respons utama |
|---|---|---|---|
| GET | /balance | Baki semasa | balance, currency |
| GET | /orders | Senarai sejarah pembelian | code, product, summary, amount, status, created_at |
| GET | /proxies | Senarai proxy yang dibeli | Kediaman: 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"}Respons ralat API dan had panggilan
Jika kunci API tiada atau tidak sepadan, anda akan menerima respons 401 HTTP. Pastikan nama header, jarak selepas 'Bearer', dan keseluruhan kunci dimasukkan dengan betul. Had panggilan ialah 120 kali seminit. Untuk memeriksa baki atau trafik yang tinggal, satu panggilan seminit mencukupi untuk penggunaan yang selesa dalam had.
{"ok":false,"error":"unauthorized"}