SDK 'Lar ve REST API 'Leri
Azure Iletişim Hizmetleri Özellikleri, kavramsal olarak sekiz alan halinde düzenlenir. Çoğu alan, doğrudan Internet üzerinden kullanabileceğiniz, yayımlanan REST API 'Lerine karşı programlanan tam açık kaynaklı SDK 'Lara sahiptir. Çağıran SDK özel ağ arabirimlerini kullanır ve kapalı kaynağıdır.
Aşağıdaki tablolarda, bu alanların ve REST API 'lerinin ve SDK kitaplıklarının kullanılabilirliği özetlenmektedir. Ayrıca API 'Lerin ve SDK 'Ların Son Kullanıcı istemcileri veya güvenilir hizmet ortamları için tasarlandığına de göz önünde sunuyoruz. Düşük güven ortamlarındaki Son Kullanıcı cihazlarındaki API 'Ler ve SDK 'Lar ile doğrudan erişilmemelidir.
Web tabanlı çağrı ve sohbet uygulamalarının geliştirilmesi, Azure Iletişim Hizmetleri Kullanıcı arabirimi kitaplıklarıtarafından hızlandırılır. UI kitaplığı, uygulamalarınıza sunmanıza yönelik üretime Ready Kullanıcı arabirimi bileşenleri sağlar.
REST API'leri
İletişim Hizmetleri API 'Leri, docs.Microsoft.com' deki DIĞER Azure REST API 'leri ile birlikte belgelenmiştir. Bu belgede, HTTP iletilerinizi nasıl yapılandıracağınızı ve Postman kullanmaya yönelik yönergeler sunulmaktadır. REST arabirimi belgeleri GitHubüzerinde Swagger biçiminde de sunulur.
SDK
| Bütünleştirilmiş Kod | Protokoller | Ortam | Özellikler |
|---|---|---|---|
| Azure Resource Manager | REST | Hizmet | Iletişim Hizmetleri kaynaklarını sağlama ve yönetme |
| Common | Yok | İstemci & hizmeti | Diğer SDK 'lar için temel türleri sağlar |
| Kimlik | REST | Hizmet | Kullanıcıları yönetme, belirteçleri erişim |
| Telefon numaraları | REST | Hizmet | Telefon numaralarını edinin ve yönetin |
| SMS | REST | Hizmet | SMS iletileri gönderme ve alma |
| Sohbet | Özel sinyalle rest | İstemci & hizmeti | Uygulamalarınıza gerçek zamanlı metin sohbeti ekleyin |
| Events | Özel aktarım | İstemci | Ses, video, ekran paylaşımı ve diğer gerçek zamanlı iletişim |
| Sunucu çağrılıyor | REST | Hizmet | Çağrılar yapma ve yönetme, ses yürütme ve kayıt yapılandırma |
| Ağ geçişi | REST | Hizmet | Alt düzey veri aktarımı için sunucuları açma erişimi |
| UI kitaplığı | Yok | İstemci | Sohbet ve arama uygulamaları için üretime Ready Kullanıcı arabirimi bileşenleri |
Diller ve yayımlama konumları
Bireysel SDK paketleri için yayımlama konumları aşağıda ayrıntılı olarak verilmiştir.
| Alan | JavaScript | .NET | Python | Java SE | iOS | Android | Diğer |
|---|---|---|---|---|---|---|---|
| Azure Resource Manager | npm | NuGet | Pypı | Maven | - | - | GitHub aracılığıyla git |
| Common | npm | NuGet | Yok | Maven | GitHub | Maven | - |
| Kimlik | npm | NuGet | Pypı | Maven | - | - | - |
| Telefon numaraları | npm | NuGet | Pypı | Maven | - | - | - |
| Sohbet | npm | NuGet | Pypı | Maven | GitHub | Maven | - |
| SMS | npm | NuGet | PyPi | Maven | - | - | - |
| Arama | npm | NuGet | - | - | GitHub | Maven | - |
| Çağrı Otomasyonu | NuGet | Maven | |||||
| Ağ Geçişi | npm | NuGet | PyPi | Maven | - | - | - |
| UI Kitaplığı | npm | - | - | - | - | - | GitHub, Storybook |
| Başvuru Belgeleri | Dokümanlar | Dokümanlar | - | Dokümanlar | Dokümanlar | Dokümanlar | - |
Kolay derleme adları ve ad alanları arasındaki eşleme şöyledir:
| Bütünleştirilmiş Kod | Ad alanları |
|---|---|
| Azure Resource Manager | Azure.ResourceManager.Communication |
| Common | Azure.Communication.Common |
| Kimlik | Azure.Communication.Identity |
| Telefon numaraları | Azure.Communication.PhoneNumbers |
| SMS | Azure.Communication.SMS |
| Sohbet | Azure.Communication.Chat |
| Arama | Azure.Communication.Calling |
| Sunucuyu Çağırma | Azure.Communication.CallingServer |
| Ağ Geçişi | Azure.Communication.NetworkTraversal |
| UI Kitaplığı | Azure.Communication.Calling |
REST API Azaltmaları
Bazı REST API'leri ve buna karşılık gelen SDK yöntemlerinde dikkat etmek gereken kısıtlama sınırları vardır. Bu kısıtlama sınırlarının aşılırsa bir hata 429 - Too Many Requests yanıtı tetiklenir. Bu sınırlar, bir istek aracılığıyla Azure Desteği.
| API | Kısıtlama |
|---|---|
| Tüm Arama Telefon Numarası Planı API'leri | Günde 4 istek |
| Telefon Numarası Planı Satın Alma | Ayda 1 satın alma |
| SMS gönderme | Dakikada 200 istek |
SDK platformu destek ayrıntıları
iOS ve Android
- İletişim Hizmetleri iOS SDK'ları iOS sürüm 13+ ve Xcode 11+'ı hedefler.
- Android Java SDK'ları Android API düzeyi 21+ ve Android Studio 4.0+ hedeflemektedir
.NET
Arama dışında, İletişim Hizmetleri paketleri aşağıda listelenen .NET Standard destekleyen 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+
- En fazla OS 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
Çağırma paketi, aşağıdakiler üzerinde .NET Native veya C++/WinRT ile UWP uygulamalarının derlemelerini destekler:
- Windows 10 10.0.17763
- Windows Server 2019 10.0.17763
API kararlılığı beklentileri
Önemli
Bu bölüm, kararlı olarak işaretlenmiş REST API'ler ve SDK'lar hakkında rehberlik sağlar. Yayın öncesi, önizleme veya beta olarak işaretlenen API'ler, bildirimi olmadan değiştirilebilir veya kullanımdan değiştirilebilir.
Gelecekte İletişim Hizmetleri SDK'larının sürümlerini kaldırabilirsiniz ve REST API'lerimize ve yayımlanan SDK'lara önemli değişiklikler estirebilirsiniz. Azure İletişim Hizmetleri, genellikle hizmet sürümlerinin eski sürümü için iki destek durumu ilkelerini takip eder:
- İletişim Hizmetleri arabirimi değişikliği nedeniyle kodun değişmesi gerekmeden önce size en az üç yıl bildirilecek. Belgelenmiş tüm REST API'ler ve SDK API'leri genellikle arabirimler kullanıma alınmadan önce en az üç yıl uyarıdan keyif almaktadır.
- SDK derlemelerini en son ikincil sürüme güncelleştirmeniz gerekmeden önce size en az bir yıl bildirilecek. Bu gerekli güncelleştirmeler, aynı ana sürümde olduğundan herhangi bir kod değişikliği gerektirmez. En son SDK'nın kullanımı, genellikle güvenlik ve performans güncelleştirmeleri gerektiren gerçek zamanlı bileşenler olan Arama ve Sohbet kitaplıkları için özellikle önemlidir. Tüm İletişim Hizmetleri SDK'larınızı güncelleştirmenizi kesinlikle önemle tavsiyelerimizi sunarız.
API ve SDK'nın kullanımından kaldıran örnekler
SMS uygulamasının v24 sürümünü uygulamanıza REST API tümleştirin. Azure İletişim v25'i yayımlar.
Bu API'ler çalışmayı durdurmadan ve v25'e güncelleştirmeye zorlanmadan önce üç yıl uyarı alasiniz. Bu güncelleştirme için kod değişikliği gerekli olabilir.
Arama SDK'sı v2.02 sürümünü uygulamanıza tümleştirin. Azure İletişim v2.05'i yayımlar.
v2.05 sürümünden sonra 12 ay içinde Çağıran SDK'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 gerektirmeden yapının basit bir değiştirmesi gerekir.
Sonraki adımlar
Daha fazla bilgi için aşağıdaki SDK'ya genel bakış bilgilerine bakın:
Yeni bir Azure İletişim Hizmetleri: