REST API'lerini kolayca ayrıştırmak/üretmek/yayımlamak için günümüzde kullanan harika çocuklar nelerdir? Ben Swagger bir göz attım ve güzel görünüyor ama bakış açımdan Ruby ile uygun değil. Belki sadece yanılıyorum ve bir şey kaçırıyorum, yardım takdir edilecektir.Ruby tabanlı REST API'lerini üretin ve yayınlayın
Henüz bir API'niz yok mu? Eğer durum buysa, önerdiğim yaklaşım budur.
Arabirimi, swagger-ui kullanarak doğrulayın. Bu, tanımladığınız tüm uç noktaları (yine de, kodlama, json dosyaları hariç!) Görebilmenizi sağlar.
İstediğiniz bir arabirime sahip olduğunuzda, swagger-codegen kullanın. sunucusu. Şu anda daha fazla olan nodejs ve scalatra için şablonlar var. Yeni bir sunucu üreticisi yapmak, sadece bazı bıyık şablonlarını oluşturma/değiştirme meselesidir.
Ayrıca, müşterinizi swagger-codegen ile de oluşturabilirsiniz.
Bunun güzelliği, API'nizin arabirim tabanlı geliştirilmesini yapabilirsiniz. Arayüzleri oluşturun ve boşlukları doldurun. Sıhhi tesisat sizin için yapılır.
Prototip ruby desteği artık mevcut (not! değişiklikler daha çok ruby-ish yapmak için gelecek): https: // github .com/wordnik/swagger-codegen/tree/master/samples/server-generator/sinatra – fehguy
Swagger sana https://github.com/elc/rapi_doc bakmak gerektiğini düşündüğümden daha Eğer RoR kullanırsanız otomatik olarak Swagger uyumlu sunucuya https://github.com/wordnik/swagger-codegen
istemci kütüphaneleri oluşturmak için istemci olarak yakut ile kullanılabilir, ancak kullanımı kolay değildir edilebilir.
Cevabınız için teşekkürler, peki, ben 'rapi_doc' denemeliyim. Swagger kadar seksi görünmüyor ama en azından kurulumu daha basit. – jpemberthy
Bu rapi_doc linki bozuk. Çeşitli yerlerde çatallı buldum. https://github.com/phuc/rapi_doc 2008'den beri sürdürülmemiş gibi gözüküyor. –
Bunun için apipie ile oynamaya yeni başladık. Şimdiye kadar oldukça düzgün görünüyor.
Teşekkürler, gelecek vadeden bir proje için bunu aklımda tutacağım. Zaten uygulamayı yayınladığım zaman, ben uygulamayı yayınladığım için swagger kullanıyordum. – jpemberthy
Lütfen belgeler için ApiDoco gem (https://github.com/72pulses/apidoco/) 'a bir göz atın. Kurulumu çok kolaydır ve iyi bir kullanıcı deneyimine sahiptir.
Harika görünüyor, ama aynı zamanda kurulum için çok iş gerektiriyor gibi görünüyor –
Tam olarak, harika görünüyor ama kaçınmak istiyorum bir ton bağımlılıkları var. – jpemberthy