API التحقق من رقم الهاتف وتنسيقه

بيانات الهاتف العالمية

رقم واحد، ومخرجات متسقة

اقبل أرقاماً محلية أو دولية أو منسقة بشكل غير منتظم، ثم احصل على صيغ موحدة وبيانات تحقق لـ242 دولة ومنطقة.

الإدخال الخام+1 212 867 5309

صيغة E.164+12128675309

التحققisValid وisPossible

التنسيقمحلي ودولي وE.164

التصنيفمحمول وثابت وVoIP والمزيد

الموقعالمنطقة ورمزها والمكان

معاملات الإدخال

سياق الرقم والعنوان

المعامل	الحالة	الوصف
`number`	مطلوب	رقم هاتف بصيغة محلية أو دولية أو E.164.
`address`	مشروط	رمز دولة ISO أو اسم دولة أو مدينة أو منطقة لتفسير رقم محلي.

متى يصبح العنوان مطلوباً؟

إذا لم يبدأ number بعلامة + ورمز اتصال دولي، فأرسل سياقاً مثلUS أو United States أو New York.

USGermanyİstanbulNew YorkÉtats-Unis

GET

المصادقة عبر query string

طلب GET أساسي

cURL

curl "https://api.genderapi.io/api/phone?key=YOUR_API_KEY&number=%2B12128675309&address=US"

ترميز URL: حوّل + إلى %2B والمسافات إلى %20. استخدم أدوات URL أو URLSearchParams في لغتك بدلاً من إنشاء النص يدوياً.

POST

مصادقة Bearer

طلب POST من جهة الخادم

أرسل الرقم والعنوان الاختياري بصيغة JSON، وضع مفتاح API في ترويسة Authorization.

cURL

curl -X POST "https://api.genderapi.io/api/phone" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{"number":"+12128675309","address":"US"}'

JavaScript

const response = await fetch("https://api.genderapi.io/api/phone", {
  method: "POST", headers: { "Content-Type": "application/json", "Authorization": "Bearer YOUR_API_KEY" },
  body: JSON.stringify({ number: "+12128675309", address: "United States" })
});

استجابة API

التحقق والتنسيق والبيانات الوصفية

JSON

{
  "status": true, "remaining_credits": 15709, "expires": 0, "duration": "18ms",
  "regionCode": "US", "countryCode": 1, "country": "United States",
  "national": "(212) 867-5309", "international": "+1 212-867-5309", "e164": "+12128675309",
  "isValid": true, "isPossible": true, "numberType": "FIXED_LINE_OR_MOBILE",
  "nationalSignificantNumber": "2128675309", "rawInput": "+1 212 867 5309",
  "isGeographical": true, "areaCode": "212", "location": "New York City (Manhattan)"
}

حقول الاستجابة

الحقل	النوع	الوصف
`status`	boolean	يوضح ما إذا اكتمل الطلب بنجاح.
`remaining_credits`	integer	عدد الأرصدة المتبقية بعد الطلب.
`expires`	integer	وقت انتهاء صلاحية الرصيد بصيغة UNIX timestamp.
`duration`	string	مدة المعالجة على الخادم.
`regionCode`	string	رمز المنطقة المكتشف وفق ISO 3166-1 alpha-2.
`countryCode`	integer	رمز الاتصال الدولي.
`country`	string	اسم الدولة المقروء.
`national`	string	الرقم منسقاً للاستخدام المحلي.
`international`	string	الرقم منسقاً للعرض الدولي.
`e164`	string	الصيغة القياسية E.164.
`isValid`	boolean	هل يطابق الرقم قواعد التحقق الإقليمية.
`isPossible`	boolean	هل يمكن أن يوجد الرقم بناءً على بنيته.
`numberType`	string	فئة الرقم المكتشفة.
`nationalSignificantNumber`	string	الرقم المحلي من دون رمز اتصال الدولة.
`rawInput`	string	الرقم الأصلي المرسل في الطلب.
`isGeographical`	boolean	هل يمكن ربط الرقم بمنطقة جغرافية.
`areaCode`	string	جزء رمز المنطقة المكتشف.
`location`	string	الموقع المرتبط برمز المنطقة.

مرجع التصنيف

قيم نوع الرقم

FIXED_LINE

هاتف ثابت مرتبط بموقع جغرافي.

MOBILE

رقم هاتف محمول أو خلوي.

FIXED_LINE_OR_MOBILE

خطة الترقيم لا تميز بين الهاتف الثابت والمحمول.

TOLL_FREE

رقم مجاني يتحمل المستقبِل تكلفته.

PREMIUM_RATE

رقم خدمة بتعرفة مرتفعة.

SHARED_COST

تكلفة المكالمة مشتركة بين المتصل والمستقبِل.

VOIP

رقم هاتف يعمل عبر بروتوكول الإنترنت.

PERSONAL_NUMBER

رقم شخصي يمكنه إعادة التوجيه إلى خط آخر.

PAGER

رقم إشعارات جهاز النداء.

UAN

رقم وصول موحّد يُستخدم كجهة اتصال مشتركة للأعمال.

VOICEMAIL

رقم مخصص للوصول إلى البريد الصوتي.

UNKNOWN

تعذر تحديد فئة الرقم.

أسئلة شائعة

الأسئلة الشائعة عن Phone API

ماذا تفعل API التحقق من الهاتف؟

تتحقق من أرقام الهاتف وتوحّدها، وتعيد الصيغ المحلية والدولية وE.164، كما تحدد المنطقة ونوع الرقم والبيانات الجغرافية عند توفرها.

ما الفرق بين isValid وisPossible؟

يتحقق isValid من الرقم وفق قواعد الترقيم الإقليمية، بينما يشير isPossible إلى أن بنيته قد تمثل رقماً حتى إذا تعذر تأكيد صلاحيته.

متى يكون address مطلوباً؟

أرسل address عندما لا يبدأ الرقم بعلامة زائد ورمز اتصال دولي. ويمكن أن يكون رمز دولة ISO أو اسم دولة أو مدينة أو منطقة.

كيف ينبغي إرسال الرموز الخاصة؟

استخدم URL encoding للمسافات وعلامات الزائد والرموز الخاصة الأخرى في معاملات GET. يتولى عميل HTTP ترميز أجسام JSON في طلبات POST.

المرجع التالي

راقب الاستخدام والحصة

الاستخدام والحصةافهم الأرصدة والحدود ←مكتبات العملاءثبّت حزمة للتحقق من الهاتف ←