En İyi Apiary Alternatifi

Apiary kapanıyor. Oracle, Apiary desteğinin sona erdiğine dair bir duyuru yayınladı ve API araçları alanındaki raporlar, barındırılan hizmetin nihai olarak Eylül 2026 civarında kapatılacağını gösteriyor. Site bugün hala yükleniyor, ancak gidişat yıllardır belirgindi: Oracle, Apiary'yi Ocak 2017'de satın aldı, 2018'de ücretli planları kullanımdan kaldırdı ve çevreleyen açık kaynak araçların (Dredd, Gavel) arşiv durumuna düşmesine izin verdi. API dokümantasyonunuz apiary.io üzerinde yaşıyorsa, artık alternatifleri değerlendirmiyorsunuz. Geçiş yapıyorsunuz ve son tarih sizin değiştirebileceğiniz bir şey değil.

İşte doğrudan yanıt: Apidog, en iyi Apiary alternatifidir, çünkü Apiary'nin yaptığı her şeyi (önce tasarıma dayalı spesifikasyon düzenleme, barındırılan interaktif belgeler, bir sahte sunucu) değiştirir ve Apiary'nin asla bitirmediği kısımları ekler: otomatik API testi, artık arşivlenmiş Dredd'in yerine spesifikasyon odaklı doğrulama ve CI entegrasyonu. 4 kullanıcıya kadar ücretsizdir, ücretli planlar kullanıcı başına aylık 9 dolardan başlar. Tek dürüst dezavantajı, Apidog'un API Blueprint dosyalarını doğrudan içe aktarmamasıdır, bu nedenle Blueprint tabanlı projelerin çıkışta OpenAPI'ye bir kerelik dönüştürülmesi gerekir. Bu makale, Apiary'ye ne olduğunu, bu dönüştürme adımı da dahil olmak üzere tam geçiş yolunu ve Apidog uygun değilse hangi alternatifin uyduğunu kapsar.

Apiary'ye Gerçekten Ne Oluyor?

2011'de kurulan Apiary, tasarım öncelikli API iş akışını bir ürün olarak etkili bir şekilde icat etti. Dünyaya, OpenAPI kazanmadan önceki dönemden kalma Markdown tabanlı bir API açıklama formatı olan API Blueprint'i ve Stripe'ın ünlü yaptığı ve herkesin kopyaladığı üç sütunlu dokümantasyon düzenini verdi. Barındırılan bir sahte sunucu, GitHub senkronizasyonu ve Dredd ve Gavel adlı iyi bilinen bir çift açık kaynak sözleşme test aracıyla birlikte geliyordu.

Ardından Oracle, Ocak 2017'de onu satın aldı ve ürün uzun bir sessizliğe büründü. Ücretli katmanlar 2018'de kullanımdan kaldırıldı ve Oracle kurumsal müşterileri kendi API Platform Cloud'una yönlendirirken Apiary ücretsiz bir eski hizmet olarak kaldı. Yeni özellik geliştirme durdu. Dredd ve Gavel arşivlendi. Ve şimdi resmi son: Oracle'ın destek sonlandırma duyurusu, barındırılan hizmetin Eylül 2026 civarında kapanması bekleniyor. Bump.sh, geçiş kılavuzları yayınlayan satıcılardan biri olan, veda yazısında açıkça belirtti: API açıklamalarınızı kapanmadan önce dışa aktarın, çünkü kapandıktan sonra dışa aktarılacak hiçbir şey kalmayacak.

İki pratik sonuç ortaya çıkıyor. Birincisi, yalnızca Apiary içinde var olan her şeyin (API açıklamaları, dokümantasyon metinleri, ekip yapılandırması) dışa aktarma düğmeleri hala çalışırken şimdi ayrılması gerekiyor. İkincisi, API Blueprint'in sürdürülen bir ardıl aracı olmadığı için, geçiş aynı zamanda bir format geçişidir: mantıklı hedef format, hangi platforma geçerseniz geçin, OpenAPI'dir.

Yerine Koyduklarınız

Apiary'nin ekibiniz için gerçekte ne yaptığını tam olarak bilmek yardımcı olur, çünkü değiştirilen her bir parçayı kapsaması gerekir:

