ForHosting KIT · البيانات والملفات: تحويل وتنظيف

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

يسهل حفظ أرقام الهاتف كنص حر، لكن عرضها بصورة موحدة ليس بالأمر البسيط. تستقبل هذه الأداة رقم هاتف ورمز بلد من حرفين، وتحذف علامات الفصل المعتادة، وتتحقق من رمز الاتصال الدولي عند إدخاله، ثم تفحص العدد الدقيق لأرقام الرقم الوطني.

● Betaمجاني · داخل متصفحك
استخدمها من الويبAPIالبريدTelegramالتطبيق قريبًا

بعد ذلك تعيد صيغة دولية سهلة القراءة وصيغة E.164 مدمجة. ويؤدي الطول غير الصحيح أو رمز الاتصال غير المتوافق إلى خطأ واضح بدلاً من نتيجة تبدو معقولة لكنها غير موثوقة.

أدخلوا الرقم وحددوا البلد الذي ينتمي إليه

أدخلوا رقم الهاتف بالصيغة المتاحة لديكم، ثم اختاروا رمز البلد المكون من حرفين. يمكن أن يتضمن الإدخال الوطني فواصل شائعة مثل المسافات والأقواس والنقاط والشرطات. ويمكنكم أيضاً إدخال رقم دولي يبدأ بعلامة الجمع، أو استخدام بادئة الاتصال الدولي 00. عند وجود بادئة دولية، تتحقق الأداة من توافق رمز الاتصال مع البلد المحدد. ولهذا الفحص أهمية لأن تسلسل الأرقام الوطنية نفسه قد يبدو صحيحاً من حيث البنية في أكثر من بلد. لذلك يُعامل البلد بوصفه تعليمة صريحة، ولا يُخمن اعتماداً على الأرقام. وفي البلدان التي تستخدم صفراً بادئاً للاتصال المحلي، يمكن إبقاء ذلك الصفر في الإدخال الوطني؛ وتحذفه الأداة عندما تتطلب الصيغة الدولية حذفه. تشمل النتيجة رمز ISO الموحد للبلد، ورمز الاتصال، والرقم الوطني الأساسي، وقيمة E.164 المدمجة، وقيمة مفصولة بمسافات للعرض. وبذلك تصلح الاستجابة لواجهات المستخدم وللتخزين الموحد وللمقارنات اللاحقة على حد سواء.

تعرفوا إلى ما يضمنه التحقق

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

استخدموا الصيغتين الموحدتين في موضعهما الصحيح

حقل الرقم المنسق مخصص للعرض؛ فهو يبدأ برمز اتصال البلد مسبوقاً بعلامة الجمع، ويقسم الأرقام الوطنية إلى مجموعات مألوفة حسب البلد. أما حقل E.164 فيحذف تلك المسافات، ولذلك يناسب قواعد البيانات ومقارنات التطابق وحمولات API والروابط التي تتطلب قيمة دولية مدمجة. احفظوا رمز البلد مع الرقم الموحد عندما يحتاج تطبيقكم إلى الاحتفاظ بالسياق الذي صرح به المستخدم. وإذا كنتم تستقبلون أرقام الهاتف عبر نموذج، فتحققوا منها قبل الحفظ كي يتسنى تصحيح خطأ عدد الأرقام بينما لا يزال المصدر متاحاً. وفي عمليات الاستيراد، احتفظوا بالخلية الأصلية في عمود للتدقيق، وضعوا النتيجة الموحدة في حقل منفصل؛ فهذا يمنع عملية التنظيف من محو دليل الإدخال الأصلي. تعاملوا دائماً مع أرقام الهاتف كنصوص لا كقيم عددية، حتى لا تضيع الأصفار البادئة. وتذكروا أخيراً أن التنسيق لا يعني الإذن؛ لذلك طبقوا قواعدكم المعتادة المتعلقة بالموافقة والخصوصية والمراسلة قبل الاتصال بأي رقم تعيده الأداة أو إرسال رسالة إليه.

توحيد الأرقام التي يدخلها العملاء

ارفضوا عدد الأرقام غير الصحيح فوراً، واحفظوا تمثيلاً دولياً موحداً.

تنظيف ملف جهات اتصال مستورد

حولوا علامات الفصل والصيغ الوطنية المختلفة إلى حقول عرض وصيغة E.164 ثابتة.

إعداد الأرقام لخدمة API أخرى

أنشئوا قيمة دولية مدمجة مع الاحتفاظ بنسخة مقسمة وسهلة القراءة للمراجعة.

ما تكلفة طلب API؟

تكلفة كل طلب هي $0.002. ويمكن تشغيل إصدار المتصفح محلياً في هذه الصفحة.

هل تعني النتيجة الصحيحة أن الرقم نشط؟

لا. فهي تؤكد البنية وعدد الأرقام للبلد المدعوم، ولا تؤكد التخصيص أو إمكانية الوصول أو الملكية أو الموافقة.

هل يمكن إدخال مسافات أو علامات فصل؟

نعم. تُتجاهل المسافات والأقواس والنقاط والشرطات. ولا تُقبل علامة الجمع إلا في البداية.

هل يمكن إدخال رقم دولي؟

نعم. استخدموا علامة جمع في البداية أو البادئة 00. ويجب أن يطابق رمز الاتصال البلد المحدد.

لماذا حُذف الصفر الوطني البادئ؟

تستخدم بعض البلدان صفراً بادئاً للاتصال المحلي فقط. وتحذفه الصيغة الدولية، ولذلك تتبع القيمة الموحدة هذا العرف.

لماذا لا يظهر بلدي في القائمة؟

لا تتيح القدرة إلا البلدان التي تملك قاعدة صريحة ومختبرة. وهي تعيد خطأ للخطط غير المدعومة بدلاً من التخمين.

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

POSThttps://api.kit.forhosting.com/data/phone-number-format

صادِق على طلبك بترويسة Bearer، وأرسل طلب POST واحدًا لتدخل مهمتك قائمة التنفيذ فورًا؛ ثم تستلم النتيجة عبر webhook أو رابط موقّع.

curl -X POST https://api.kit.forhosting.com/data/phone-number-format \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"phone_number":"(202) 555-0147","country_code":"US"}'
{
  "phone_number": "(202) 555-0147",
  "country_code": "US"
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "data.phone_number_format",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

الواجهة غير متزامنة: تستلم task_id فور الإرسال، ويمكنك الاستعلام عن الحالة بمعدل طلب واحد في الثانية.

لكل طلب$0.002

السعر معلن كما تراه: لا tokens ولا نظام نقاط؛ وإن فشلت المهمة فلن تُحاسَب عليها.

max_mb25
HTTPالرمزالمعنى
401unauthorizedمفتاح الوصول مفقود أو غير صالح؛ تحقق من ترويسة Bearer في طلبك.
402insufficient_balanceرصيدك لا يكفي لتنفيذ هذه المهمة؛ أعد شحن الرصيد ثم أعد المحاولة.
404unknown_typeنوع المهمة المطلوب غير موجود في الكتالوج — راجع الاسم المرسل في الطلب.
429rate_limitedتجاوزت الحد المسموح من الطلبات؛ انتظر قليلًا ثم أعد المحاولة.

اطّلع على توثيق KIT الكامل ←