أرسل أول طلب API إلى MultiTEL

اختر واجهة API وبيانات الاعتماد معًا

يمكن للحسابات المعتمدة ضمن فئات «المطوّرون والأتمتة» و«الأعمال» و«مقدّمو خدمات الاتصالات» دمج الخدمات المفعّلة. لا يحتاج المطوّر الفرد إلى التظاهر بأنه شركة. تتطلب رسائل SMS/MMS الخاصة بالتطبيقات موافقة الإرسال والتسجيل المعمول بهما. أما خدمات «الأفراد والعائلات» فلا تتضمن واجهة API متاحة للعملاء لإنشاء الرسائل.

عيّن MULTITEL_API_USERNAME وMULTITEL_API_PASSWORD عبر إعدادات الأسرار في خادمك قبل استخدام الأمثلة. لا تضمّنهما أبدًا في JavaScript العام للمتصفح أو في عناوين URL أو في نظام التحكم بالمصدر. تُدار بيانات الاعتماد المخصصة في إعدادات تكامل API.

الطلب الأول: قراءة رصيدك

هذه القراءة لا تشتري خدمة ولا تُجري مكالمة ولا ترسل رسالة.

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

تعيد واجهة API الخاصة بالاتصالات v3 نتيجة التطبيق داخل نص JSON. تحقق من حالة HTTP ومن status.code قبل قراءة response؛ فقد لا يحتوي الطلب المرفوض على كائن استجابة. يمكن أن تكون قيم الرمز نصوصًا أو أرقامًا.

{
  "status": {
    "code": 200,
    "msg": ""
  },
  "response": {
    "balance": "25.0000",
    "currency": "USD",
    "terms": "Prepaid"
  }
}

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

استخدم بيانات الفوترة بشكل صحيح

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

اختر تكاملك التالي

تابع مع المرجع الخاص بحسابك

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