• Tasarım öncelikli bir spesifikasyon düzenleyici. Tarayıcıda API Blueprint'i (veya sonraki projelerde OpenAPI 3.0'ı) yazıyordunuz ve belgeler canlı olarak güncelleniyordu.
• Barındırılan interaktif dokümantasyon. apiary.io URL'sinde örnek isteklerle birlikte üç sütunlu referans.
• Bir sahte sunucu. Her Apiary projesi, spesifikasyonunuzdaki örnekleri sunan barındırılan bir sahte uç nokta alıyordu, böylece tüketiciler arka uç mevcut olmadan önce entegrasyon yapabiliyordu.
• GitHub senkronizasyonu. Spesifikasyon dosyası deponuzda yaşıyor ve iki yönlü senkronize ediliyordu.
• Dredd aracılığıyla sözleşme testi. Spesifikasyonunuzu gerçek bir uygulamaya karşı yeniden oynatan ve sapmayı bildiren açık kaynak çalıştırıcı. Şu anda arşivlenmiş durumda; değiştirme sorununu Dredd olmadan API'nizi spesifikasyonuna göre nasıl doğrularsınız makalemizde ele aldık.

Bu paket (tasarım, belgeler, sahte sunucu, doğrulama) modern bir API geliştirme platformunun tam şeklidir. Bu nedenle en iyi geçiş hedefi bir dokümantasyon oluşturucu değil, aynı şekle ve arkasında aktif geliştirmeye sahip bir platformdur.

Cevap: Apidog

Apidog, 500.000'den fazla geliştirici tarafından kullanılan bir API geliştirme platformudur. Apiary'nin 2011'de taslağını çizdiği ve ardından geliştirmeyi durdurduğu tüm yaşam döngüsünü kapsar: tasarım, dokümantasyon, sahteleme (mocking), hata ayıklama ve otomatik test, hepsi tek bir spesifikasyon tarafından yönlendirilir.

Özellikle Apiary'den geçiş yapan biri için:

1. Tasarım öncelikli yaklaşım varsayılan iş akışıdır. Apidog, OpenAPI 3.x için hem görsel bir spesifikasyon düzenleyiciye hem de bir kod düzenleyiciye sahiptir. Uç noktaları, şemaları ve örnekleri bir kez tanımlarsınız; belgeler, sahte sunucular ve testler, bu tanımın oluşturulmuş görünümleridir, Apiary'nin öncülüğünü yaptığı felsefenin aynısı, arkasında sürdürülen bir ürünle.
2. Belgeler barındırılır, interaktiftir ve size aittir. Yayınlanan dokümantasyon, çalışan bir "deneyin" konsolu ile modern referans düzenini, özel bir alan adında ve sürümleme ile elde eder. Bir kapanışta kaybedilecek apiary.io URL'si yoktur.
3. Sahte sunucu, bıraktığınızdan daha akıllıdır. Apiary'nin sahte sunucusu, yazdığınız örnekleri tekrarlıyordu. Apidog'un akıllı sahte sunucusu, spesifikasyon var olduğu anda şemalarınızdan gerçekçi yanıtlar üretir, örnek gerektirmez ve determinizmin önemli olduğu yerlere özel sahte kurallar ekleyebilirsiniz.
4. Sözleşme doğrulama, Dredd'in yerini alır. Apidog'un otomatik test senaryoları, uygulamanıza karşı gerçek istekler çalıştırır ve yanıtları spesifikasyonun şemalarına göre doğrular; bu Dredd'in yaptığı iş artı onaylar, veriye dayalı durumlar ve Apidog CLI aracılığıyla CI çalıştırmalarıdır. Belgeler ayrıca bir MCP sunucusuyla birlikte yayınlanır, böylece yapay zeka ajanları spesifikasyonunuzu doğrudan okuyabilir; ayrıntılar Apidog MCP Sunucusu nedir makalesinde.

Apiary'den Adım Adım Geçiş

Normal bir araç geçişine kıyasla geçişin fazladan bir adımı var ve bunu baştan söylemek daha iyi: Apidog, Apidog içe aktarma dokümantasyonuna göre OpenAPI (Swagger 2.0, OpenAPI 3.0 ve 3.1), Postman koleksiyonları, HAR, RAML, JMeter, apiDoc, I/O Docs, WADL ve Google Discovery formatlarını içe aktarır. API Blueprint bu listede yoktur, bu nedenle Blueprint projeleri önce OpenAPI'ye dönüştürülür. Pratikte bu tek seferlik bir komuttur ve diğer her ciddi hedefin gerektirdiği aynı adımdır, çünkü artık kimse Blueprint araçlarını sürdürmüyor.

1. Şimdi Apiary'den her şeyi dışa aktarın

