وثائق بروكسي API وطرق الاتصال

بدء سريع مع البروكسي السكني

عند شراء بروكسي سكني، سيظهر اسم المستخدم وكلمة المرور في صفحة العضو. عنوان الاتصال واحد، ويمكنك تحديد الدولة والمدينة والجلسة من خلال القيم المضافة إلى اسم المستخدم. يمكنك التحقق من الاتصال مباشرة باستخدام الأمر التالي.

• الشراء: اختر الجيجابايت المطلوبة من شاشة العضو لشراء بروكسي سكني.
• تأكيد: تحقق من اسم المستخدم (USERNAME) وكلمة المرور (PASSWORD) للبروكسي في صفحة العضو.
• الاتصال: أرسل الطلبات إلى العنوان gw.ipkite.com على منفذ HTTP 7000 أو SOCKS5 7100.

curl -x http://USERNAME:PASSWORD@gw.ipkite.com:7000 https://example.com/

صيغة معلومات اتصال البروكسي

جميع اتصالات البروكسي السكنية تستخدم نفس العنوان. يتم إرسال طلبات HTTP و HTTPS عبر المنفذ 7000، واتصالات SOCKS5 عبر المنفذ 7100. أضف المعلمات بعد اسم المستخدم بشرطة (-)، واستخدم فقط المعلمات التي تحتاجها.

USERNAME-cc-us-city-newyork-sess-a1b2c3-ttl-30:PASSWORD@gw.ipkite.com:7000

أمثلة على البروكسي الدوار والجلسة الثابتة

إذا لم تقم بإضافة قيمة sess إلى اسم المستخدم، ستعمل الخدمة كبروكسي دوار يعين عنوان IP جديد لكل طلب. بإضافة sess وttl، تصبح الجلسة ثابتة تحافظ على نفس العنوان IP للمدة المحددة (1-1440 دقيقة). غير قيمة sess فقط عندما تحتاج إلى عنوان IP جديد.

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 لتحديد المدن الرئيسية. يمكن استخدام استهداف البلد/المدينة مع الجلسات الدوارة والثابتة.

curl -x http://USERNAME-cc-de:PASSWORD@gw.ipkite.com:7000 https://example.com/

مثال بروكسي Python requests

في Python requests، ضع نفس عنوان البروكسي لكل من 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

في Node.js، يمكنك الاتصال باستخدام ProxyAgent من undici أو حزمة https-proxy-agent. كلتا الطريقتين تحتاج فقط إلى إدخال عنوان بروكسي واحد.

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);

مصادقة واجهة برمجة التطبيقات والعنوان الأساسي

واجهة برمجة التطبيقات تعمل بنظام REST وجميع الردود بصيغة JSON. عند إنشاء مفتاح API من صفحة الحساب، سيظهر المفتاح الذي يبدأ بـ ipk_live مرة واحدة فقط، لذا يرجى حفظه في مكان آمن. أضف Bearer والمفتاح في رأس Authorization لكل طلب.

• العنوان الأساسي: https://ipkite.com/api/v1
• رأس المصادقة: Authorization: Bearer <مفتاح API>
• حد الاستدعاء: 120 مرة في الدقيقة
• تنسيق الاستجابة: JSON، في حالة النجاح "ok": true

curl https://ipkite.com/api/v1/balance \
  -H "Authorization: Bearer ipk_live_YOUR_API_KEY"

نقاط نهاية واجهة برمجة التطبيقات للمطورين

{"ok":true,"balance":"25.00","currency":"USD"}

استجابات أخطاء API وحدود الاستدعاء

إذا لم يكن لديك مفتاح API أو كان غير صحيح، ستتلقى استجابة HTTP 401 مع الرسالة أدناه. تأكد من صحة اسم الرأس والمسافة بعد Bearer وإدخال المفتاح بالكامل. الحد الأقصى للاستدعاءات هو 120 في الدقيقة، وللتحقق من الرصيد أو حركة المرور المتبقية بشكل دوري، يكفي التحقق مرة واحدة في الدقيقة للبقاء ضمن الحدود.

{"ok":false,"error":"unauthorized"}