التكامل مع واجهة برمجة تطبيقات تزويد Azure Communications Gateway (معاينة)
توضح هذه المقالة متى تحتاج إلى التكامل مع واجهة برمجة تطبيقات تزويد Azure Communications Gateway (معاينة) وتوفر نظرة عامة عالية المستوى للبدء. إنه لمطوري البرامج الذين يعملون لمشغلي الاتصالات السلكية واللاسلكية.
تسمح لك واجهة برمجة تطبيقات التزويد بتكوين Azure Communications Gateway بتفاصيل عملائك والأرقام التي قمت بتعيينها لهم. إذا كنت تستخدم واجهة برمجة تطبيقات التزويد لمزامنة الخدمة الخلفية، يمكنك أيضا تزويد بيئات توصيل المشغل وTeams الهاتف Mobile بتفاصيل عملاء المؤسسة والأرقام التي تخصصها لهم. يسمح لك هذا التزويد بالتدفق بتلبية متطلبات توصيل المشغل وTeams الهاتف Mobile لاستخدام واجهات برمجة التطبيقات لإدارة عملائك وأرقامك بعد تشغيل الخدمة.
واجهة برمجة تطبيقات التزويد هي واجهة برمجة تطبيقات REST.
يعتمد ما إذا كنت تتكامل مع واجهة برمجة تطبيقات التزويد على خدمة الاتصالات التي اخترتها.
| خدمة الاتصالات | تكوين إعدادات تشغيل الخدمة لواجهة برمجة التطبيقات | الغرض |
|---|---|---|
| التوجيه المباشر ل Microsoft Teams | مدعوم (كبديل لمدخل إدارة الأرقام) | - تكوين المجال الفرعي المرتبط بكل عميل توجيه مباشر. - إنشاء سجلات DNS خاصة بكل عميل (كما هو مطلوب من قبل بيئة Microsoft 365). - الإشارة إلى تمكين الأرقام للتوجيه المباشر. - (اختياري) تكوين رأس مخصص للرسائل إلى شبكتك. |
| توصيل المشغل | مستحسن | - (مستحسن) توفير التدفق للعملاء توصيل المشغل من خلال التشغيل المتداخل مع واجهات برمجة التطبيقات توصيل المشغل (باستخدام مزامنة خدمة الواجهة الخلفية). - (اختياري) تكوين رأس مخصص للرسائل إلى شبكتك. |
| Teams الهاتف Mobile | مستحسن | - (مستحسن) تزويد Teams الهاتف عملاء الأجهزة المحمولة من خلال التشغيل المتداخل مع واجهات برمجة التطبيقات توصيل المشغل (باستخدام مزامنة خدمة الواجهة الخلفية). |
| تكبير/تصغير الهاتف النظير السحابي | مدعوم (كبديل لمدخل إدارة الأرقام) | - الإشارة إلى تمكين الأرقام للتكبير/التصغير. - (اختياري) تكوين رأس مخصص للرسائل إلى شبكتك. |
| معاينة حماية استدعاء عامل تشغيل Azure | مدعوم (كبديل لمدخل إدارة الأرقام) | - يشير إلى تمكين الأرقام ل Azure Operator Call Protection. - التوفير التلقائي ل Azure Operator Call Protection. |
تلميح
يوفر مدخل إدارة الأرقام في Azure Communications Gateway وظيفة مكافئة للتزويد اليدوي. ومع ذلك، لا يمكنك استخدام مدخل إدارة الأرقام لتوفير التدفق الشامل توصيل المشغل وTeams الهاتف Mobile بعد تشغيل الخدمة.
المتطلبات الأساسية
يجب أن تكون قد أكملت نشر Azure Communications Gateway.
يجب أن يكون لديك حق الوصول إلى جهاز بعنوان IP يسمح له بالوصول إلى واجهة برمجة تطبيقات التزويد (معاينة). تم تكوين قائمة السماح هذه لعناوين IP (أو النطاقات) كجزء من نشر Azure Communications Gateway.
التعرف على واجهة برمجة تطبيقات التزويد (معاينة) وتخطيط تغييرات عميل BSS
للتكامل مع واجهة برمجة التطبيقات، تحتاج إلى إنشاء (أو تحديث) عميل BSS يمكنه الاتصال بواجهة برمجة تطبيقات التزويد. تدعم واجهة برمجة تطبيقات التزويد تدفق مصادقة بيانات اعتماد عميل OAuth 2.0 من جهاز إلى جهاز. يصادق عميلك على استدعاءات واجهة برمجة التطبيقات المعتمدة ويطلقها بنفسه، دون تفاعل المستخدمين.
استخدم معلومات المفاهيم والأمثلة الرئيسية في مرجع واجهة برمجة التطبيقات للتعرف على الموارد المتوفرة عبر واجهة برمجة التطبيقات والطلبات التي تحتاج مؤسستك إلى تقديمها.
- موارد الحساب هي أوصاف لعملاء المشغل (عادة، المؤسسة)، وإعدادات لكل عميل لتوفير الخدمة.
- تنتمي موارد الأرقام إلى حساب. وهي تصف الأرقام والخدمات التي تستخدمها الأرقام (على سبيل المثال، التوجيه المباشر ل Microsoft Teams)، وأي تكوين إضافي لكل رقم.
- موارد طلب المعلومات (RFI) هي أوصاف لعملاء المشغل (عادة ما تكون مؤسسة) الذين أعربوا عن اهتمامهم بتلقي الخدمة من المشغل من خلال توصيل المشغل وTeams الهاتف Mobile.
لدى واجهة برمجة تطبيقات التزويد حد معدل 100 طلب في الدقيقة، يتم تطبيقها عبر جميع الموارد. يتم احتساب طلب الدفعة لتحديث موارد متعددة كطلب واحد.
تكوين عميل BSS للاتصال ب Azure Communications Gateway
تتوفر واجهة برمجة تطبيقات التزويد (معاينة) على المنفذ 443 من provapi.<base-domain>، حيث <base-domain> هو المجال الأساسي لمورد Azure Communications Gateway.
تلميح
للعثور على المجال الأساسي:
- قم بتسجيل الدخول إلى بوابة Azure.
- انتقل إلى نظرة عامة على مورد Azure Communications Gateway وحدد Properties.
- ابحث عن الحقل المسمى Domain.
يحتوي سجل DNS على مدة البقاء (TTL) تبلغ 60 ثانية. عند فشل منطقة ما، يقوم Azure بتحديث سجل DNS للإشارة إلى منطقة أخرى، بحيث يتلقى العملاء الذين يقومون بالبحث عن DNS جديد تفاصيل المنطقة الجديدة. نوصي بالتأكد من أن العملاء يمكنهم إجراء بحث DNS جديد وإعادة محاولة طلب بعد 60 ثانية من انتهاء المهلة أو استجابة 5xx.
استخدم قسم البدء في مرجع واجهة برمجة التطبيقات لتكوين Azure وعميل BSS الخاص بك للسماح لعميل BSS بالوصول إلى واجهة برمجة تطبيقات التزويد.
تلخص الخطوات التالية تكوين Azure الذي تحتاجه. راجع قسم البدء في مرجع واجهة برمجة التطبيقات للحصول على التفاصيل الكاملة، بما في ذلك قيم التكوين المطلوبة.
- تسجيل عميل BSS الخاص بك في نفس مستأجر Azure مثل نشر Azure Communications Gateway. تنشئ هذه العملية تسجيل تطبيق.
- عين نفسك كمالك لتسجيل التطبيق.
- تكوين تسجيل التطبيق مع النطاقات المحددة في مرجع واجهة برمجة التطبيقات. يشير هذا التكوين إلى Azure أن التطبيق الخاص بك مسموح له بالوصول إلى واجهة برمجة تطبيقات التزويد.
- كمسؤول للمستأجر، اسمح للتطبيق باستخدام أدوار التطبيق التي قمت بتعيينها.