WATAD Verify / المطوّرون

اربط التحقّق من الأرقام في دقائق.

طلب واحد يبدأ التحقّق، وضغطة واحدة في تيليجرام تثبت الرقم، وجواب موقّع يصل سيرفرك. هذا الدليل فيه كل ما تحتاجه، بخمس لغات.

Base URL https://watadnexus.com/api/verify/v1

البداية السريعة

  • خذ مفتاحاً أنشئ تطبيقاً في لوحة المطوّرين، وانسخ المفتاح السري وسرّ الـ webhook. يظهران مرة واحدة.
  • ابدأ تحقّقاً حين يكتب المستخدم رقمه، أرسل الرقم من سيرفرك وخذ رابط التحقّق، ثم أرسل المستخدم إليه.
  • استقبل النتيجة يضغط «شارك رقمي» في تيليجرام، فيصل webhook موقّع إلى سيرفرك فيه verified أو mismatch.

هذا الربط كاملاً في ملف واحد، بلغتك:

المفاتيح

كل طلب إلى الـ API يحمل المفتاح السري لتطبيقك في هيدر Authorization. المفتاح يبدأ بـ wvk_، ويبقى على سيرفرك فقط، لا في المتصفح ولا في تطبيق الهاتف.

  • نحفظ بصمة SHA-256 للمفتاح فقط، ولهذا نريك المفتاح مرة واحدة حين تنشئه.
  • إن تسرّب المفتاح، اطلب مفتاحاً جديداً من لوحة المطوّرين فيتوقف القديم فوراً.
  • لكل حساب حتى 10 تطبيقات، لكل واحد مفتاحه وسرّ الـ webhook واستهلاكه.

بدء تحقّق POST /v1/checks

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

أرسل المستخدم إلى url: يرى رمز QR على الكمبيوتر وزرّ تيليجرام على الهاتف. أو أرسله إلى telegram مباشرة إن كان على هاتفه.

قراءة التحقّق GET /v1/checks/:id

يعطيك حال التحقّق الآن. مفيد إن لم تضع webhook، أو لتتأكّد قبل أن تكمل.

الـ Webhooks

ضع رابط HTTPS في لوحة المطوّرين، فنرسل إليه POST لحظة انتهاء كل تحقّق: check.verified أو check.mismatch. إن لم يرد سيرفرك بـ 2xx نعيد المحاولة حتى ثلاث مرات.

X-Watad-Signaturet=1760348467,v1=5f2c…a91e

تحقّق من التوقيع

  • خذ t و v1 من هيدر X-Watad-Signature.
  • احسب HMAC-SHA256 بسرّ الـ webhook لتطبيقك (whs_…) على النص: t ثم نقطة ثم جسم الطلب كما وصل.
  • قارن الناتج (hex) بـ v1 مقارنة ثابتة الوقت. إن اختلفا فارفض الطلب.

الأخطاء

كل خطأ يعود بحالة HTTP وجسم JSON فيه رمز ثابت تستطيع الاعتماد عليه في كودك.

الحدود

  • 1,000
  • تحقّق مجاني كل شهر لكل تطبيق
  • دقائق قبل أن ينتهي التحقّق
  • تطبيقات لكل حساب
  • 600
  • طلب في الدقيقة لكل عنوان IP

تحتاج أكثر؟ باقة الأعمال بلا حد، مع بوت باسمك ودعم مباشر.

جاهز تبدأ؟

مفتاحك جاهز خلال دقيقة، وأول تحقّقاتك مجانية.