تكامل CNAM

مرجع CNAM REST API

اطلب اسم متصل عبر HTTPS وتعامل مع النتيجة والرسوم والأخطاء.

اختر سلوك البحث

المستوى	السعر العام لكل استعلام	ما يفعله
Starter	‏0.0026 US$	يستخدم معلومات أسماء المتصلين الخاصة والمخزنة مؤقتاً.
Standard	‏0.0037 US$	يجري بحثاً فورياً في الشبكة لكل استعلام.
Mixed	‏0.004 US$	يحاول البحث الفوري أولاً، ثم يعود إلى بيانات Starter عند عدم العثور على اسم.

تحدد الخدمة المختارة سلوك البحث؛ فـ Mixed ليس بحثاً يعتمد على الذاكرة المؤقتة أولاً. راجع السعر المخصص لحسابك قبل الاستخدام في الإنتاج. اسم المتصل ليس دليلاً على الهوية أو الملكية.

أرسل طلب بحث مع المصادقة

نقطة النهاية: GET https://api.multitel.net/v3/cnam/NUMBER. استخدم أرقام هواتف بالصيغة الدولية، بالخانات الرقمية فقط ومتضمنة رمز الدولة، بدون علامات ترقيم أو علامة زائد في البداية. نفّذ هذا من خادم تطبيقك باستخدام بيانات اعتماد API المعتمدة.

curl --fail-with-body \
  --user "$MULTITEL_API_USERNAME:$MULTITEL_API_PASSWORD" \
  --header "Accept: application/json" \
  "https://api.multitel.net/v3/cnam/12025550123"

وفّر متغيري البيئة عبر إعدادات الأسرار على جانب الخادم. لا تكون بيانات اعتماد bearer المُجهَّزة بديلاً إلا عند تفعيل ذلك الوصول واستيفاء قيود عنوان IP المصدر الخاصة به. لا تضع سر API في حزمة متصفح عامة أبداً.

دليل مصادقة API والطلب الأول

اقرأ استجابة JSON

هذه الاستجابة توضيحية. يعتمد الاسم المُعاد والرسوم على البحث والخدمة المختارة.

{
  "status": {
    "code": 200,
    "msg": ""
  },
  "response": {
    "number": "12025550123",
    "name": "EXAMPLE CALLER",
    "cost": "0.004",
    "balance": "24.9960"
  }
}

status.code: رمز نتيجة التطبيق؛ وحّد القيم النصية/الرقمية قبل مقارنتها بـ 200.
status.msg: رسالة النتيجة أو الرفض المصاحبة.
response.number: الرقم المُستعلَم عنه.
response.name: اسم المتصل المتاح.
response.cost: الرسم المُبلَّغ عنه لهذا الاستعلام؛ تعامل معه كمبلغ عشري.
response.balance: رصيد الحساب المُبلَّغ عنه، عند توفره.

النتائج بدون اسم والأخطاء

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

تحقق من حالة HTTP ومن status في JSON معاً قبل الوصول إلى response.name. قد يكون كائن الاستجابة غائباً عند حدوث خطأ. ولا ينبغي أن يمنع غياب الاسم توجيه المكالمة العادية.

الفوترة وإعادة المحاولة والفرق عن تحديث معرّف المتصل

قد يترتب على كل بحث جديد رسم استعلام. لا توثّق واجهات البحث هذه مفتاح عدم التكرار (idempotency key)، لذا قد تكون إعادة المحاولة الجديدة استعلامًا ثانيًا مُحتسَبًا. استخدم عددًا محدودًا من المحاولات مع زيادة مهلة الانتظار عند أعطال النقل أو الخدمة، وعالج أخطاء الحساب أولًا، وطابِق رسوم الاستعلام المُبلَّغ عنها. خزّن مؤقتًا لمدة مناسبة لتطبيقك فقط؛ فبيانات أسماء المتصلين قد تتغير.

بحث CNAM يقرأ اسماً. ولا يغيّر الاسم المعروض في مكالماتك الصادرة. أما تحديث اسم المتصل في LIDB فهو عملية منفصلة لها حقولها وتصريحها وسعرها ومعالجتها الخاصة.

دليل تكامل CNAM للحساب احصل على مساعدة في التكامل