SDK'lar ve REST API'ler
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 platform desteği
Android ekosistemi kapsamlıdır ve çeşitli cihaz türleri için tasarlanmış çeşitli sürümleri ve özel platformları kapsar. Sonraki tabloda şu anda desteklenen Android platformları listelenir:
| Cihazlar | Açıklama | Destek |
|---|---|---|
| Telefonlar ve tabletler | Android Ticari çalıştıran standart cihazlar. | Video çözünürlüğü ile tam destek. |
Not
Yalnızca telefon ve tabletlerde görüntülü aramaları destekleriz. Standart olmayan cihazlarda veya platformlarda (akıllı gözlük veya özel cihazlar gibi) video içeren kullanım örnekleri için, en uygun tümleştirme yaklaşımını belirlemeye yardımcı olmak için geliştirme sürecinizin başlarında bizimle iletişime geçmenizi öneririz.
Uygulamanız sırasında sorunlarla karşılaşırsanız sorun giderme kılavuzunu ziyaret etmenizi öneririz.
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 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:
- ÇAĞRı SDK'sı Genel Bakış
- Çağrı Otomasyonu SDK'sı Genel Bakış
- İş Yönlendiricisi SDK'sı Genel Bakış
- Sohbet SDK'sı Genel Bakış
- SMS SDK'sına Genel Bakış
- E-posta SDK'sı Genel Bakış
- Gelişmiş Mesajlaşma SDK'sı Genel Bakış
Azure İletişim Hizmetleri kullanmaya başlamak için:
- Azure İletişim Hizmetleri kaynağı oluşturma
- Kullanıcı Erişim Belirteçleri Oluşturma