Her proje için API açıklamasını Apiary düzenleyicisinden indirin. Proje GitHub ile senkronize oluyorsa, doğruluk kaynağınız zaten depodadır; güncel olduğundan emin olun. OpenAPI 3.0'da yazılmış daha sonraki Apiary projeleri zaten doğru formattadır ve 2. adımı atlayabilirler. Bunu diğer her şeye dokunmadan önce ilk ve eksiksiz olarak yapın: dışa aktarmalar, bir son tarihi olan adımdır.

2. API Blueprint'i OpenAPI'ye dönüştürün

Bakımı yapılan dönüştürücülerden birini kullanın:

• api-spec-converter (LucyBot), API Blueprint'ten doğrudan OpenAPI'ye dönüştürme yapar
• apib2swagger, odaklanmış bir Blueprint'ten Swagger/OpenAPI dönüştürücüsü
• Daha sonra openapi-format, çıktıyı normalleştirmek ve OpenAPI 3.1'e yükseltmek isterseniz

Ardından sonucu lint edin (vacuum gibi bir doğrulayıcı veya araç zincirinizdeki herhangi bir OpenAPI linter) ve bilinen iki zayıf noktayı elle kontrol edin: API Blueprint'in asla resmi olarak modellemediği ve dönüştürücülerin tam olarak kurtaramadığı kimlik doğrulama şemaları ve uç nokta açıklamalarında değil, Blueprint'in Markdown bölümlerinde yer alan herhangi bir düz yazı. API başına bir saat ayırın, bir hafta değil; format Markdown'dır, sihir değil.

3. Apidog'a aktarın

