Skip to content

API التحقق من العمر للمواقع والتطبيقات

تأكد من بلوغ الزائر حدّ العمر الذي تحدده، دون أن يخزّن تطبيقك وثائق هوية أو تواريخ ميلاد.

تأكد من بلوغ الزائر حدّ العمر المطلوب

جلسة واحدة تؤدي النصفين معًا: يثبت الزائر تحكمه برقم هاتفه عبر WhatsApp، ويجيب عن سؤال العمر مرة واحدة، ويتلقى تطبيقك النتيجة: تحقق الحد أو لم يتحقق، مقابل الحد الذي حددته.

كيف يعمل التحقق من العمر

الخطوة الأولى، التحقق من الهاتف. تستدعي POST /start-verification مع flow=age وتعرض رابط WhatsApp العميق المُعاد رمز QR على سطح المكتب أو زرًا على الجوال. يرسل الزائر رسالة واحدة معبأة مسبقًا من حساب WhatsApp الخاص به، فيُثبَت التحكم بالرقم بفعل الإرسال لا برمز بعثتَه إليه.

الخطوة الثانية، ضبط الحد. يقبل الاستدعاء نفسه معاملًا اختياريًا هو min_age. إذا حذفته فسيُطبَّق الحد المضبوط في حسابك، وهو 18 ما لم تغيّره. ولا يُقبل min_age إلا مع flow=age ويجب أن يكون عددًا صحيحًا موجبًا؛ وأي قيمة أخرى تعود بالرمز 400.

الخطوة الثالثة، إكمال فحص العمر. بمجرد إثبات نصف الهاتف، تحمل الاستجابة كتلة age بالحالة pending وعنوان age_verification_url. يُرسَل إلى الزائر الرابط الواحد نفسه لمرة واحدة عبر WhatsApp، ويمكنك استخدامه لنقله في المتصفح الذي يستخدمه أصلًا. يجيب لدى مزوّد العمر، ثم يعود إلى callback_url الخاص بك مع token وإلحاق age=verified أو denied أو failed.

الخطوة الرابعة، استلام النتيجة. يُطلَق webhook ثانٍ هو age_verification_result حين يجيب المزوّد، ويبلّغ GET /check-verification-status بالأمر نفسه. وتحمل كتلة age الحقول status وverified وrequired، وهو الحد الذي فُحص فعلًا، وverified_at وprovider.

وثمة فخ يجدر معرفته قبل كتابة حلقة الاستطلاع. فحالة الجلسة نفسها تبلغ verified بمجرد إثبات رقم الهاتف، بينما يظل age.status في pending. اعتبر كتلة age هي الإشارة لخطوة العمر، لا حالة الجلسة أبدًا.

التحقق من الهاتف + التحقق من العمر

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

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

وهذا يجعل الزائر العائد رخيصًا أيضًا. فالنتيجة الناجحة تُحفَظ مقابل رقم الهاتف سنة، فمن اجتاز الحد نفسه من قبل يعيد إثبات الرقم ويحمل الإجابة السابقة بدل إعادته إلى المزوّد. وإنهاء رسالة WhatsApp بـ #reset يتخطى الذاكرة المؤقتة حين تحتاج إجابة جديدة.

تحقق من العمر دون بناء قاعدة بيانات هويات

السؤال الذي تطرحه بوابة العمر منطقي بنعم أو لا. أما معظم البيانات التي تُجمع عادةً للإجابة عنه فليست كذلك، وهذا ما يجعل أرشيف الوثائق صفقة سيئة: فينتهي بك الأمر تحتفظ بجوازات سفر ورخص قيادة لتخزّن كلمة «نعم».

ما يحتاجه تطبيقك قليل. النتيجة: verified أو denied أو failed أو ما زالت pending. والحد الذي فُحص. ووقت الإجابة والمزوّد الذي أجاب. ومعرّف الجلسة ورقم الهاتف الموثّق اللذان يربطان الإجابة بالزائر أمامك. هذه هي كتلة age كاملة إضافة إلى ما يعيده مسار الهاتف أصلًا.

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

