ابحث عن عناوين IP على دفعات

أرسل قائمة من عناوين IP إلى نقطة نهاية واحدة واستلم قائمة مطابقة من نتائج الموقع الجغرافي. تقبل واجهة البحث المجمّع عن عناوين IP لدى Watch-IP ما يصل إلى 100 عنوان IPv4 و IPv6 في كل طلب لتدفقات عمل إثراء البيانات من جانب الخلفية. احتفظ بمفتاحك السري على الخادم، وعالج الاستجابة بترتيب الإدخال، وتعامل مع السجلات المفقودة دون فقدان الارتباط ببياناتك الأصلية.

استعرض خطط البحث قارِن بالبحث عن عنوان IP واحد →

طلب واحد، حتى 100 عنوان

استخدم POST /v1/lookup مع كائن JSON يحتوي على مصفوفة ips. تحتوي كل دفعة مقبولة على عنوان واحد على الأقل و100 عنوان كحد أقصى، ويمكنك مزج عناوين IPv4 و IPv6 الصحيحة في القائمة نفسها. تُغلِّف الاستجابة نتائج البحث المرتبة في مصفوفة results؛ وتستخدم كل نتيجة بنية البحث عن عنوان IP الواحد نفسها، بما في ذلك الحقل found والحقول القابلة لأن تكون فارغة.

حافظ على مواءمة النتائج مع سجلاتك المصدر

بالنسبة لدفعة ناجحة، تُعيد الواجهة البرمجية نتيجة واحدة لكل عنوان مُدخَل بالترتيب نفسه. احتفظ بمعرِّفات سجلاتك الخاصة إلى جانب القائمة المُرسَلة حتى تتمكن من ربط النتائج بصفوفك الأصلية. عندما لا يُعثر على سجل، احتفظ بالصف وضع علامة على أن الموقع غير متاح؛ وعندما يكون حقل واحد فقط مفقودًا، احتفظ ببقية النتيجة. لا تستبدل الإحداثيات المفقودة بصفر، فقد يحوِّل ذلك غياب البيانات إلى موقع على الخريطة مُضلِّل.

تحقَّق قبل الإرسال

تُنتج القائمة الفارغة، أو القائمة الأكبر من 100 عنوان، أو عنوان IP غير صحيح الصياغة خطأ طلب — إذ يرفض العنوان غير الصحيح الدفعة بأكملها بدلًا من إنتاج نتيجة نجاح جزئي للمُدخلات المتبقية. تحقَّق من المُدخلات وقسِّم القوائم الأطول إلى دفعات قبل إرسالها، واحتفظ بسجل للدفعات المكتملة حتى لا تُكرِّر إعادة المحاولة مهمة كاملة عن طريق الخطأ.

افهم ما تُغيِّره الدفعات

تُقلِّل الدفعات عدد طلبات HTTP اللازمة لإرسال قائمة. لكنها لا تُغيِّر مصدر البيانات، ولا تضيف حقول أمان، ولا تُحوِّل 100 عملية بحث إلى وحدة استخدام واحدة — إذ يُسجَّل استخدام البحث لكل عنوان IP مُرسَل في الطلبات المقبولة، لذا ينبغي أن يراعي اختيار الخطة كلًا من إجمالي حجم البحث ومعدل الطلبات. يحتسب حد المعدل في الدقيقة استدعاءات HTTP لا العناصر: الدفعة التي تضم حتى 100 عنوان IP أو بريد إلكتروني تُحتسب طلبًا واحدًا، بينما يظل كل عنصر يُحتسب على حدة ضمن الحد الشهري للطلبات.

بنية الطلب والاستجابة

ips: نص الطلب: مصفوفة JSON تضم من 1 إلى 100 عنوان IPv4 أو IPv6.
results: الاستجابة: مصفوفة مرتبة تحتوي على إدخال واحد لكل عنوان مُدخَل، بالترتيب نفسه الذي أُرسل به.
results[].found, results[].country, ...: تستخدم كل نتيجة نفس البنية وقابلية الحقول لأن تكون فارغة كما في استجابة البحث عن عنوان IP الواحد — راجع صفحة منتج البحث عن عنوان IP.

أرسل طلب دفعة

cURL — POST /v1/lookup

curl --fail-with-body \
  'https://api.watch-ip.com/v1/lookup' \
  --header "Authorization: Bearer ${WATCH_IP_SECRET_KEY}" \
  --header 'Content-Type: application/json' \
  --data '{"ips":["8.8.8.8","2001:4860:4860::8888"]}'

لا تعني عناوين العرض التوضيحي هذه قيم موقع جغرافي حالية معينة. عيِّن WATCH_IP_SECRET_KEY في بيئة خادمك أولًا.

الأسئلة الشائعة

كم عدد عناوين IP التي تتسع لها الدفعة الواحدة؟

الحد الأقصى الحالي هو 100. قسِّم القوائم الأطول إلى طلبات يحتوي كل منها على ما بين 1 و100 عنوان.

هل يمكن أن تحتوي الدفعة على IPv4 و IPv6 معًا؟

نعم. يجب أن يكون كل عنوان صحيحًا، وقد تختلف تغطية قاعدة البيانات باختلاف العنوان.

هل تُعاد النتائج بترتيب الإدخال؟

نعم. تُعيد الدفعة المقبولة الناجحة نتيجة واحدة لكل عنوان مُدخَل بالترتيب نفسه.

ماذا يحدث إذا كان أحد عناوين IP غير صحيح الصياغة؟

يُرفَض الطلب بأكمله. تحقَّق من مُدخلاتك قبل الإرسال — لا توفر نقطة النهاية هذه نجاحًا جزئيًا للمُدخلات غير الصحيحة.

هل تُحتسَب الدفعة الواحدة كعملية بحث واحدة في الفوترة؟

لا. يُقاس الاستخدام لكل عنوان IP. راجع تسعير البحث الحالي وأمثلة الفوترة الموثَّقة قبل تقدير تكلفة مهمة كبيرة.

هل يمكنني رفع ملف CSV؟

تقبل نقطة النهاية الموثَّقة مصفوفة JSON من العناوين. يمكن لتطبيقك قراءة ملف CSV الخاص به وإرسال الدفعات؛ ولا تُعد واجهة رفع CSV مُستضافة جزءًا من هذه الواجهة البرمجية.

هل يتضمن البحث المجمّع فحوصات VPN أو Tor؟

لا. الاستجابة المجمّعة الحالية هي نتيجة موقع جغرافي من قاعدة بيانات جهة خارجية. مؤشرات أمان تحديد موقع الزائر ميزة منفصلة غير موجودة في استجابات البحث.