ابحث عن عنوان IP من الخلفية لديك

استخرج من عنوان IP مُقدَّم بيانات البلد والمنطقة والمدينة والإحداثيات التقريبية المتاحة. تقبل واجهة البحث عن عنوان IP لدى Watch-IP مُدخلات IPv4 و IPv6، وتُعيد نتيجة بصيغة JSON مدعومة بقاعدة بيانات جهة خارجية لتحديد المواقع الجغرافية. استخدم مفتاح واجهة برمجية سريًا على خادمك، وابنِ تطبيقك حول التطابقات الصريحة، والسجلات المفقودة، والحقول القابلة لأن تكون فارغة.

استعرض خطط البحث ناقش الوصول إلى البحث →

قدِّم العنوان الذي تريد تحليله

استدعِ GET /v1/lookup/{ip} مع عنوان IP جمعه تطبيقك، مع مصادقة عبر Authorization: Bearer ومفتاح سري. يحلِّل البحث العنوان الموجود في الرابط نفسه، لا اتصال إجراء الطلب، ما يجعله مناسبًا لتدفقات عمل الخلفية التي تحتوي بالفعل على عناوين IP، بما في ذلك إعداد التقارير وإثراء البيانات الإقليمي. تحقَّق من كيفية حصول تطبيقك على عنوان IP الخاص بالمستخدم النهائي قبل الاعتماد على ترويسات إعادة التوجيه (forwarded headers)؛ ثِق فقط بمسار الوكيل الذي تتحكم فيه. أما بالنسبة لدمج زائر موقع ويب عادي، فتوفر نقطة نهاية تحديد الموقع الجغرافي عبر المتصفح مسارًا مختلفًا بمفتاح قابل للنشر وإثراء بيانات إقليمي.

انتقل من عنوان واحد إلى دفعة

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

ابنِ حول بيانات تقريبية

قد يمثِّل عنوان IP بوابة مشتركة، أو شبكة استضافة، أو منفذ خروج VPN، أو اتصال مشغِّل جوال. قد تكون سجلات الموقع الجغرافي ناقصة أو تختلف بين مزوِّدي البيانات. استخدم البحث كسياق للعنوان الذي قدَّمته، لا كدليل على محل إقامة شخص أو هويته.

حقول الاستجابة

ip: العنوان المُدخَل المرتبط بهذه النتيجة.
found: ما إذا كان قد عُثر على سجل مطابق في قاعدة البيانات. قد تعني القيمة false أيضًا أن قاعدة البيانات غير متاحة أو لم تُحمَّل — ولا تثبت أن العنوان لا يملك بيانات موقع جغرافي.
country, continent: رمزا البلد والقارة، عند توفرهما.
region: معرِّف تقسيم فرعي من التخطيط الحالي، وليس دائمًا اسم منطقة كاملًا.
city, latitude, longitude: المدينة والإحداثيات التقريبية، عند توفرها في قاعدة البيانات المصدر.
postalCode, timezone: لا تملؤها قاعدة البيانات المصدر الحالية — تكون دائمًا null.

أجرِ طلبًا من جانب الخادم

cURL — GET /v1/lookup/{ip}

curl --fail-with-body \
  'https://api.watch-ip.com/v1/lookup/8.8.8.8' \
  --header "Authorization: Bearer ${WATCH_IP_SECRET_KEY}"

عيِّن WATCH_IP_SECRET_KEY في بيئة خادمك أولًا. العنوان 8.8.8.8 مثال صحيح الصياغة فقط؛ ولا يعِد هذا المقتطف بقيم بلد أو مدينة أو استجابة معيَّنة له.

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

هل يمكنني استخدام هذه الواجهة البرمجية للبحث عن عنوان IP لشخص آخر؟

تقبل نقطة النهاية عنوان IP مُقدَّمًا وتُعيد بيانات موقع جغرافي متاحة من قاعدة البيانات، لا اسم شخص أو عنوانه الدقيق أو هويته. استخدم فقط البيانات المُصرَّح لك بمعالجتها.

هل تدعم IPv6؟

تتحقق نقطة النهاية من صحة مُدخلات IPv4 و IPv6. ومع ذلك قد يفتقر عنوان صحيح إلى سجل في قاعدة البيانات أو إلى بعض حقول الموقع الجغرافي.

هل يتضمن البحث المنطقة الزمنية أو رقم النظام المستقل (ASN) أو اكتشاف VPN؟

لا. لا تتضمن استجابة البحث الحالية رقم النظام المستقل (ASN) أو مؤشرات الأمان، ولا يملأ مصدرها من قاعدة بيانات الجهة الخارجية حقلي المنطقة الزمنية أو الرمز البريدي. راجع تحديد الموقع الجغرافي للزائر بشكل منفصل إذا كان نموذج العميل المتصل الخاص به يلائم تطبيقك.

هل يمكنني إرسال الطلب من جافاسكريبت المتصفح؟

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

هل هذا مشمول مع مفتاح زائر مجاني؟

لا. يستخدم البحث مفتاحًا سريًا منفصلًا وعائلة خطط منفصلة؛ ولا تمنح خطة الزائر المجانية إمكانية الوصول إلى البحث من جانب الخادم.

ماذا تعني القيمة found: false؟

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