เอกสาร API พร็อกซีและวิธีการเชื่อมต่อ
เรารวบรวมวิธีการเชื่อมต่อ IPKite residential proxy กับโค้ดและเครื่องมือของคุณ พร้อมตัวอย่าง API สำหรับนักพัฒนาเพื่อตรวจสอบยอดคงเหลือ, ประวัติการซื้อ, และรายการ proxy
เริ่มต้นใช้งาน Residential Proxy อย่างรวดเร็ว
เมื่อคุณซื้อ residential proxy ข้อมูล proxy username และรหัสผ่านจะแสดงในหน้าสมาชิก มีที่อยู่การเชื่อมต่อเดียว และกำหนดประเทศ เมือง และเซสชันโดยเพิ่มค่าใน username คุณสามารถตรวจสอบการเชื่อมต่อได้ทันทีด้วยคำสั่งเดียวด้านล่าง
- การซื้อ: เลือกจำนวน GB ที่ต้องการในหน้าสมาชิกเพื่อซื้อ residential proxy
- ตรวจสอบ: ตรวจสอบชื่อผู้ใช้ (USERNAME) และรหัสผ่าน (PASSWORD) ของพร็อกซีในหน้าสมาชิก
- การเชื่อมต่อ: ส่งคำขอไปยังที่อยู่ gw.ipkite.com และพอร์ต HTTP 7000 หรือ SOCKS5 7100
curl -x http://USERNAME:PASSWORD@gw.ipkite.com:7000 https://example.com/รูปแบบข้อมูลการเชื่อมต่อพร็อกซี
การเชื่อมต่อ residential proxy ทั้งหมดใช้ที่อยู่เดียวกัน คำขอ HTTP และ HTTPS ส่งไปที่พอร์ต 7000 และการเชื่อมต่อ SOCKS5 ส่งไปที่พอร์ต 7100 เพิ่มพารามิเตอร์ต่อท้ายชื่อผู้ใช้ด้วยเครื่องหมายยัติภัง (-) และเลือกใช้เฉพาะพารามิเตอร์ที่ต้องการ
| รายการ | ราคา | คำอธิบาย |
|---|---|---|
| ที่อยู่ | gw.ipkite.com | ที่อยู่เชื่อมต่อสำหรับ residential proxy ทั้งหมด |
| พอร์ต HTTP·HTTPS | 7000 | เชื่อมต่อกับเว็บไซต์ HTTP และ HTTPS ผ่าน HTTP Proxy |
| พอร์ต SOCKS5 | 7100 | เชื่อมต่อด้วยเครื่องมือและแอปที่รองรับ SOCKS5 |
| cc | รหัสประเทศสองตัวอักษร (ตัวพิมพ์เล็ก) | ตัวอย่าง: cc-us, cc-gb, cc-de |
| city | ชื่อเมือง (ตัวพิมพ์เล็ก ไม่เว้นวรรค) | ตัวอย่าง: city-newyork, city-london |
| sess | ชื่อเซสชันภาษาอังกฤษและตัวเลข | ใช้ค่าเดียวกันเพื่อคง IP เดียวกัน |
| ttl | 1-1,440(นาที) | ระยะเวลารักษา Sticky Session |
USERNAME-cc-us-city-newyork-sess-a1b2c3-ttl-30:PASSWORD@gw.ipkite.com:7000ตัวอย่างพร็อกซีหมุนเวียนและเซสชันคงที่
หากไม่เพิ่มค่า sess ในชื่อผู้ใช้ จะทำงานเป็น rotating proxy ที่ได้รับ IP ใหม่ทุกครั้งที่ร้องขอ หากเพิ่ม sess และ ttl จะกลายเป็น sticky session ที่ใช้ IP เดียวกันในช่วงเวลาที่กำหนด (1-1,440 นาที) เมื่อต้องการ IP ใหม่ แค่เปลี่ยนค่า sess
curl -x http://USERNAME:PASSWORD@gw.ipkite.com:7000 https://example.com/
curl -x http://USERNAME:PASSWORD@gw.ipkite.com:7000 https://example.com/ตัวอย่างการกำหนดเป้าหมายประเทศและเมือง
ใช้พารามิเตอร์ cc เพื่อเลือกหนึ่งใน 174 ประเทศ/ภูมิภาค และใช้พารามิเตอร์ city เพื่อระบุเมืองหลัก การกำหนดเป้าหมายประเทศ/เมืองสามารถใช้ได้ทั้ง Rotating และ Sticky Session
curl -x http://USERNAME-cc-de:PASSWORD@gw.ipkite.com:7000 https://example.com/ตัวอย่าง Python requests Proxy
ใน Python requests ให้ใส่ที่อยู่ Proxy เดียวกันสำหรับทั้ง HTTP และ HTTPS ในค่า proxies หากต้องการเชื่อมต่อด้วย SOCKS5 ให้ติดตั้ง requests[socks] และเปลี่ยนที่อยู่เป็น 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)ตัวอย่าง Node.js Proxy
ใน Node.js คุณสามารถเชื่อมต่อโดยใช้ ProxyAgent จาก undici หรือแพ็คเกจ https-proxy-agent ทั้งสองวิธีต้องการเพียงที่อยู่ 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);การรับรองและที่อยู่พื้นฐานของ Developer API
Developer API ใช้วิธี REST และทุกการตอบกลับเป็น JSON เมื่อคุณออกคีย์ API จากหน้าบัญชี คีย์ที่เริ่มต้นด้วย ipk_live_ จะแสดงเพียงครั้งเดียว โปรดบันทึกไว้ในที่ปลอดภัยทันที ทุกคำขอต้องมี Authorization header พร้อม Bearer และ API key
- ที่อยู่หลัก: https://ipkite.com/api/v1
- ส่วนหัวการยืนยันตัวตน: Authorization: Bearer <API Key>
- จำกัดการเรียก: 120 ครั้งต่อนาที
- รูปแบบการตอบกลับ: JSON หากสำเร็จจะแสดง "ok": true
curl https://ipkite.com/api/v1/balance \
-H "Authorization: Bearer ipk_live_YOUR_API_KEY"Developer API endpoint
| เมธอด | เส้นทาง | เนื้อหา | ค่าตอบสนองหลัก |
|---|---|---|---|
| GET | /balance | ยอดคงเหลือปัจจุบัน | balance, currency |
| GET | /orders | รายการประวัติการซื้อ | code, product, summary, amount, status, created_at |
| GET | /proxies | รายการ proxy ที่ซื้อ | Residential: username, password, host, http_port, socks_port, traffic_gb_left / Fixed IP: ip, port, username, password, country, expires_at |
{"ok":true,"balance":"25.00","currency":"USD"}การตอบสนองข้อผิดพลาดและขีดจำกัดการเรียกใช้ API
หากไม่มีคีย์ API หรือคีย์ไม่ถูกต้อง ระบบจะตอบสนองด้วย HTTP 401 พร้อมข้อความด้านล่าง โปรดตรวจสอบชื่อเฮดเดอร์ ช่องว่างหลัง Bearer และว่าคีย์ทั้งหมดถูกต้องหรือไม่ ขีดจำกัดการเรียกใช้คือ 120 ครั้งต่อนาที สำหรับการตรวจสอบยอดเงินหรือทราฟฟิกที่เหลือ แนะนำให้ตรวจสอบประมาณ 1 ครั้งต่อนาทีเพื่อใช้งานภายในขีดจำกัดอย่างสบาย
{"ok":false,"error":"unauthorized"}