RESTful API Açıklama Dillerine Genel Bakış - Overview of RESTful API Description Languages

RESTful (Temsili Devlet Transferi) API (uygulama programlama Arayüzü) DL'ler (açıklama dilleri) resmi diller yapılandırılmış bir açıklama sağlamak için tasarlanmıştır. RESTful web API bu hem insan hem de otomatik makine işleme için kullanışlıdır. API Açıklama Dilleri bazen arayüz açıklama dilleri (IDL'ler). Yapılandırılmış açıklama, insanlar için belgeler oluşturmak için kullanılabilir. programcılar; aynı araç tarafından oluşturulan tüm belgeler aynı biçimlendirme kurallarını izlediğinden, bu tür belgelerin okunması serbest biçimli belgelerden daha kolay olabilir. Ek olarak, açıklama dili genellikle kitaplıklar gibi çeşitli yazılım yapılarının otomatik olarak oluşturulmasına izin verecek kadar kesindir ve çeşitli programlama dillerinden API'ye erişir ve bu da onları programcılardan manuel olarak oluşturma yükünü ortadan kaldırır.

Tarih

Önceki iki ana açıklama dili vardır: WSDL2.0 (Web Hizmetleri Açıklama Dili) ve WADL (Web Uygulaması Açıklama Dili). İkisi de RESTful API'leri tanımlamak için endüstride yaygın olarak benimsenmemiştir, her ikisinin de zayıf insan okunabilirliğini ve WADL'nin aslında bir RESTful API'yi tam olarak tanımlayamadığını belirtmektedir.^[1]

Alternatifler

Hypertext odaklı API'ler

RESTful API'leri oluşturmaya yönelik alternatif bir yaklaşım, HATEOAS (Uygulama Durumunun Motoru Olarak Hiper Ortam ). Bu yaklaşımda, istemci yazılımı, dokümantasyon yoluyla paylaşılan statik bir arayüz açıklamasına yazılmaz. Bunun yerine, müşteriye bir dizi giriş noktası verilir ve API, bu uç noktalar ile etkileşim yoluyla dinamik olarak keşfedilir. HATEOAS tanıtıldı Roy Fielding doktora tezi Mimari Stiller ve Ağ Tabanlı Yazılım Mimarilerinin Tasarımı. HATEOAS, onları diğerlerinden ayıran RESTful API'ler için orijinal vizyon olmuştur. RPC mekanizmalar.^[2]

RESTful API DL'lerinin listesi

• Web Hizmetleri Açıklama Dili (WSDL)
• Web Uygulaması Açıklama Dili (WADL)
• CloudRail
  • URL: http://cloudrail.com/
  • geliştirici: licobo GmbH
• Google Cloud Uç Noktaları
  • URL: https://cloud.google.com/endpoints/, https://developers.google.com/discovery
  • geliştirici: Google
• Veri Protokolünü Aç (OData)
  • VAHA standart^[3]
  • URL: http://www.odata.org/
  • geliştirici: Microsoft
• OpenAPI Spesifikasyonu
  • URL: https://openapis.org/
  • geliştirici: Open API Initiative (OAI), başlangıçta "Swagger" spesifikasyonu olarak geliştirildi Wordnik, SmartBear Yazılımı
• RESTful Hizmet Tanım Dili (RSDL)
  • URL: http://www.balisage.net/Proceedings/vol10/html/Robie01/BalisageVol10-Robie01.html
  • geliştirici: Michael Pasternak
• Hydra Çekirdek Kelime Bilgisi (Hydra)
  • URL: http://www.hydra-cg.com/spec/latest/core/
  • geliştirici: Hydra W3C Community Group, http://www.hydra-cg.com/
• RESTful API Modelleme Dili (RAML)
  • URL: http://raml.org/
  • geliştirici: Mulesoft, http://www.mulesoft.com/
• Hiper medya
• API Taslağı
  • URL: https://apiblueprint.org/
  • geliştirici Apiary https://apiary.io/company
• API Oluşturucu
  • URL: https://www.apibuilder.io/
  • geliştiriciler: HBC, Flow Commerce
• I / O Belgeleri
  • URL: https://github.com/mashery/iodocs
  • geliştirici: Mashery, http://www.mashery.com/
• Apache Avro
• Avukat
  • URL: http://barrister.bitmechanic.com/
  • geliştirici: James Cooper^[4]
• SERIN - Anlamsal Dinlendirici Arayüzler^[5]
  • URL: http://www.semanticinterface.org
  • geliştiriciler: Bruno Muniz, Hermano Lira, José Renato Villela Dantas, Tadeu Nunes, Laura Chaves, Julio Cesar Campos Neto, Pedro Porfírio Muniz Farias

Veri açıklama dillerinin listesi

RESTful API açıklamasının önemli bir kısmı, döndürülen veri yapılarının belirtimidir. IDL, kendi formatını belirtebilir veya mevcut bir veri tanımlama formatını kullanabilir. Birçok RESTful API DL'nin kullandığı dikkate değer bir örnek JSON Şeması.

• json: api
  • http://jsonapi.org/
  • REST adaptörü olarak başlatıldı Kor Veri
• JSON Şeması
  • OpenAPI, Google APIs Discovery tarafından kullanılır,^[6] I / O Belgeleri
• Apache Avro
  • https://avro.apache.org/
  • hem Arayüz Tanımlama Dili hem de veri tanımlama dili
• JSON-RPC 2.0
  • Barrister tarafından kullanılan

RESTful API DL'lerinin Karşılaştırması

RESTful API DLs çevresindeki topluluk etkindir ve manzara hala değişmektedir. Akana'nın bir sunumuna göre bu alandaki en aktif projeler OpenAPI, RAML ve API Blueprint.^[1]

Çerçeveler

Çoğu sunucu çerçevesi, bir veya daha fazla IDL ile birlikte çalışır.

• Gugamarket REST API çerçevesi
  • IDL'ler: OpenAPI
  • URL: https://pliik.github.io/gugamarket/
  • geliştirici: https://github.com/pliik

Referanslar

Dış bağlantılar

• Api Geliştirici Araçlarının İncelenmesi