Proje Ayarları, Manuel İçe Aktarma, OpenAPI dosyanızı seçin (veya bir URL'den içe aktarın). Uç noktalar, şemalar ve örnekler yapılandırılmış ve gruplandırılmış olarak gelir. Referans belgeleri hemen mevcuttur ve akıllı sahte sunucu, Apiary'nin size verdiği "tüketiciler için sahte URL" özelliğini geri yükleyen, ek kurulum gerektirmeden içe aktarılan her uç nokta için canlıdır.

4. Apiary'nin zaten yapamadığı kısımları yeniden oluşturun

Yayınladığınız belgelere özel bir alan adı yönlendirin, böylece bir sonraki platform kapanışı (herhangi birinin) belge URL'nizi de beraberinde götürmez. Dredd kontrollerinizi Apidog test senaryoları olarak yeniden oluşturun: gerçek istekler, spesifikasyona karşı şema doğrulama, yerel olarak veya CI'da CLI aracılığıyla çalıştırın. Ekibinizde Apiary sahte URL'sine güvenen tüketiciler varsa, belge taşımasını duyuran aynı e-postada onlara yeni sahte temel URL'yi gönderin.

Tek bir API projesi, dönüştürme dahil, bir öğleden sonra taşınır. Bir düzine Blueprint API'den oluşan bir portföy, çoğu kimlik doğrulama şeması elle kontrolü olmak üzere, kısa bir çabadır.

Apiary vs Apidog'a Bir Bakışta

Ücretsiz Bir Aracı Değiştirmenin Maliyeti Nedir?

Apiary'nin fiyatı, kalan en iyi özelliğiydi, bu nedenle geçiş yapan bir ekip için adil karşılaştırma, varış noktasındaki yıllık faturadır. Liste fiyatlarını kullanarak: Apidog 4 kullanıcıya kadar ücretsiz, ardından kullanıcı başına aylık 9 dolar, SwaggerHub Team kullanıcı başına aylık 34.44 dolar, ReadMe Pro yıllık faturalandırıldığında aylık 250 dolar:

Dürüst bir not: eğer ihtiyacınız olan tek şey bir spesifikasyonu ücretsiz olarak oluşturmaksa, yalnızca belge odaklı birkaç araç da ücretsiz katmanlara sahiptir ve yukarıdaki tablo, Apiary'yi en başta faydalı kılan sahte sunucu, test ve işbirliğini istediğinizde önem kazanır. Apidog'un ücretsiz planı, 4 kullanıcıya kadar tüm bunları kapsar ki bu da birçok Apiary mültecisi için geçişin tam olarak dönüştürme öğleden sonrasına mal olması anlamına gelir.

Apidog Uygun Değilse

Dürüst bir bölüm, çünkü "Apiary kullanmaya devam et" menüde yok:

• Yalnızca dokümantasyon oluşturma istiyorsunuz, başka hiçbir şey değil. Spesifikasyonunuz başka bir yerde üretilip test ediliyorsa ve yalnızca değişiklik günlüğü araçlarıyla güzel barındırılan belgelere ihtiyacınız varsa, Bump.sh gibi (Apiary kullanıcıları için geçiş kılavuzu gerçekten iyi olan) belge öncelikli bir ürün makul bir iniş noktasıdır. Oraya ulaşmak için yine de Blueprint'i OpenAPI'ye dönüştürmeniz gerekecek.
• SmartBear yığını üzerinde standartlaşıyorsunuz. SwaggerHub, Apiary'nin barındırılan spesifikasyon kayıt defteri fikrinin felsefi olarak en yakın mirasçısıdır. Kullanıcı başına maliyet ve ölçülü test yürütmelerinin farkında olun; bunu en iyi SwaggerHub alternatifi makalemizde detaylandırdık.
• Büyük bir platform ekibi için tasarım yönetişimi sizin odak noktanız. Stoplight, derin stil kılavuzu ve yönetişim araçları geliştirdi; taahhütte bulunmadan önce nasıl karşılaştırıldığını öğrenmek için en iyi Stoplight alternatifi makalemize bakın.
• API Blueprint'e duygusal olarak bağlısınız. Anlaşıldı, ama yapmayın. Formatın araçları bakımsız, onu yaratan şirket kapatılıyor ve OpenAPI kazandı. Bir kez dönüştürün ve bir daha asla düşünmeyin. Daha eski API Blueprint kılavuzumuz tarihi bir okuma olarak kalabilir.

Sıkça Sorulan Sorular

Apiary Tam Olarak Ne Zaman Kapanıyor?

Oracle, Apiary desteğinin sona erdiğini forumlarında duyurdu ve API araç satıcılarından gelen güncel raporlar, barındırılan hizmetin Eylül 2026 civarında kapatılacağını gösteriyor. Güvenli varsayım daha basittir: şimdi dışa aktarın, çünkü ürünün her parçası zaten bakımsız durumdadır.

Apidog, API Blueprint dosyalarını doğrudan içe aktarabilir mi?

Hayır. Apidog, OpenAPI/Swagger, Postman, HAR, RAML, JMeter, apiDoc, I/O Docs, WADL ve Google Discovery formatlarını içe aktarır. API Blueprint'i önce api-spec-converter veya apib2swagger gibi bir araçla OpenAPI'ye dönüştürün, ardından sonucu içe aktarın. Bu tek seferlik bir adımdır ve sonrasında kimlik doğrulama şemalarını elle kontrol edin.

Apiary sahte sunucusunun yerini ne alıyor?

Apidog'un dahili akıllı sahte sunucusu. Apiary yazdığınız örnekleri tekrarlarken, Apidog şemalarınızdan otomatik olarak gerçekçi yanıtlar üretir ve belirli durumlar için özel sahte kurallar tanımlayabilirsiniz. İçe aktarılan her uç nokta, sıfır yapılandırmayla bir sahte uç nokta alır.

Sözleşme testi için Dredd'in yerini ne alıyor?

Apidog'un otomatik test senaryoları: uygulamanıza gerçek istekler gönderir ve spesifikasyonunuzun şemalarına karşı yanıtları doğrular, onaylar ve Apidog CLI aracılığıyla CI yürütmesi ile. Bu, Dredd'in işini ve Dredd'in asla sahip olmadığı test paketi özelliklerini kapsar.

Apidog küçük bir ekip için gerçekten ücretsiz mi?

Evet. Ücretsiz plan, spesifikasyon düzenleyicileri, yayınlanmış interaktif belgeler, akıllı sahte sunucu ve API testi dahil olmak üzere 4 kullanıcıya kadar kapsar. 4 kullanıcının üzerinde, kullanıcı başına aylık 9 dolardır ve bu, ciddi Apiary geçiş hedefleri arasında en düşük kullanıcı başına fiyattır.

Bugün Dışa Aktarın, Hiçbir Şeyi Yeniden Tasarlamayın

İşlem sırası önemlidir: önce Apiary'den dışa aktarın, ikinci olarak Blueprint'i OpenAPI'ye dönüştürün ve ancak o zaman hedefleri rahatça değerlendirin, çünkü ilk iki adımın bir son tarihi varken üçüncüsünün yoktur. Hazır olduğunuzda, OpenAPI dosyasını Apidog'a aktarın ve öğleden önce belgeleriniz, sahte sunucularınız ve bir test donanımınız hazır olacaktır. Apidog'u indirin veya tarayıcıda başlayın; 4 kişilik bir ekip hiçbir şey ödemez ve Apiary'nin icat ettiği tasarım öncelikli iş akışı nihayet hak ettiği bakımı yapılan platformu elde eder.