اختر خطة لواجهة البرمجة التي تحتاجها

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

إنها نافذة ثابتة مدتها دقيقة واحدة، متزامنة مع دقيقة الساعة — وليست متوسطًا متحركًا. في الخطة المجانية يمكنك تنفيذ حتى 30 طلبًا بين، مثلًا، 10:32:00 و10:32:59؛ ويعود العدّاد إلى الصفر عند 10:33:00. يعيد التجاوز رمز HTTP 429 مع رأس Retry-After يوضح عدد الثواني حتى إعادة ضبط النافذة. هذا مستقل عن حجم طلباتك الشهري أدناه — فهو يحدّ من معدل الاندفاع، لا الاستخدام الكلي. يحتسب الحد استدعاءات API لا العناصر: الدفعة التي تضم حتى 100 عنوان IP أو بريد إلكتروني، أو إنشاء مهمة قائمة بريد إلكتروني، تُحتسب طلبًا واحدًا — بينما يظل كل عنوان IP أو بريد فيها يُحتسب على حدة ضمن حجم طلباتك الشهري.

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

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

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

نعم. يبقى GET /v1/geo مخصصًا فقط للبحث الذاتي للزائر من جهة العميل، ويحلّل عنوان IP المتصل فعليًا. للبحث عن عنوان IP عشوائي، يُعد GET /v1/lookup/{ip} (فردي) و POST /v1/lookup (دُفعات، حتى 100 عنوان IP لكل طلب) نقطتي وصول بين الخادم والخادم، تتم المصادقة عليهما بمفتاح سري بدلاً من مفتاحك القابل للنشر — يبقى المفتاح على خادمك الخلفي ولا يُرسل أبدًا إلى متصفح. تعتمد كلتاهما على قاعدة بيانات لتحديد الموقع الجغرافي لعنوان IP من طرف ثالث بدلاً من بيانات شبكتنا في الوقت الفعلي، بشكل استجابة مختلف ودون ترتيب دقة نسبية موثّق — راجع مصادر البيانات للمزوّد المحدد والإسناد المطلوب — ويُحتسب الاستخدام لكل عنوان IP يتم البحث عنه، يُسحب من المجمّع الشهري المشترك لخطتك بمعدل واحد لواحد مع طلب تحديد الموقع (راجع حصة البحث عن IP لخطتك أعلاه للاطلاع على الحد المنفصل لإجمالي عمليات البحث). ولأن هذه النقطة تبحث عن عناوين IP يقدّمها عميلك بدلاً من الزائر الذي يتصل بمبادرته الخاصة، فإن ذلك يجعل Watch-IP معالجًا لتلك البيانات الخاصة بطرف ثالث نيابة عنك — راجع اتفاقية معالجة البيانات (DPA) لمعرفة ما يعنيه ذلك بالنسبة لالتزامات الامتثال الخاصة بك.

يقارن POST /v1/risk/check الموقع الجغرافي من طرف ثالث لعنوان IP مُقدَّم بخط أساس مخزَّن للمستخدم ويُعيد مستوى مخاطرة منخفض/متوسط/مرتفع ومؤشر impossibleTravel. يستخدم مفتاح Bearer سري للخلفية. تواصل معنا لتأكيد التوفر والتزويد والتسعير؛ ولم يتم التحقق من تطبيق خطة المخاطر بشكل مستقل ومن جاهزية الدفع. يمكن أن تتسبب تغييرات VPN والتوجيه عبر الجوال في نتائج إيجابية كاذبة.

نعم. يستخدم POST /v1/email/validate مفتاحاً قابلاً للنشر ومقيّداً بالمصدر لفحص الصياغة والنطاقات المؤقتة المعروفة ووجود خادم بريد للنطاق والأخطاء الإملائية المحتملة والعناوين العامة، ويُرجع حكماً بالقبول أو المراجعة أو الرفض مع أسبابه. ومن الخادم الخلفي، يفحص POST /v1/email/batch حتى 100 عنوان في الاستدعاء الواحد، وتعالج مهام القوائم حتى 100,000 عنوان، ويضيف POST /v1/signup/check إشارات شبكة عنوان IP الذي يُجري التسجيل. يُحتسب كل عنوان مفحوص طلباً واحداً من الحصة الشهرية لخطتك (تحتسب مهمة القائمة كل عنوان مميز مرة واحدة). ولا يتصل أيٌّ من هذه الفحوص بصندوق البريد، لذا فهي لا تتحقق من وجود صندوق البريد أو ملكيته أو قابلية التسليم إليه.

يعتمد ذلك على نوع المفتاح. المفاتيح القابلة للنشر — المستخدمة مع GET /v1/geo وPOST /v1/email/validate — مُعدّة لتكون في شيفرة الصفحة المصدرية، مثل مفتاح Stripe أو Google Maps القابل للنشر؛ والتحكم في الوصول هو التقييد بالمصدر: يعمل كل مفتاح فقط من النطاقات التي تسجّلها، ولا يُمنح CORS إلا لمصدر مطابق. أما المفاتيح السرية — المستخدمة للبحث عن IP وفحص البريد بالجملة وفحوص التسجيل والسفر المستحيل — فيجب أن تبقى على الخادم الخلفي ولا تظهر أبداً في شيفرة المتصفح.

