الاستعلام عن معلومات التوجيه
اطلب معلومات التوجيه لرقم هاتف في أمريكا الشمالية. استخدمها لتفسير بيانات التوجيه وشركة الاتصالات المتاحة، ولا تستخدمها دليلا على هوية المشترك أو ملكية الرقم أو إمكانية الوصول إليه أو توفره للشراء. قد يؤدي الاستعلام إلى خصم رسوم من حسابك.
الطلب
استخدم حساب API المفعّل لديك وعنوان IP المصدر المسموح به لهذا الحساب. أدخل الرقم كاملا بالأرقام، بما في ذلك رمز البلد 1. يستخدم المثال متغيرات البيئة ورقما وهميا. لا يوحّد المعالج تنسيق علامات الترقيم؛ لذا تحقّق من صحة المدخلات قبل إرسالها.
curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
https://api.multitel.net/v3/lrn/12025550123الاستجابة
هذه حقول مختارة للتوضيح فقط؛ ويتوقف توفرها على المصدر ونوع الرقم.
{
"status": {
"code": 200,
"msg": "Success"
},
"response": {
"lrn": "12025550123",
"ocn": "0000",
"local": 1,
"ported": 0,
"cost": "$0.00025"
}
}يحوّل الاستعلام القياسي أسماء الحقول المُعادة إلى أحرف صغيرة. قد تتضمن الاستجابة حقولا لشركة الاتصالات ومركز التسعير والموقع ونطاق الاختصاص، بحسب المصدر. لا تمثل الاستجابة سجلا كاملا للمشترك ذا بنية ثابتة. قد تكون قيمة المؤشر local العدد 1 أو السلسلة النصية 0. يحسب المعالج قيمة ported بمقارنة رقم التوجيه المُعاد برقم الهاتف المقدّم؛ فلا تفسّرها على أنها سجل كامل وموثّق لعمليات نقل الرقم بين شركات الاتصالات.
التسعير وإعادة المحاولة
يخصم المعالج الذي تمت مراجعته مبلغ $0.00025 من الحساب عندما يصل إلى مسار الإكمال ويسجّل الاستعلام. عادة ما تكون التكلفة المُعادة سلسلة نصية تتضمن علامة الدولار، وليست مجرد مبلغ عددي. لا يتوفر مفتاح لمنع تكرار أثر الطلب. قد يؤدي تكرار الطلب إلى فرض رسوم أخرى.
بالنسبة إلى الحسابات مسبقة الدفع، تتحقق الشيفرة من وجود رصيد لا يقل عن 0.00025. تذكر رسالة عدم كفاية الرصيد حاليا مبلغ $5، وهو لا يطابق ذلك الحد. فسّر الإخفاق على أنه رفض بسبب الرصيد، وتحقّق من الأموال المتاحة في الحساب قبل إعادة المحاولة.
حالات الإخفاق والنجاح غير المكتمل
اقرأ كلا من حالة HTTP وحقول status.code/status.msg في بيانات JSON. إذا كانت نتيجة الاستعلام القياسي فارغة، يُعاد الرمز 404 من API. وقد يشير الرمز 403 من API إلى عدم كفاية الرصيد المدفوع مسبقا.
قد يظل أحد مسارات الخطأ الحالية الخاصة بالأرقام المجانية يخصم مبلغ الاستعلام ويُعيد الرمز 200 من API دون حقول توجيه مفيدة؛ وقد تكون بيانات التكلفة فيه غير مكتملة. لذلك لا يكفي الرمز 200 وحده لإثبات أن نتيجة الاستعلام قابلة للاستخدام. تحقّق من صحة الحقول التي يحتاج إليها تطبيقك، وطابق الرسوم غير المؤكدة مع سجلات فوترة الحساب، وتواصل مع الدعم عند الحصول على نتائج غير مكتملة.
تختلف معالجة الأرقام المجانية باختلاف طول المدخلات في التنفيذ الذي تمت مراجعته. يُفضّل إدخال الرقم الدولي كاملا بالأرقام، والتأكد مع الدعم من نطاق التغطية المطلوب للأرقام المجانية. لا تُعد المحاولة تلقائيا عند الحصول على نتيجة ذات تنسيق غير صحيح أو غير مكتملة، ولا تعتمد على استعلام التوجيه لتقرر أن الاتصال برقم ما آمن أو مسموح لك به.