> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

# التحقق من رقم الهاتف API: رمز SMS وإشارات المخاطر

> تحقق من الهاتف عبر رمز SMS لمرة واحدة، مع كشف الناقل والأرقام الافتراضية والمؤقتة. الدفع حسب الاستخدام: سعر الناقل + $0.02، دون عقود. مقدّم من Didit.

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

## Endpoints

> [card] [إرسال رمز الهاتف](https://docs.didit.me/ar/standalone-apis/phone-send.md)
>
> `POST /v3/phone/send/`: أرسل رمز تحقق لمرة واحدة عبر SMS.

> [card] [التحقق من رمز الهاتف](https://docs.didit.me/ar/standalone-apis/phone-check.md)
>
> `POST /v3/phone/check/`: تحقق من الرمز واسترجع بيانات مخاطر الهاتف.

> [card] [تقييم مخاطر الهاتف](https://docs.didit.me/ar/standalone-apis/phone-risk.md)
>
> `POST /v3/phone/risk/`: قيّم مخاطر مشغّل الاتصالات ونوع الخط ونقل الرقم والاحتيال دون إرسال OTP.

## كيف يعمل

1. استدعِ **إرسال رمز الهاتف** مع رقم الهاتف بصيغة E.164 (مثال: `+14155552671`)
2. يتلقى المستخدم الرمز عبر SMS (صالح لمدة 5 دقائق)
3. استدعِ **التحقق من رمز الهاتف** مع رقم الهاتف والرمز
4. احصل على نتيجة التحقق مع إشارات المخاطر (نوع مشغّل الاتصالات، واكتشاف الرقم الافتراضي)

## قنوات الإرسال

يدعم Didit قنوات متعددة حسب توفرها في الدولة:

| القناة | الوصف |
| - | - |
| SMS | رسالة نصية قياسية |
| WhatsApp | مراسلة عبر WhatsApp |
| Telegram | مراسلة عبر Telegram |
| RCS | خدمات الاتصالات الغنية (RCS) |
| Viber | مراسلة عبر Viber |

## إشارات المخاطر

| الإشارة | الوصف |
| - | - |
| `is_disposable` | رقم هاتف مؤقت أو للاستخدام لمرة واحدة |
| `is_virtual` | رقم VoIP أو رقم افتراضي |
| `carrier.type` | `mobile` أو `landline` أو `voip` |

للاطلاع على بنية الاستجابة الكاملة، راجع [تقرير التحقق من رقم الهاتف](https://docs.didit.me/ar/core-technology/phone-verification/overview.md).

## انقطاعات المزوّد

إذا فشل مزوّد الهاتف الخارجي في الرد على طلب إرسال أو تحقق، تُرجع نقطتا الـendpoint استجابةً برمز `502` مع `code: "phone_provider_unavailable"` بدلاً من خطأ عام. يمكن إعادة المحاولة بأمان، ولا يُحتسب عليها أي رسوم، ولا تستهلك محاولة من الحد الساعي لكل رقم. استخدم الحقل `code` في التفرع المنطقي بدلاً من تحليل نص الرسالة `detail`، فنص الرسالة ليس عقداً ثابتاً.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.