Video: Introducing new Azure API Management capabilities | Azure Friday 2024
Amazon Web Hizmetleri (AWS), API'leriyle etkileşimler için ilk olarak SOAP desteğiyle başlatıldı, ancak önerilmiyor (destek azaldı) başka bir deyişle SOAP arayüzünün REST lehine kullanılması. AWS API'sinin herhangi bir kullanımı için en iyi öneri, REST kullanımına odaklanmanızdır.
Böylece, etkileşim mekanizmalarının ayrıntılarını unuttuğunuz sürece, bir gün çalışmayı bırakacak programlarla sonuçlanmayacaksınız. Bir sisteme geri dönmek ve eylemlerinizi aylar ya da yıllar önce yeniden yapılandırmak zorunda kalmak gibi tatsız bir görevin deneyimi maalesef talihsiz bir deneyimdir.
AWS ile cazip kaderi anlamsızdır - AWS API ile etkileşim kurmak isterseniz, Amazon'un uzun vadeli yönü olan REST'i kullanın.
SOAP (Basit Nesne Erişim Protokolünün kısaltılmışı) eski yaklaşım, kapsamlı bir standartlar setiyle birlikte kapsamlı bir endüstri desteği sağladı. Bu standartlar maalesef çok kapsamlıydı. SOAP'ı tasarlayan insanlar son derece esnek olmak için onu kurarlar - web, e-posta ve özel ağlar arasında iletişim kurabilirler. Güvenlik ve yönetilebilirliği sağlamak için, SOAP ile bütünleşen birkaç destek standartları da tanımlandı.
SOAP , Genişletilebilir Biçimlendirme Dili (XML, kısaca) olarak bilinen bir belge kodlama standardını temel alır ve SOAP hizmeti, kullanıcıların daha sonra XML kullanmasına izin vermeyecek şekilde tanımlanır temel iletişim ağı nedir. Bununla birlikte, bu sistemin çalışabilmesi için SOAP tarafından aktarılan veriler (yaygın olarak payload olarak anılacaktır) XML biçiminde olmalıdır.
Buraya bir şekil uyarıldı mı? Kapsamlı ve esnek olmak için (veya tüm insanlara herşey olmak için) ve XML yükü gereksinimi itilmesi, SOAP'ın oldukça karmaşık hale geldiği ve bu nedenle düzgün bir şekilde kullanmak için çok çalışması anlamına geldiği anlamına geliyordu. Tahmin edebileceğiniz gibi, pek çok BT personeli SOAP'ı yıldırıcı bulmuş ve sonuç olarak bunu reddetmiştir.
Yaklaşık on yıl önce, bir doktora öğrencisi, tezinin bir parçası olarak başka bir web hizmetleri yaklaşımı belirledi: REST, veya Temsili Devlet Transferi. SOAP'tan çok daha az kapsamlı olan REST, daha az sorunu çözmeyi hedeflemektedir. SOAP'ın önemli görünen bazı yönlerini ele almamakla birlikte, geriye doğru bakıldığında, kullanımı daha karmaşık hale getirdi - örneğin güvenlik.
REST'in en önemli yönü, standart web protokolleriyle entegre olacak şekilde tasarlandığından REST hizmetlerinin standart web fiilleri ve URL'lerle çağrılabilmesi. Örneğin, geçerli bir REST çağrısı şu şekilde görünür:
// arama.examplecompany. com / CompanyDirectory / EmployeeInfo? empname = BernardGolden
Personel bilgilerini görmek için examplecompany'nin REST hizmetine bir sorgu yapmak için yeterlidir. Bu isteğin eşlik ettiği HTTP fiilinin, GET, geri gönderilmesi için bilgi istemektir. Bilgileri silmek için, fiil DELETE'yi kullanırsınız. Bilgi eklemek için POST fiilini kullanın. Bilgileri güncellemek için PUT fiilini kullanırsınız.
POST ve PUT eylemleri için, empname'ye ek bilgi eşlik eder ve hizmet tarafından kullanılacak başka bir bağımsız değişkeni belirtmek için bir ve işareti (&) ile ayrılır.
REST, hizmet yükleri üzerinde belirli bir biçimlendirme gereksinimi getirmez; Bu bağlamda, XML gerektiren SOAP'tan farklıdır. Basit etkileşimler için, yük için tek ihtiyacınız olan bayt dizisidir; daha karmaşık etkileşimler için (örneğin, çalışan bilgilerinizi geri göndermenin yanı sıra, adları G ile başlayan tüm çalışanların çalışan bilgileri için bir istek yerleştirmek istediğinizi varsayalım), kodlama sözleşmesi JSON kullanılır. (JSON, eğer merak ediyorsanız, Javascript Nesne Tabelasını belirtirsiniz.)
REST'in daha basit kullandığı modeli, standart web protokolleri ve fiilleri ile hizalamasını ve daha az kısıtlayıcı yükü biçimlendirmesini beklediğiniz gibi geliştiricilerle yakalamasını sağladı. ateşte bir ev gibi.
