Aracılığıyla paylaş

SDK'lar ve REST API'ler

  • Makale

Azure İletişim Hizmetleri özellikleri kavramsal olarak işlevsel alanlarına göre ayrık alanlar halinde düzenlenir. Çoğu alan, doğrudan İnternet üzerinden kullanabileceğiniz yayımlanmış REST API'lere göre programlanmış tam açık kaynak SDK'lara sahiptir. Çağrı SDK'sı özel ağ arabirimleri kullanır ve kapalı kaynaktır.

Aşağıdaki tablolarda bu alanları ve REST API'leri ile SDK kitaplıklarının kullanılabilirliğini özetleyeceğiz. API'lerin ve SDK'ların son kullanıcı istemcilerine veya güvenilen hizmet ortamlarına yönelik olup olmadığını not ederiz. SMS gibi API'lere düşük güven ortamlarındaki son kullanıcı cihazları tarafından doğrudan erişilmemelidir.

Arama ve Sohbet uygulamalarının geliştirilmesi Azure İletişim Hizmetleri kullanıcı arabirimi kitaplığı tarafından hızlandırılabilir. Özelleştirilebilir kullanıcı arabirimi kitaplığı, Web ve mobil uygulamalar için açık kaynak kullanıcı arabirimi bileşenleri ve bir Microsoft Teams teması sağlar.

En son SDK'yi kullanmak için uygulama oluşturma

Tarayıcılar ve işletim sistemleri, en son iyileştirmeleri desteklemek ve mevcut hataları düzeltmek için sürekli olarak gelişmektedir. En son Azure İletişim Hizmetleri SDK'sını kullanmak, güncelleştirilmiş tarayıcılar ve işletim sistemi güncelleştirmeleriyle kullanıldığında uygulamanız için en iyi genel son kullanıcı deneyimini elde etme konusunda size yardımcı olabilir. En güncelleştirme Azure İletişim Hizmetleri SDK'sı daha iyi performans, güvenlik, uyumluluk, kalite ve kullanılabilirlik gibi birçok avantaj sunar. Güncelleştirme, tarayıcıya ve işletim sistemine düzenli olarak eklenen en yeni özelliklere ve güncelleştirmelere erişmenizi sağlar. Azure İletişim Hizmetleri SDK'lar sık sık güncelleştirilir (yaklaşık her 6 haftada bir, çeyrekte bire kadar). Her zaman en son SDK'lara güncelleştirdiğinizden emin olmak için bir işlem oluşturmanız tavsiye edilir.

SDK

Bütünleştirilmiş Kod Protokoller Ortam Özellikler
Azure Resource Manager REST Hizmet İletişim Hizmetleri kaynaklarını sağlama ve yönetme
Yaygın Yok İstemci ve Hizmet Diğer SDK'lar için temel türler sağlar
Kimlik REST Hizmet Kullanıcıları yönetme, belirteçlere erişme
Telefon numaraları REST Hizmet Telefon numaralarını alma ve yönetme
SMS REST Hizmet SMS iletileri gönderme ve alma
E-posta REST Hizmet E-posta iletilerinde durum alma ve gönderme
Sohbet Özel sinyal ile REST İstemci ve Hizmet Uygulamalarınıza gerçek zamanlı metin sohbeti ekleme
Arama Özel taşıma İstemci Ses, video, ekran paylaşımı ve diğer gerçek zamanlı iletişim
Çağrı Otomasyonu REST Hizmet PSTN ve VoIP çağrıları için özelleştirilmiş arama iş akışları oluşturma
İş Yönlendiricisi REST Hizmet Çeşitli uygulamalarda müşteri etkileşimlerinin yönetimini iyileştirme
Odalar REST Hizmet Yapılandırılmış iletişim odaları oluşturma ve yönetme
Kullanıcı Arabirimi Kitaplığı Yok İstemci Sohbet ve arama uygulamaları için üretime hazır kullanıcı arabirimi bileşenleri
Gelişmiş Mesajlaşma REST Hizmet WhatsApp Business iletileri gönderme ve alma

Diller ve yayımlama konumları

Tek tek SDK paketleri için yayımlama konumları:

Alan JavaScript .NET Python Java SE iOS Android Diğer
Azure Resource Manager npm NuGet PyPi Maven - - GitHub üzerinden git
Yaygın npm NuGet Yok Maven GitHub Maven -
Kimlik npm NuGet PyPi Maven - - -
Telefon Numaraları npm NuGet PyPi Maven - - -
Sohbet npm NuGet PyPi Maven GitHub Maven -
SMS npm NuGet PyPi Maven - - -
E-posta npm NuGet PyPi Maven - - -
Arama npm NuGet - - CocoaPods Maven -
Çağrı Otomasyonu npm NuGet PyPi Maven
İş Yönlendiricisi npm NuGet PyPi Maven
Odalar npm NuGet PyPi Maven - - -
Kullanıcı Arabirimi Kitaplığı npm - - - GitHub GitHub GitHub, Storybook
Gelişmiş Mesajlaşma npm NuGet PyPi Maven - - -
Başvuru Belgeleri belgeler belgeler belgeler belgeler belgeler belgeler -

SDK platformu destek ayrıntıları

Android Arama SDK'sı desteği

  • Android API Düzeyi 21 veya Üzeri için destek
  • Java 7 veya üzeri için destek
  • Android Studio 2.0 desteği
  • Android çalıştıran Android Auto (AAOS) ve IoT cihazları şu anda desteklenmiyor

