الوصول إلى الحساب والمشروع
استخدم حساب API مفعّلاً عبر HTTPS من عنوان IP مسموح به. يجب أن يكون المشروع تابعاً لذلك الحساب وألا يكون محذوفاً. استخدم المعرّف الفريد للمشروع من سير عمل طلب نقل الأرقام، وليس معرّفه الرقمي في قاعدة البيانات أو رقم هاتف. طبّق ترميز URL على معرّف المشروع عند إنشاء الطلب.
الطلب
curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
"https://api.multitel.net/v3/lnp/project/$PROJECT_ID/numbers"الاستجابة
مثال افتراضي للاستجابة.
{
"status": {
"code": 200,
"msg": "Project Numbers",
"results": 1
},
"response": [
{
"id": 21,
"number": "12025550123",
"status": 0,
"status_str": "Pending",
"isocode": "US",
"updated": "2026-10-23 12:00:00",
"foc": "",
"comment": "Example customer-visible note",
"date_created": "2026-10-23 12:00:00",
"date_completed": ""
}
]
}response عبارة عن قائمة. يعيد المشروع الموجود الذي لا يحتوي على أرقام قائمة فارغة مع رمز API بقيمة 200 وقيمة status.results تساوي 0. أما المشاريع غير الموجودة فتعيد رمز API بقيمة 404.
حقول الأرقام
| الحقل | المعنى |
|---|---|
| id, number, isocode | المعرّف الرقمي للصف، والنص المخزّن لرقم الهاتف، ورمز البلد. معرّف الصف ليس معرّف المشروع. |
| status, status_str | الحالة الرقمية وتسميتها المعروفة. |
| foc | قيمة الجدولة المخزّنة للالتزام المؤكد بالطلب. قد تكون فارغة؛ ولا يحوّلها المعالج إلى منطقة زمنية أو تنسيق طابع زمني موثّق. |
| updated, date_created, date_completed | قيم التحديث والإنشاء والإكمال المخزّنة. تعامل مع القيم الفارغة صراحةً؛ ولا تفترض استخدام ISO8601 أو تستنتج منطقة زمنية من المثال الافتراضي. |
| comment | تعليق مخزّن موجّه للعميل. اعرضه كنص، وليس كشيفرة HTML قابلة للتنفيذ. |
يستبعد هذا التمثيل الحقل internal_comment المخصص للموظفين فقط. ولا يعني ذلك أن عملية البحث القديمة المنفصلة عن رقم واحد تستخدم التمثيل نفسه.
ترتيب النتائج والمتابعة
يرتّب الاستعلام النتائج تصاعدياً حسب وقت الإنشاء. ولا يُضمن أي ترتيب إضافي للصفوف التي تتساوى أوقات إنشائها. لا يوجد تقسيم إلى صفحات أو مؤشر تزايدي أو عامل تصفية حسب التاريخ. اقرأ القائمة كاملةً لمطابقة بيانات المشروع، ولا تعتبر عدد صفوفه الحالي دليلاً دائماً للأرقام.
تفسير حالة نقل الأرقام
| القيمة | التسمية |
|---|---|
| 0 | Pending |
| 1 | In Progress |
| 2 | Completed |
| 9 | Rejected |
احتفظ بالحالة الرقمية وتعامل مع القيم غير المعروفة. عند عدم معرفة التسمية، تُستخدم القيمة المخزّنة بدلاً من ضمان تسمية جديدة. لا تشكّل حالة إكمال مخزّنة أو تاريخ مجدول، بمفردهما، اختباراً لتوجيه المكالمات الواردة أو لكل خدمة على الرقم.
الأخطاء والقيود
تحقّق من استجابة HTTP ومن status.code/status.msg. يعيد المشروع غير الموجود أو المحذوف أو غير التابع للحساب رمز API بقيمة 404 مع رسالة تفيد بأن المشروع غير موجود. تسري أيضاً قيود المصادقة وعنوان IP المصدر. لا تنفّذ الأمثلة أي طلب فعلي، كما أن نجاح الاستجابة لا يثبت أن شركة الاتصالات قد قبلت عملية النقل أو أكملتها.
الآثار
لا يفعل المعالج الذي تمت مراجعته سوى قراءة المشروع وصفوف أرقامه المخزّنة. الاستجابة لقطة للبيانات، وليست تأكيداً من شركة الاتصالات أو اختباراً فعلياً للخدمة. وهي لا تبدأ عملية نقل للأرقام ولا تغيّر التوجيه ولا تخصم من رصيد الحساب.