ولا شيء من هذا بيان عن التزاماتك أنت. فما عليك فحصه، والمدة التي يجب أن تستطيع فيها إثبات أنك فحصته، وما يُعدّ أسلوبًا مقبولًا، كلها أسئلة لمستشارك القانوني وجهتك التنظيمية لا لمورّد API.

التحقق من العمر مقابل التحقق من الهوية

يجيب التحقق من العمر عن سؤال واحد: هل يبلغ هذا الزائر حدّ العمر الذي حددته؟ ويجيب التحقق من الهوية عن سؤال مختلف: من هو هذا الشخص؟ وكثيرًا ما يُباعان معًا، لكنهما ينقلان كميتين مختلفتين جدًا من البيانات.

flow=age من النوع الأول. فلا يعيد اسمًا ولا تاريخ ميلاد ولا شيئًا من وثيقة. وليس KYC، والنتيجة الناجحة ليست ادعاء هوية تستند إليه في موضع آخر. وإذا كان التزامك أن تعرف من هو العميل، فليست هذه الأداة لذلك الجزء.

وهو يرث أيضًا الافتراض الكامن تحت كل فحص قائم على الهاتف: أن الرقم يخص من يستخدمه. وإثبات التحكم بإرسال رسالة أرسخ من استلام SMS، لكن مراهقًا يصل إلى هاتف بالغ سيناريو لا يغلقه أي فحص عن بُعد كليًا. ويتناول المقال عن فحوصات العمر التي لا تتحول إلى قاعدة بيانات هويات، المرتبط أدناه، البنية والحالات الأربع والحدود بمزيد من التفصيل.

ادمج التحقق من العمر في تطبيقك

هو الاستدعاءان من نوع REST اللذان يستخدمهما كل تكامل مع Phone-Verif، مع تغيير معامل واحد. صادِق بمفتاح API في الترويسة x-api-key، وافتح الجلسة بـ flow=age، واقرأ الكتلة age من نقطة نهاية الحالة أو من الـ webhook.

  1. الزائر
  2. التحقق من الهاتف عبر WhatsApp
  3. فحص العمر لدى المزوّد
  4. نتيجة العمر
  5. تطبيقك

تجيب الخطوتان عن سؤالين مختلفين وتبقيان منفصلتين طوال الوقت. فإرسال رسالة WhatsApp يثبت أن الزائر يتحكم بذلك الرقم؛ ولا يُعامَل أبدًا دليلًا على عمره. وخطوة العمر هي التي تنتج نتيجة العمر.

curl -X POST "https://api.phone-verif.com/start-verification?flow=age&min_age=18" \
  -H "x-api-key: $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"session_id": "checkout-4821", "callback_url": "https://your-app.example/age-checked"}'

افتح جلسة بـ flow=age. إذا حذفت min_age فسيُطبَّق الحد المضبوط في حسابك، وهو 18 ما لم تغيّره.

{
  "status": "verified",
  "age": { "status": "pending", "verified": false, "required": 18 },
  "age_verification_url": "https://t.phone-verif.com/av/AbCd1234"
}

تبلغ الجلسة الحالة verified بمجرد إثبات رقم الهاتف، بينما تبقى خطوة العمر معلّقة. اقرأ age.status لا حالة الجلسة لمعرفة إجابة العمر، وأرسل الزائر إلى age_verification_url لإكمال الفحص في المتصفح الذي يستخدمه أصلًا.

{
  "event": "age_verification_result",
  "session_id": "checkout-4821",
  "validation_token": "...",
  "age": {
    "status": "verified",
    "verified": true,
    "required": 18,
    "verified_at": "2026-09-01T22:00:00.000Z",
    "provider": "ageverif"
  }
}

عندما يجيب المزوّد، يحمل webhook ثانٍ النتيجة، وتبلّغ نقطة نهاية الحالة بالكتلة نفسها.

يحتاج flow=age إلى مزوّد عمر مهيأ في حسابك. وإذا طُلب بدونه، تردّ API بالرمز 503 مع الكود age_not_configured، فيمكن تمييز خطأ الإعداد عن انقطاع الخدمة.

أسئلة شائعة عن التحقق من العمر