توجد حزم SDK مصدرية لجافاسكريبت/TypeScript وPython وPHP وGo وFlutter/Dart. تحقق من توفرها في السجل ودعمها لنقاط النهاية قبل الاستخدام. تحدد GET /v1/geo دائمًا موقع المستدعي المتصل؛ ولا يحدد الاستدعاء من الخلفية موقع زائر موقعك. استخدم البحث بالمفتاح السري لعنوان IP مُقدَّم.

نعم، لكنه اختياري: أضف ?include=hostname إلى الطلب (أو include: ["hostname"] في SDK) وستكسب الاستجابة حقل hostname، يُحل عبر بحث PTR بواسطة DNS-over-HTTPS. يكون فارغًا (null) عند عدم وجود سجل PTR. على عكس حقول الإثراء الدائمة أعلاه، يجري هذا بحثًا شبكيًا حقيقيًا داخل الطلب، لذا فهو مُعطَّل افتراضيًا بدلًا من إضافة زمن انتقال إلى كل استدعاء.

تتضمن الخطط المؤهلة مؤشرات isVpn وisTor وisDatacenter وisThreat وisSanctionedNetwork القائمة على القوائم في استجابات تحديد موقع الزوار والبحث عن IP على حد سواء؛ وتُسقط خطة Free بيانات الأمان. يدعم IPv4 المطابقة بالقوائم وبـ ASN. ويدعم IPv6 نطاقات VPN ومراكز البيانات والتهديدات إضافةً إلى المطابقة بـ ASN، لكن دون تغطية لـ Tor. وتعتمد التغطية في بيئة الإنتاج على المصادر المتاحة. تعني القيمة false عدم وجود تطابق في البيانات المتاحة، لا ضماناً للأمان؛ وهذه الإشارات ليست فحصاً نهائياً للعقوبات.

نعم — تتضمن كل استجابة كائن compliance: isGDPR (الاتحاد الأوروبي/المنطقة الاقتصادية الأوروبية + المملكة المتحدة)، وusPrivacyLaw (قانون الولاية الأمريكية المعمول به، مثل CCPA/CPRA أو VCDPA، حسب ولاية الزائر)، وisLGPD (البرازيل)، ومؤشر requiresCookieConsent المشتق، وdataResidencyZone تقريبية، وisEmbargoedCountry (حظر OFAC الشامل على بعض الدول). وهو مُضمَّن دون تكلفة إضافية في كل خطة، مثل العملة ورمز الاتصال الدولي. إنه إشارة اختصاص أولية محسوبة من موقع الزائر، وليس استشارة قانونية — تأكد دائمًا من متطلبات الامتثال مع مستشارك القانوني الخاص.

نعم — تتضمن كل استجابة كائن locale: suggestedLocale هو إعداد محلي وفق BCP47 يجمع بين بلد الزائر ورأس Accept-Language الخاص بمتصفحه، مفضّلًا لغة مُستخدَمة فعليًا هناك (فمثلًا، Accept-Language بقيمة «fr» من زائر كندي يُنتج «fr-CA»، لا «fr-FR»)، ويعود إلى الإعداد المحلي الافتراضي للبلد إذا لم يتطابق شيء في الرأس. يتضمن الكائن نفسه أيضًا measurementSystem (متري/إمبراطوري) وfirstDayOfWeek وdateFormat، لتجنّب إعادة اشتقاق اصطلاحات التنسيق الإقليمية بنفسك. مُضمَّن دون تكلفة إضافية في كل خطة.

نعم — تتضمن كل استجابة كائن holiday: isPublicHolidayToday وtodayHolidayName وnextHoliday (التاريخ والاسم) لبلد الزائر، محسوبة من جدول ثابت منسّق (نحو 40 دولة حاليًا — مجموعة العشرين + الاتحاد الأوروبي/المنطقة الاقتصادية الأوروبية + المملكة المتحدة) من مصدر Nager.Date ويُحدَّث يدويًا مرة أو مرتين سنويًا بدلًا من الحساب وقت الطلب. يكون فارغًا (null) للدول خارج تلك القائمة، ويحتسب فقط العطلات الرسمية على مستوى الدولة، لا المناسبات الخاصة بولاية أو مقاطعة. مُضمَّن دون تكلفة إضافية في كل خطة؛ ويمكن إضافة المزيد من الدول عند الطلب.

توفّر خرائط ثابتة إشارات إرشادية للعمر والاختصاص القضائي استنادًا إلى الموقع التقريبي لعنوان IP. لا تتحقق من الهوية أو العمر؛ تحقق من المتطلبات المعمول بها بشكل مستقل.