iOS Arama SDK'sı desteği

  • Derleme zamanında iOS 10.0+ ve çalışma zamanında iOS 12.0+ desteği
  • Xcode 12.0+
  • iPadOS 13.0+ desteği

.NET

Çağırma aşağıdaki platformları destekler:

  • .NET Native veya C++/WinRT ile UWP
    • Windows 10/11 10.0.17763 - 10.0.22621.0
    • Windows Server 2019/2022 10.0.17763 - 10.0.22621.0
  • .NET 6 ile WinUI3
    • Windows 10/11 10.0.17763.0 - net6.0-windows10.0.22621.0
    • Windows Server 2019/2022 10.0.17763.0 - net6.0-windows10.0.22621.0

Diğer tüm İletişim Hizmetleri paketleri, aşağıdaki platformları destekleyen .NET Standard 2.0'ı hedefler:

  • .NET Framework 4.6.1 aracılığıyla destek
    • Windows 10, 8.1, 8 ve 7
    • Windows Server 2012 R2, 2012 ve 2008 R2 SP1
  • .NET Core 2.0 aracılığıyla destek:
    • Windows 10 (1607+), 7 SP1+, 8.1
    • Windows Server 2008 R2 SP1+
    • Maksimum İşletim Sistemi X 10.12+
    • Linux birden çok sürümü/dağıtımı
    • UWP 10.0.16299 (RS3) Eylül 2017
    • Unity 2018.1
    • Mono 5.4
    • Xamarin iOS 10.14
    • Xamarin Mac 3.8

SDK paket boyutu

SDK Sıkıştırılmış boyut (MB) Sıkıştırılmamış boyut (MB)
iOS SDK ARM64 - 17,1 MB ARM64 - 61,1 MB
Android SDK x86 – 13,3 MB x86 – 33,75 MB
x86_64 – 13,3 MB x86_64 – 35,75 MB
ARM64-v8a – 13,1 MB ARM64-v8a – 37,02 MB
armeabi-v7a – 11,4 MB armeabi-v7a – 23,97 MB

Uygulamanızı geliştirmek istiyorsanız En İyi Yöntemler makalesini okumanızı öneririz. Uygulamanızı yayınlamadan önce gözden geçirmeniz gereken öneriler ve bir denetim listesi sağlar.

REST API'leri

İletişim Hizmetleri API'leri diğer Azure REST API'leri ile birlikte belgelenmiştir. Bu belge, HTTP iletilerinizi nasıl yapılandırabileceğinizi bildirir ve Postman'i kullanmaya yönelik yönergeler sunar. REST arabirimi belgeleri, GitHub'da Swagger biçiminde de yayımlanır. Hizmet sınırları sayfasında tek tek API'ler için azaltma sınırları bulabilirsiniz.

API kararlılığı beklentileri

Önemli

Bu bölümde rest API'ler ve kararlı olarak işaretlenmiş SDK'lar hakkında rehberlik sağlanır. Yayın öncesi, önizleme veya beta olarak işaretlenen API'ler bildirimde bulunmaksızın değiştirilebilir veya kullanımdan kaldırılabilir.

Gelecekte İletişim Hizmetleri SDK'larının sürümlerini devre dışı bırakabiliriz ve REST API'lerimize ve yayımlanan SDK'larımıza hataya neden olan değişikliklere neden olabiliriz. Azure İletişim Hizmetleri genellikle hizmet sürümlerini kullanımdan kaldırmaya yönelik iki desteklenebilirlik ilkesi izler:

  • İletişim Hizmetleri arabirim değişikliği nedeniyle kod değiştirmeniz gerekmeden en az üç yıl önce size bildirilir. Belgelenen tüm REST API'ler ve SDK API'leri genellikle arabirimler kullanımdan kaldırilmeden önce en az üç yıl uyarı alır.
  • SDK derlemelerini en son ikincil sürüme güncelleştirmeden en az bir yıl önce size bildirilir. Bu gerekli güncelleştirmeler aynı ana sürümde olduğundan kod değişikliği gerektirmemelidir. En son SDK'nın kullanılması, genellikle güvenlik ve performans güncelleştirmeleri gerektiren gerçek zamanlı bileşenlerin çağrı ve sohbet kitaplıkları için özellikle önemlidir. Tüm İletişim Hizmetleri SDK'larınızı güncel tutmanızı kesinlikle öneririz.

API ve SDK yetkisini alma örnekleri

SMS REST API'sinin v24 sürümünü uygulamanıza tümleştirdiniz. Azure İletişim v25'i yayınlar.

Bu API'lerin çalışmayı durdurması ve v25'e güncelleştirmeye zorlanması için üç yıl önce uyarı alırsınız. Bu güncelleştirme için kod değişikliği gerekebilir.

Çağrı SDK'sının v2.02 sürümünü uygulamanıza tümleştirdiniz. Azure İletişim v2.05 sürümünü yayınlar.

v2.05'in yayımlanmasından sonra 12 ay içinde Çağrı SDK'sının v2.05 sürümüne güncelleştirmeniz gerekebilir. v2.05 v2 ana sürümünde olduğundan ve hataya neden olan bir değişiklik olmadığından güncelleştirme, kod değişikliği gerektirmeden yapıtın yerini almalıdır.

Sonraki adımlar

Daha fazla bilgi için aşağıdaki SDK genel bakışlarına bakın:

Azure İletişim Hizmetleri kullanmaya başlamak için: