حول MultiTEL API:
تتوفر واجهة API هذه للمطورين الذين يرغبون في التكامل مع منصة الصوت لدينا أو البناء عليها.
توفر واجهات API لدينا الوصول إلى الموارد (كيانات البيانات) عبر مسارات URI. لاستخدام REST API، سيقوم تطبيقك
بإرسال طلب HTTP وتحليل الاستجابة. افتراضياً، تكون صيغة الاستجابة JSON.
ستكون الطرق الخاصة بك هي طرق HTTP القياسية GET وPOST. ونظرًا إلى أن API يستند إلى معايير مفتوحة،
يمكنك استخدام أي لغة تطوير ويب للوصول إلى API.
نقطة النهاية المستخدمة:
https://api.multitel.net/v3
المصادقة:
يستخدم MultiTEL APIv3 مصادقة HTTP Basic/Digest. يتيح لك ذلك حماية عناوين URL على خادم الويب الخاص بك بحيث لا يتمكن من الوصول إليها سواك وMultiTEL
. لإجراء المصادقة عبر HTTP، يمكنك تقديم اسم مستخدم وكلمة مرور بتنسيق عنوان URL التالي:
https://USERNAME:PASSWORD@api.multitel.net/v3/getcountries
بالنسبة لمصادقة HTTP Basic، ستستخدم اسم مستخدم حسابك في MultiTEL وكلمة المرور الخاصة بك.
بدلًا من ذلك، يمكنك تعريف مستخدمي API مخصصين هنا: https://multitel.net/settings.
curl -G https://api.multitel.net/v3/getcountries \
-u '[YOUR USERNAME]:[YOUR PASSWORD]'
المخرجات:
ستعيد جميع دوال API القسمين status وresponse. ستكون الحالة (status) رمزًا رقميًا مبنيًا على رموز حالة HTTP.
يُعتبر كل ما يحمل رمز الحالة 200 نجاحًا.
يُعتبر كل ما يحمل رمز حالة ضمن النطاق 4xx خطأً من جانب العميل (رموز المنع، ورموز عدم كفاية الرصيد، وغيرها).
يُعتبر كل ما يحمل رمز حالة ضمن النطاق 5xx خطأً من جانب الخادم.
مثال على المخرجات، أدناه:
{
"status": {
"code": 200,
"msg": ""
},
"response": {
"number": "33554530000",
"price": {
"per_minute": "0.006",
"free_minutes": "0",
"setup_price": "0",
"monthly_price": "0.7",
"channels": "0",
"overflow": "1"
}
}
}استجابة توضيحية من مرجع RentNumber؛ المبالغ الواردة في المثال ليست عرض سعر حاليًا.