هل أستطيع التحقق من أن المستخدمين فوق 18 عامًا؟
نعم. افتح الجلسة بـ flow=age واحذف min_age: يفحص المسار حينئذ مقابل الحد المضبوط في حسابك، وهو 18 ما لم تغيّره في إعداداتك.
هل أستطيع استخدام حد أدنى مختلف للعمر؟
نعم. مرّر min_age في استدعاء البدء بالحد الذي تحتاجه. يجب أن يكون عددًا صحيحًا موجبًا، ولا يُقبل إلا مع flow=age، وأي قيمة أخرى تُرفض بالرمز 400. وتحتفظ كل جلسة بالحد الذي فُتحت مقابله، ويعود هذا الحد بوصفه required في كتلة age، فيعرف القارئ لاحقًا ما الذي ثبت فعلًا.
هل أحتاج إلى تخزين تاريخ ميلاد المستخدم؟
لا، ولن تستطيع لو أردت: فلا تعيد API تاريخًا. ما يعود هو هل تحقق الحد، وما كان الحد، ومتى أُجيب، وأي مزوّد أجاب.
هل أحتاج إلى تخزين وثائق الهوية؟
لا. قد يحتاج المزوّد إلى رؤية وثيقة ليكوّن إجابته؛ أما تطبيقك فلا يتلقى إلا الإجابة. ولا تعيد API شيئًا من الوثيقة، فلا شيء لتخزّنه.
هل يثبت التحقق من العمر هوية شخص ما؟
لا. يجيب flow=age عن سؤال هل يبلغ حامل رقم هاتف مثبَت حدًّا معينًا. وهو ليس تحققًا من الهوية ولا KYC: لا اسم ولا تاريخ ميلاد ولا وثيقة.
ماذا يحدث إذا فشل التحقق من العمر؟
denied وfailed نتيجتان مختلفتان ولا ينبغي دمجهما في واحدة. denied قرار من المزوّد، وإعادة التشغيل لن تغيّر الإجابة. وfailed يعني تعذّر الوصول إلى المزوّد، فلم يُتخذ أي قرار وإعادة المحاولة معقولة. ولا يُحتسب الرفض أو إخفاق المزوّد؛ أما فحص العمر المكتمل فيُحتسب وحدة ثانية فوق التحقق من الهاتف.
هل أستطيع الجمع بين التحقق من الهاتف والتحقق من العمر؟
هذا بالضبط ما هو flow=age. جلسة واحدة تثبت رقم الهاتف عبر WhatsApp ثم تشغّل خطوة العمر، وتصل النتيجتان على الجلسة نفسها. فلا تشغّل تكاملين ولا تطابق معرّفين.
هل أستطيع فرض فحص جديد لزائر عائد؟
نعم. تُعاد استخدام النتيجة الناجحة سنة مقابل رقم الهاتف والحد نفسيهما. وإنهاء رسالة التحقق عبر WhatsApp بـ #reset يتخطى الإجابة المخزنة مؤقتًا ويعيد الزائر عبر الفحص الكامل.

Related

حالات استخدام التحقق من العمر

المحتوى للبالغين

حيث لم يعد مربع الإقرار الذاتي يُعدّ فحصًا. تتحكم نتيجة العمر في الوصول قبل تقديم أي شيء، ولا يُطلب من الزائر رفع وثيقة إليك.

المقامرة عبر الإنترنت

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

الكحول والسلع المقيّدة بالعمر

المشروبات والتبغ وأجهزة التبخير والسكاكين والمذيبات والألعاب النارية. يوضع الفحص أمام الدفع، على الطلب لا على جلسة التصفح.

الألعاب

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

الأسواق الإلكترونية

قوائم مقيّدة بالقانون أو بسياستك الخاصة. يمكن إخضاع المشترين والبائعين لحدود مختلفة بفتح الجلسة بقيمة min_age مختلفة.

المنصات الاجتماعية والمجتمعية

قواعد الحد الأدنى للعمر على الحسابات أو الرسائل المباشرة أو الميزات المباشرة. ترتبط الإجابة برقم هاتف مثبَت، فتبقى بعد انتهاء الجلسة.

Build your التحقق من العمر flow today

Start integrating in minutes with clear documentation, SDKs, and global message delivery.