التحقق من تغطية جدول التخصيص
تحقق مما إذا كان رقم من أمريكا الشمالية يطابق بادئة في جدول التخصيص لدى MultiTEL، واسترجع المدينة والولاية والبلد المرتبطة بها. هذه عملية بحث في جدول البادئات. وهي لا تثبت أن اشتراك المشترك نشط، أو أن الرقم مخصص، أو أنه تابع لحسابك، أو أنه يمكنك طلبه.
الطلب
استخدم حسابك المفعل لواجهة برمجة التطبيقات وعنوان IP المصدر المسموح به. يستخدم المثال بيانات اعتماد HTTP Basic من متغيرات البيئة ورقما وهميا. لا يلزم إرسال جسم للطلب.
curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
https://api.multitel.net/v3/nanpacheck/12025550123يفضل استخدام رقم من أمريكا الشمالية يتكون من أحد عشر رقما ويبدأ بالرقم 1. يزيل معالج الطلبات المحارف غير الرقمية ويضيف 1 في بداية المدخل المكون من عشرة أرقام. وترفض المدخلات التي تحتوي على أي عدد آخر من الأرقام. لا يتحقق توحيد الصيغة هذا من جميع قواعد ترقيم أمريكا الشمالية، لذا فإن نجاح المطابقة في الجدول لا يمثل تحققا شاملا من صحة الرقم.
الاستجابة
قيم الحقول للتوضيح فقط؛ وهذه ليست نتيجة فعلية من جدول التخصيص.
{
"status": {
"code": 200,
"msg": "12025550123"
},
"response": {
"number": "12025550123",
"npanxx": "1202555",
"city": "Example City",
"state": "DC",
"country": "US"
}
}| الحقل | المعنى |
|---|---|
| number | المدخل بعد توحيد صيغته، ويحتوي على أرقام فقط. |
| npanxx | البادئة المخزنة المطابقة. يعطي معالج الطلبات الأولوية لبادئة من سبعة أرقام تضم رموز البلد والمنطقة والمقسم، ويمكنه اللجوء إلى بادئة من أربعة أرقام تضم رمزي البلد والمنطقة؛ لا تفترض أن هذا الحقل يحدد دائما رمز المقسم كاملا. |
| city, state, country | البيانات الوصفية لبادئة التخصيص المطابقة. لا تحدد هذه الحقول الموقع الجغرافي الحالي للمشترك أو مشغل الخدمة الحالي بعد نقل الرقم إلى مشغل آخر. |
الأخطاء
اقرأ في JSON قيمة status.code بدلا من الاعتماد على حالة HTTP 200 وحدها. يعني رمز واجهة برمجة التطبيقات 404 المصحوب بالرسالة Not part of NANPA عدم العثور على بادئة مطابقة في الجدول الذي تستخدمه الخدمة؛ وهو ليس حكما نهائيا صادرا عن جهة مختصة بالترقيم على مستوى العالم. يستخدم رمز واجهة برمجة التطبيقات 500 عندما يكون عدد الأرقام غير صالح أو يكون الرقم مفقودا.
التكلفة والخطوات التالية
يجري معالج الطلبات الذي تمت مراجعته استعلاما محليا في جدول التخصيص، ولا يتضمن أي خصم من الحساب أو بحث خارجي. لا يفرض هذا المعالج أي رسوم بحث. استخدم البحث عن الأرقام المتاحة للعثور على الأرقام المتاحة للطلب. ويعد البحث عن اسم أو البحث عن معلومات التوجيه أو طلب رقم عملية مختلفة لها تسعيرها الخاص على الحساب.