البدء السريع

قبل أن تبدأ

• حساب Watch-IP — الخطة المجانية كافية لمتابعة هذا الدليل.
• صفحة أو نص برمجي يمكنك إضافة استدعاء fetch أو curl إليه.

1. أنشئ حسابًا واحصل على مفتاح

سجّل وافتح لوحة التحكم الخاصة بك. يبدأ كل حساب بمفتاح زائر قابل للنشر — اضبط مصادره المسموح بها لتشمل الموقع الذي ستستدعيه منه (أو localhost أثناء الاختبار).

2. نفّذ أول طلب لك

استدعِ GET /v1/geo مع مفتاحك القابل للنشر في رأس X-Api-Key. من المتصفح، يحدد هذا موقع اتصال الزائر نفسه؛ ومن الخادم، يحدد موقع اتصال الخادم نفسه بدلًا من ذلك.

curl https://api.watch-ip.com/v1/geo \
  -H "X-Api-Key: YOUR_PUBLISHABLE_KEY"

3. اقرأ الاستجابة

يُعيد الطلب الناجح الحالة 200 مع جسم JSON — country وcity وtimezone هي الحقول التي تبدأ بها معظم عمليات الدمج، وكل حقل قابل لأن يكون فارغًا (null) بشكل مستقل، لذا تحقق قبل استخدامه.

{
  "ip": "203.0.113.1",
  "country": "US",
  "city": "Austin",
  "timezone": "America/Chicago"
}

4. ابحث عن عنوان IP مختلف

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

إذا حدث خطأ ما

تعني الحالة 401 أن مفتاح واجهة البرمجة مفقود أو غير صالح؛ وتعني الحالة 403 من GET /v1/geo عادةً أن المصدر المستدعي غير مدرج بعد في قائمة المصادر المسموح بها للمفتاح. راجع الأخطاء وحدود المعدل للاطلاع على القائمة الكاملة لرموز الحالة.

الخطوة التالية

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