SwaggerHub, OpenAPI tasarımı için ciddi bir merkez olarak ün kazandı ve SmartBear o zamandan beri onu portal, test ve sözleşme testi modülleriyle birlikte yeniden başlatılan Swagger platformuna entegre etti. Yeni paketleme, bir SwaggerHub alternatifi arayışının başladığı yerdir: Swagger'ın fiyatlandırma sayfasına göre, bireysel planlar kullanıcı başına aylık 22,80 dolardan, ekip için 34,44 dolara ve kurumsal için 58,80 dolara kadar çıkıyor; test yürütmeleri özel katmana ulaşmadığınız sürece ayda 50 ila 100 olarak ölçülüyor, SSO kullanıcı başına 6 dolarlık bir eklentidir ve API portalınız Enterprise Plus altındaki her planda SmartBear markasını taşır.
İşte doğrudan yanıt: Apidog, ölçülü test ve ek ücretler olmadan önce spesifikasyon odaklı tasarım isteyen ekipler için en iyi SwaggerHub alternatifidir. Görsel bir OpenAPI tasarımcısını sınırsız test çalıştırmaları, şema tabanlı sahteler (mocking) ve kendi alan adınızda barındırılan belgelerle birleştirir; 4 kullanıcıya kadar ücretsizdir ve sonrasında kullanıcı başına aylık 9 dolardır. Bu makale, yeni Swagger paketlemesini, Apidog'un farklı yaptığı şeyleri ve SwaggerHub'ın hala fiyatını hak ettiği yerleri ele almaktadır.
Yeni Swagger paketlemesinin gerçek maliyeti nedir?
Yeniden başlatılan platform, dört modülü (Studio, Portal, Sözleşme Testi, Fonksiyonel Test) her plana dahil eder, ancak asıl fiyatlandırma işini sınırlar yapar:
- Kullanıcı başına fiyatlar hızla yükselir. Ekip planında kullanıcı başına aylık 34,44 dolar, Apidog'un 9 dolarlık kullanıcı başına fiyatının neredeyse dört katıdır. 10 kişilik bir ekip, herhangi bir eklenti olmadan yılda yaklaşık 4.133 dolar öder. Genel SmartBear faturalandırmasını SmartBear fiyatlandırması ve en iyi alternatifler bölümünde inceledik.
- Test yürütmeleri ölçülür. Bireysel ve Ekip planları ayda 50 test yürütmesi içerir; Kurumsal plan 100 içerir. Her bir birleştirmede mütevazı bir test paketini çalıştıran bir CI hattı, bir veya iki günde 50 yürütmeyi tüketir. Paralel test yürütme yalnızca Enterprise Plus'ta mevcuttur.
- Portal SmartBear logosunu taşır. Katmana bağlı olarak bir ila beş "ürün" yayınlanabilir ve hepsi SmartBear markasına sahiptir; özel bir alan adı ve tam beyaz etiketleme için Enterprise Plus (satışla iletişime geçme katmanı) gereklidir.
- Kimlik bir eklentidir. Kurumsal SSO, Ekip veya Kurumsal planların üzerine kullanıcı başına aylık 6 dolar ek maliyet getirir. Portal Pro (29,40 $), Contract Testing Pro (23 $) ve Test Pro (30 $) ayrıca kullanıcı başına eklentilerdir, bu nedenle tam donanımlı bir Ekip planının gerçekçi kullanıcı başına maliyeti etiket fiyatının çok üzerindedir.
- API sayıları sınırlıdır. Bireysel planda 10 API, Ekip planında 50 API. Orta ölçekli platform ekipleri, beklediklerinden daha kısa sürede 50 spesifikasyona ulaşır.
Bunların hiçbiri tasarım araçlarını kötüleştirmez; SwaggerHub'ın düzenleyicisi ve yönetişim özellikleri güçlü kalır. Bu, fiyatlandırma modelinin spesifikasyonun etrafındaki şeyler için sizden ayrı ayrı ücret aldığı anlamına gelir: yayınlamak, test etmek ve oturum açmak.
Cevap: Apidog
Apidog, SwaggerHub gibi önce spesifikasyon odaklı olarak inşa edilmiş, yaşam döngüsünün geri kalanının ölçülmek yerine dahil edildiği, 500.000'den fazla geliştirici tarafından kullanılan bir API geliştirme platformudur.
Karşılaştırmayı dört fark taşır:
- SwaggerHub'ın ölçtüğü her şeyde sınırsızlık. Ücretsiz dahil her planda sınırsız API, sınırsız test çalıştırması ve sınırsız zamanlanmış yürütme. CI, bir sayaç izlemeye gerek kalmadan her commit'te test paketini çalıştırabilir.
- Spesifikasyon, yalnızca yayınlanan değil, çalışan yapıtları da yönlendirir. Tek bir OpenAPI tanımından Apidog, etkileşimli belgeler, şema tabanlı bir sahte sunucu ve çalıştırılabilir test senaryoları oluşturur. Tasarım değişiklikleri otomatik olarak bu üçüne de yayılır.
- Belgeler, kurumsal bir görüşmeye gerek kalmadan alan adınızda yaşar. Özel alan adları, özel düzenler ve Markdown sayfaları, satıcı logosu gerektirmeyen standart yayınlama özellikleridir.
- Fiyatlandırma tek bir rakamdır. 4 kullanıcıya kadar ücretsiz, sonrasında kullanıcı başına aylık 9 dolar. SSO, SCIM ve RBAC, Kurumsal planda kullanıcı başına eklenti yığını olarak değil, bir plan olarak mevcuttur.
Kullanıcı maliyeti matematiği
Ekip planı oranlarında, boşluk her yeni işe alımla artar. Yıllık maliyet, Swagger Ekip planı kullanıcı başına aylık 34,44 dolar iken, Apidog 4 kişiye kadar ücretsiz ve sonrasında kullanıcı başına 9 dolar:
| Ekip boyutu | Yıllık Swagger Ekip | Yıllık Apidog | Fark |
|---|---|---|---|
| 4 kişi | 1.653 $ | 0 $ (ücretsiz plan) | 1.653 $ |
| 10 kişi | 4.133 $ | 1.080 $ | 3.053 $ |
| 20 kişi | 8.266 $ | 2.160 $ | 6.106 $ |
Kullanıcı başına aylık 6 dolarlık Kurumsal SSO eklendiğinde, 20 kişilik bir ekibin Swagger faturası sadece oturum açma için yılda 1.440 dolar daha artar. Tablo ayrıca, 50 API sınırı ve 50 yürütme ölçerinin hiçbir zaman Kurumsal oranlara yükseltmeyi zorlamadığını varsayarak Swagger tarafını olumlu göstermektedir.
Swagger modüllerine karşı özellik özellik
Studio → görsel + kod spesifikasyon düzenleme
Apidog, spesifikasyon değişikliklerini önermek ve gözden geçirmek için dal (branch) desteğiyle hem görsel bir tasarımcı hem de OpenAPI için bir kod düzenleyici sunar. Yeniden kullanılabilir şema bileşenleri, SwaggerHub'ın Etki Alanları'nın (Domains) günlük kullanım durumunu kapsar. Apidog'da olmayan şey, özel linting kurallarıyla kuruluş çapında stil kılavuzu uygulamasıdır; eğer yüzlerce spesifikasyon arasında Spectral tabanlı yönetişim temel ihtiyacınızsa, bu gerçek bir SwaggerHub gücüdür.
Portal → barındırılan belgeler
Apidog, gerçek ortamlara veya yerleşik sahte sunucuya bağlı bir deneme konsolu ile etkileşimli belgeler yayınlar. Sürüm kontrolü, özel alan adı, kendi markanız. SwaggerHub portalının kademeli "ürün" sayıları ve markalama kurallarının bir karşılığı yoktur çünkü yayınlama ek satış değildir.
Fonksiyonel Test → sınırsız senaryolar
Bu en belirgin farktır. SwaggerHub'ın dahil ettiği test, aylık yürütmeleri ölçer; Apidog'un görsel test senaryoları (zincirlenmiş adımlar, veri çıkarma, onaylamalar, CSV/JSON'dan veri odaklı çalıştırmalar) sınırsız çalışır ve Apidog CLI aracılığıyla CI'da yürütülür:
npm install -g apidog-cli
apidog run scenario --scenario-id 12345 --env staging
Her çalıştırma bir HTML raporu yayar. Ekipler arasında paylaştırılacak bir yürütme bütçesi yoktur.
Otomatik Sahteleme → akıllı sahteler
SwaggerHub'ın otomatik sahtelemesi örnek tabanlı yanıtlar döndürür (ve Bireysel katmanda mevcut değildir). Apidog'un akıllı sahte motoru, şemadan alan adlarını ve türlerini okur ve sıfır kural ile gerçekçi veriler (email için e-postalar, avatar_url için URL'ler) üretir, ayrıca sabit yanıtlar ve dahili ağlar için kendi kendine barındırılan bir seçenek gerektiğinde özel beklentiler sunar. Daha geniş sahte araç ortamı en iyi Swagger alternatifleri bölümündedir.
Modüllerin ötesinde
Apidog aynı zamanda geliştiricilerinizin hata ayıklama yaptığı istek istemcisidir, bu nedenle spesifikasyon üç ayda bir gözden geçirilen bir yönetişim yapıtı değildir; herkesin günlük olarak içinde çalıştığı şeydir. Ve spesifikasyon bir MCP sunucusu aracılığıyla yayınlanır, böylece yapay zeka kodlama ajanları onu doğrudan tüketebilir; bu konu Apidog MCP Sunucusu nedir makalesinde ele alınmıştır.
SwaggerHub (Swagger) ve Apidog'a bir bakışta
| Swagger / SwaggerHub | Apidog | |
|---|---|---|
| Başlangıç fiyatı | Kullanıcı başına aylık 22,80 $ (Bireysel) | 4 kullanıcıya kadar ücretsiz |
| Ekip fiyatı | Kullanıcı başına aylık 34,44 $ + eklentiler | Kullanıcı başına aylık 9 $ |
| API'ler | 10 (Bireysel) / 50 (Ekip) | Sınırsız |
| Test yürütmeleri | Aylık 50-100, yalnızca Enterprise Plus'ta sınırsız | Sınırsız, tüm planlar |
| Paralel test | Yalnızca Enterprise Plus | Dahil |
| Sahteleme | Otomatik sahteleme (Bireysel'de yok) | Şema tabanlı akıllı sahteler, kendi kendine barındırılabilir |
| Portal markalaması | Enterprise Plus altı SmartBear markalaması | Alan adınız, markanız |
| SSO | Kullanıcı başına aylık 6 $ eklenti | Kurumsal plan |
| Spesifikasyon yönetişimi / özel linting | Güçlü (Spectral tabanlı standardizasyon) | Temel doğrulama, kuruluş genelinde kural setleri yok |
| Sözleşme testi (Pact) | Evet, özel modül | Hayır |
| Ağ geçidi senkronizasyonu (AWS, Azure, Apigee) | Evet | Yerel ağ geçidi aktarımı yok |
| Günlük hata ayıklama için istek istemcisi | Hayır | Evet |
Son dört satır kasıtlıdır: her biri iki kazanç. Yönetişim ve entegrasyon satırları, büyük platform ekiplerinin SwaggerHub'ı neden satın aldığını gösterir; fiyat ve ölçüm satırları ise diğer herkesin neden başka yerlere baktığını gösterir.
SwaggerHub'dan geçiş
Her iki araç da doğal olarak OpenAPI konuştuğu için, bu kategorideki en temiz geçişlerden biridir:
- SwaggerHub'dan spesifikasyonlarınızı (YAML veya JSON) dışa aktarın ve Apidog'a aktarın. Uç noktalar, şemalar ve örnekler yapılandırılmış olarak gelir; dışa aktarma sırasında paylaşılan Etki Alanı referanslarını bileşen şemalarına dönüştürün.
- Dallarla inceleme akışını yeniden oluşturun. Birleştirmede spesifikasyon değişiklikleri belgelere, sahtelere ve testlere yayılır.
- Tüketicileri yeni özel alan adınızdaki belge URL'sine yönlendirin ve eski portaldan yönlendirmeler ayarlayın.
- Ölçülen şeyi açın: test paketini her dağıtımda çalışacak şekilde zamanlayın ve ön uç ekiplerine sahte URL'yi verin.
50 spesifikasyonlu bir çalışma alanı (Ekip planının üst sınırı) genellikle bir haftadan kısa sürede taşınır ve dışa aktarma adımı, hangi spesifikasyonların hala aktif olduğunun bir denetimi olarak da işlev görür.
SwaggerHub'ın hala mantıklı olduğu durumlar
Üç dürüst durum. API yönetişimini kuruluş ölçeğinde yürütüyorsanız (özel stil kılavuzları, Spectral kural setleri, yüzlerce spesifikasyon ve düzinelerce ekip arasında standardizasyon raporları), SwaggerHub'ın Kurumsal katmanları bunun için tasarlanmıştır ve Apidog henüz orada rekabet etmemektedir. Mikro hizmet ekipleri arasında Pact tabanlı sözleşme testi iş akışınızın merkezindeyse, Sözleşme Testi modülü gerçek bir farklılaştırıcıdır. Ve spesifikasyonlarınız dağıtımın bir parçası olarak AWS API Gateway, Azure API Management veya Apigee ile çift yönlü olarak senkronize olması gerekiyorsa, SwaggerHub'ın entegrasyonları olgunlaşmıştır. Geçiş, ekibinizin esas olarak API'leri tasarladığı, test ettiği, belgelediği ve sahtelediği zaman işe yarar; ancak ölçülü yürütmeler, markalı portal ve eklenti yığını günlük işler için platform yönetişim fiyatları talep ediyorsa. Önce tasarım alanını karşılaştıran ekipler, Stoplight'ın artık aynı SmartBear çatısı altında olması nedeniyle Stoplight karşılaştırmamızı da okumalıdır.
Sıkça sorulan sorular
SwaggerHub şimdi ne kadar?
Yeniden başlatılan Swagger platformu altında: Bireysel plan kullanıcı başına aylık 22,80 dolardan başlar, Ekip 34,44 dolar, Kurumsal 58,80 dolar ve Enterprise Plus teklif tabanlıdır. Kurumsal SSO (6 dolar), Portal Pro (29,40 dolar), Contract Testing Pro (23 dolar) ve Test Pro (30 dolar) kullanıcı başına aylık eklentilerdir.
Apidog, SwaggerHub'ın ölçüldüğü yerlerde gerçekten sınırsız mı?
Evet. API'ler, istekler, test çalıştırmaları ve zamanlanmış yürütmeler, ücretsiz katman dahil olmak üzere her Apidog planında sınırsızdır. SwaggerHub test yürütmelerini (Enterprise Plus altında ayda 50 ila 100) ölçer ve alt katmanlarda API'leri 10 ila 50 ile sınırlar.
SwaggerHub spesifikasyonlarımı Apidog'a aktarabilir miyim?
Evet. OpenAPI YAML veya JSON olarak dışa aktarın ve doğrudan içe aktarın. Şemalar, uç noktalar, örnekler ve açıklamalar aktarılır; paylaşılan Etki Alanları dışa aktarma sırasında spesifikasyonda çözümlenmelidir.
Apidog, SwaggerHub gibi önce spesifikasyon odaklı tasarımı destekliyor mu?
Evet. Apidog, dal tabanlı inceleme ile OpenAPI için görsel ve kod düzenleyicileri sunar ve spesifikasyon belgeleri, sahteleri ve testleri otomatik olarak yönlendirir. Sunmadığı şey, kuruluş genelinde özel linting kural setleridir; bu, SwaggerHub'ın yönetişim avantajı olarak kalmaktadır.
SwaggerHub'ın API ağ geçidi entegrasyonları ne durumda?
Apidog, spesifikasyonları AWS, Azure veya Apigee ağ geçitlerine doğal olarak aktarmaz. Ağ geçidi senkronizasyonu katı bir gereksinimse, geçiş yapmadan önce bu iş akışını göz önünde bulundurun; OpenAPI aracılığıyla dışa/içe aktarma her iki tarafta da mevcuttur.
Spesifikasyonu tasarlayın, sonra çalıştırın
SwaggerHub'dan bir spesifikasyonu içe aktarın ve ne ürettiğini izleyin: alan adınızdaki belgeler, gerçekçi verilerle bir sahte sunucu ve bu gece planlayabileceğiniz bir test senaryosu, bunların hiçbiri ölçülmez. Apidog'u indirin; 4 kişilik bir ekip ücretsiz değerlendirir ve diğer herkes için kullanıcı başına maliyet 34,44 $ artı eklentilere karşı 9 $'dır.