تقديم طلب إدراج رقم هاتف في الدليل

تقديم طلب إدراج في دليل شركة الاتصالات

قدّم الاسم والعنوان المطلوب استخدامهما لإدراج رقم هاتف مؤهل تملكه في MultiTEL ضمن الدليل. هذا تحديث مدفوع لدى شركة الاتصالات، وليس بحثا عن اسم المتصل أو إدخالا في دفتر عناوين خاص أو تحديثا عاما لحقل LIDB في مخزون البوابة.

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

متطلبات الحساب والرقم

استخدم حساب API مفعّلا عبر HTTPS من عنوان IP مصدر مسموح به. يجب أن يطابق الرقم بدقة سجلا غير ملغى لرقم مشترى تابع لذلك الحساب. استخدم جميع خانات الرقم بتنسيقه الدولي كما هي في مخزونك، مثل التنسيق الذي يبدأ برمز البلد 1 لرقم مدعوم من أمريكا الشمالية. لا تستخدم معرّف خطة أسعار أو معرّف UUID لرقم أو رقما تابعا لحساب آخر.

طلب POST ببيانات نموذج

اضبط NUMBER على الرقم الذي تملكه. استبدل المثال الوهمي بمعلومات الإدراج المصرح بها. يقرأ هذا المسار حقول النموذج من طلب POST؛ ولا يحلل متن طلب بتنسيق application/json.

curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
  --data-urlencode "lastname=EXAMPLE" \
  --data-urlencode "firstname=EXAMPLE" \
  --data-urlencode "streetnum=1" \
  --data-urlencode "streetname=Example" \
  --data-urlencode "streetpredir=N" \
  --data-urlencode "streetpostdir=W" \
  --data-urlencode "city=Example City" \
  --data-urlencode "state=NY" \
  --data-urlencode "postalcode=10001" \
  "https://api.multitel.net/v3/directory/$NUMBER"

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

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

آلية احتساب الرسوم وإعادة المحاولة

يتحقق المعالج الذي تمت مراجعته من توفر رصيد لا يقل عن 10.00 وحدات رصيد قبل الاتصال بشركة الاتصالات. وبعد أن تبلغ شركة الاتصالات عن النجاح وتبلغ عملية تحديث الرقم محليا عن النجاح، يخصم 10.00 من رصيد الحساب ويسجل معاملة إعداد الإدراج في الدليل. هذه هي المبالغ المطبقة حاليا في التنفيذ، وليست مقترح تسعير جديدا؛ راجع شروط حسابك للتأكد من عملة الفوترة المعمول بها والخدمة المدعومة قبل تقديم الطلب.

لا تتضمن العملية مفتاحا لضمان عدم تكرار الأثر، ولا آلية لمنع الطلبات المكررة، ولا معاملة موحدة تشمل الإرسال إلى شركة الاتصالات والتحديث المحلي والفوترة. قد يؤدي نجاح طلب مكرر إلى إرسال جديد إلى شركة الاتصالات وفرض رسوم أخرى. لا يثبت انتهاء مهلة الانتظار أو حدوث خطأ في API أن شركة الاتصالات رفضت الطلب السابق: فقد يكون المزوّد قد قبله قبل فشل التحديث المحلي.

الاستجابة

{
  "status": {
    "code": 200,
    "msg": "Success"
  },
  "response": ""
}

في استجابة النجاح المعتادة، تكون سلسلة نصية فارغة هي قيمة الحقل response ولا يُرجع أي معرّف للإدراج أو تفاصيل عن اكتماله. وهذا يعني أن مسار شركة الاتصالات ومسار التحديث المحلي أبلغا عن النجاح؛ ولا يثبت النشر في جميع الأدلة الخارجية أو الانتشار الفوري أو عرض هوية المتصل مستقبلا.

أخطاء النظام القديم

اقرأ حالة HTTP وكذلك حقلي JSON status.code/status.msg. قد تحول المصادقة والقيود المفروضة على عنوان IP المصدر أيضا دون الحصول على استجابة قابلة للاستخدام. لا تستخدم GET أو معاملات الاستعلام لطلب تحديث لمجرد أن المعالج القديم لا يتضمن فحصا صريحا لطريقة HTTP.

التحقق قبل إعادة المحاولة

1. تأكد من الرقم الذي تملكه، وأهليته لدى شركة الاتصالات، وبيانات الإدراج المصرح بها، والرسوم قبل إرسال الطلب.
2. قدّم الطلب مرة واحدة واحتفظ بالنتيجة من جانب الحساب دون كشف عنوان العميل في السجلات العامة أو أدوات التحليلات.
3. راجع الإدراج المحفوظ وسجل المعاملات عبر إجراءات إدارة الحساب المدعومة أو من خلال الدعم. انتظر مدة المعالجة التي أكّدتها شركة الاتصالات؛ فلا تحدد API هذه أي مهلة مضمونة لانتشار البيانات.
4. عندما تكون النتيجة غير مؤكدة، اطلب من الدعم مطابقة طلب شركة الاتصالات مع الفوترة المحلية وتسوية أي اختلاف قبل إعادة المحاولة. فتكرار الطلب ليس استعلاما عن الحالة يضمن عدم تكرار الأثر.