En İyi SwaggerHub Alternatifi

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 başlar; Ekip planı 34,44 dolar, Kurumsal plan ise 58,80 dolara kadar çıkar. Test yürütmeleri, özel katmana ulaşmadığınız sürece ayda 50 ila 100 ile ölçülür. 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.

Apidog'u bugün deneyin

Doğrudan yanıt şu: Apidog, ölçülü test ve ek ücretler olmadan spesifikasyon odaklı tasarım isteyen ekipler için güçlü bir 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; sonrasında kullanıcı başına aylık 9 dolardır.

Bu yazıda şunları uygulama odaklı şekilde ele alacağız:

• Yeni Swagger paketlemesinin maliyet etkisi
• Apidog'un tasarım, test, mock ve dokümantasyon iş akışları
• SwaggerHub'dan OpenAPI tabanlı geçiş adımları
• SwaggerHub'ın hâlâ daha uygun olduğu senaryolar

Yeni Swagger paketlemesinin gerçek maliyeti nedir?

Yeniden başlatılan platform, dört modülü — Studio, Portal, Sözleşme Testi ve Fonksiyonel Test — her plana dahil eder. Ancak maliyeti belirleyen unsur modüllerden çok plan sınırlarıdır.

• Kullanıcı başına fiyatlar hızla yükselir. Ekip planı kullanıcı başına aylık 34,44 dolardır. Bu, Apidog'un kullanıcı başına 9 dolarlık fiyatının neredeyse dört katıdır. Örneğin 10 kişilik bir ekip, eklentiler hariç yılda yaklaşık 4.133 dolar öder. Genel SmartBear maliyetlerini SmartBear fiyatlandırması ve en iyi alternatifler yazısında inceleyebilirsiniz.
• Test yürütmeleri ölçülür. Bireysel ve Ekip planları ayda 50 test yürütmesi içerir; Kurumsal plan 100 yürütme sunar. Her birleştirmede test paketi çalıştıran bir CI hattı, bu kotayı kısa sürede tüketebilir. Paralel test çalıştırma yalnızca Enterprise Plus'ta bulunur.
• Portal SmartBear logosunu taşır. Katmana göre bir ila beş ürün yayınlayabilirsiniz; Enterprise Plus altındaki planlarda SmartBear markalaması devam eder. Özel alan adı ve tam beyaz etiketleme için Enterprise Plus gerekir.
• Kimlik özellikleri eklentidir. Kurumsal SSO, Ekip veya Kurumsal planlara kullanıcı başına aylık 6 dolar ekler. Portal Pro (29,40 $), Contract Testing Pro (23 $) ve Test Pro (30 $) da kullanıcı başına ek maliyet oluşturur.
• API sayıları sınırlıdır. Bireysel planda 10 API, Ekip planında 50 API sınırı vardır. Orta ölçekli platform ekipleri bu sınıra beklenenden hızlı ulaşabilir.

Bu sınırlamalar SwaggerHub'ın tasarım araçlarını zayıf yapmaz. Düzenleyicisi ve yönetişim özellikleri güçlüdür. Ancak fiyatlandırma modeli, spesifikasyonun çevresindeki işler için — yayınlama, test etme ve oturum açma — ayrı ücretler oluşturur.

Cevap: Apidog

Apidog, SwaggerHub gibi spesifikasyon odaklı çalışan bir API geliştirme platformudur. Farkı, yaşam döngüsünün geri kalanını ayrı kotalarla ölçmek yerine aynı iş akışına dahil etmesidir.

Karşılaştırmayı dört temel fark belirler:

1. SwaggerHub'ın ölçtüğü iş yüklerinde sınırsız kullanım
   
   Ücretsiz plan dahil tüm planlarda sınırsız API, sınırsız test çalıştırması ve sınırsız zamanlanmış yürütme bulunur. Böylece CI hattınız her commit'te test çalıştırabilir.

2. OpenAPI tanımı çalışan çıktıları yönlendirir
   
   Tek bir OpenAPI tanımından etkileşimli belgeler, şema tabanlı mock sunucu ve çalıştırılabilir test senaryoları oluşturabilirsiniz. Tasarım değişiklikleri bu çıktılara yayılır.

3. Dokümantasyon kendi alan adınızda yayınlanır
   
   Özel alan adı, özel düzen ve Markdown sayfalarıyla dokümantasyonu satıcı markalaması olmadan yayınlayabilirsiniz.

4. Fiyatlandırma daha basittir
   
   4 kullanıcıya kadar ücretsizdir; sonrasında kullanıcı başına aylık 9 dolar olarak fiyatlanır. SSO, SCIM ve RBAC, Kurumsal planda kullanıcı başına ek paketler yerine plan kapsamında sunulur.

Kullanıcı maliyeti matematiği

Ekip planı oranlarında fark, ekip büyüdükçe artar. Swagger Ekip planı kullanıcı başına aylık 34,44 dolar iken Apidog, 4 kullanıcıya kadar ücretsiz ve sonrasında kullanıcı başına aylık 9 dolardır.

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ı yalnızca oturum açma için yılda 1.440 dolar daha artar.

Bu hesap, Swagger tarafında 50 API sınırının veya aylık test yürütme kotasının sizi daha üst bir plana geçmeye zorlamadığını varsayar. Gerçek maliyet bu nedenle daha yüksek olabilir.

Swagger modüllerine karşı özellik bazlı karşılaştırma

Studio → Görsel ve kod tabanlı spesifikasyon düzenleme

Apidog, OpenAPI için hem görsel tasarımcı hem de kod düzenleyici sunar. Değişiklikleri önermek ve incelemek için dal (branch) tabanlı bir akış kullanabilirsiniz.

Uygulanabilir bir inceleme akışı şu şekildedir:

1. Ana OpenAPI tanımını ana dalda tutun.
2. Her endpoint veya şema değişikliği için yeni dal oluşturun.
3. Değişikliği görsel düzenleyicide veya YAML/JSON editöründe yapın.
4. İnceleme sonrası değişikliği birleştirin.
5. Dokümantasyon, mock ve test senaryolarının yeni tanımı kullandığını doğrulayın.

Yeniden kullanılabilir şema bileşenleri, SwaggerHub Domains'in günlük kullanım ihtiyacını kapsar. Ancak kuruluş genelinde özel linting kuralları ve Spectral tabanlı standartlaştırma gerekiyorsa SwaggerHub'ın yönetişim yetenekleri daha güçlüdür.

Portal → Barındırılan belgeler

Apidog ile gerçek ortamlara veya yerleşik mock sunucuya bağlı etkileşimli API belgeleri yayınlayabilirsiniz.

Yayınlama sürecinde şunları yapılandırın:

1. OpenAPI spesifikasyonunuzu içe aktarın veya oluşturun.
2. Dokümantasyonda kullanılacak ortamı seçin.
3. Deneme konsolunu gerçek API veya mock sunucuya bağlayın.
4. Özel alan adınızı tanımlayın.
5. Ürün rehberleri ve açıklamalar için Markdown sayfaları ekleyin.
6. Tüketicileri yeni dokümantasyon URL'sine yönlendirin.

SwaggerHub portalındaki kademeli ürün sayıları ve markalama kurallarına karşılık gelen ayrı bir yayınlama eklentisi yoktur.

Fonksiyonel Test → Sınırsız senaryolar

En belirgin fark test yürütme modelidir. SwaggerHub'ın dahil ettiği test kapasitesi aylık yürütmelerle ölçülür. Apidog'da ise zincirlenmiş adımlar, veri çıkarma, onaylamalar ve CSV/JSON tabanlı veri odaklı çalıştırmalar içeren senaryoları sınırsız çalıştırabilirsiniz.

Apidog CLI ile bir senaryoyu CI içinde çalıştırmak için:

npm install -g apidog-cli
apidog run scenario --scenario-id 12345 --env staging

Bu komutu CI/CD hattınıza eklemek için örnek yaklaşım:

# Test ortamına dağıtımdan sonra
apidog run scenario --scenario-id 12345 --env staging

# Komut başarısız olursa pipeline başarısız olur

Her çalıştırma bir HTML raporu üretir. Ekipler arasında paylaştırmanız gereken bir yürütme bütçesi bulunmaz.

Otomatik sahteleme → Akıllı mock'lar

SwaggerHub'ın otomatik sahtelemesi örnek tabanlı yanıtlar döndürür ve Bireysel katmanda mevcut değildir.

Apidog'un akıllı mock motoru, şemadaki alan adlarını ve türlerini okuyarak sıfır ek kuralla gerçekçi veri üretir. Örneğin:

• email alanı için e-posta adresleri
• avatar_url alanı için URL değerleri
• Sayısal alanlar için türe uygun sayılar
• Diziler ve iç içe nesneler için şemaya uygun veri yapıları

Mock davranışını iki seviyede yönetebilirsiniz:

1. Şema tabanlı otomatik yanıtlar: OpenAPI şemasından veri üretin.
2. Özel beklentiler: Belirli istekler için sabit veya koşullu yanıtlar tanımlayın.

Dahili ağlar için kendi kendine barındırılan bir seçenek de kullanılabilir. Daha geniş araç karşılaştırması için en iyi Swagger alternatifleri yazısına bakabilirsiniz.

Modüllerin ötesinde

Apidog aynı zamanda günlük hata ayıklama için kullanılan bir istek istemcisidir. Böylece API spesifikasyonu yalnızca üç ayda bir gözden geçirilen bir yönetişim çıktısı olmaktan çıkar; geliştiricilerin günlük çalıştığı kaynak hâline gelir.

Spesifikasyon ayrıca bir MCP sunucusu aracılığıyla yayınlanabilir. Böylece yapay zekâ kodlama ajanları API tanımını doğrudan tüketebilir. Ayrıntılar için Apidog MCP Sunucusu nedir yazısını inceleyin.

SwaggerHub ve Apidog karşılaştırması

	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 planda yok	Şema tabanlı akıllı mock'lar, kendi kendine barındırılabilir
Portal markalaması	Enterprise Plus altında 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 özellikle önemlidir. Yönetişim, Pact sözleşme testi ve ağ geçidi entegrasyonları; büyük platform ekiplerinin SwaggerHub'ı seçme nedenleridir. Fiyat, yürütme kotası, portal markalaması ve günlük geliştirme iş akışı ise diğer ekiplerin alternatif aramasının nedenleridir.

SwaggerHub'dan geçiş

Her iki araç da OpenAPI kullandığı için geçiş süreci doğrudandır.

1. Spesifikasyonları dışa aktarın

SwaggerHub'dan API tanımlarınızı YAML veya JSON olarak dışa aktarın.

Dışa aktarma öncesinde:

• Paylaşılan Domains referanslarını kontrol edin.
• Gerekirse bu referansları bileşen şemalarına çözümleyin.
• Aktif olmayan veya kullanılmayan spesifikasyonları ayıklayın.

2. Apidog'a içe aktarın

OpenAPI YAML veya JSON dosyasını Apidog projenize aktarın.

İçe aktarma sonrasında şunları doğrulayın:

• Endpoint'ler
• İstek ve yanıt şemaları
• Örnek payload'lar
• Açıklamalar
• Güvenlik tanımları
• Sunucu ve ortam değişkenleri

3. Dal tabanlı inceleme akışını yeniden kurun

Spesifikasyon değişiklikleri için dal oluşturun ve inceleme sürecini kod değişiklikleriyle aynı akışa bağlayın.

Birleştirme sonrasında şunların güncellendiğini test edin:

• Etkileşimli dokümantasyon
• Mock sunucu yanıtları
• Test senaryoları

4. Dokümantasyonu yeni alan adına taşıyın

Tüketicileri yeni özel alan adınızdaki dokümantasyon URL'sine yönlendirin. Mümkünse eski portaldan yeni portala yönlendirme ekleyin.

5. Ölçülen işleri otomatikleştirin

Geçişten sonra en büyük kazanım, daha önce kota nedeniyle sınırladığınız işleri otomatikleştirmektir:

• Test paketlerini her dağıtımda çalıştırın.
• Zamanlanmış test senaryoları oluşturun.
• Ön uç ekiplerine mock URL'sini verin.
• Mock yanıtlarını sözleşme değişikliklerinden sonra doğrulayın.

50 spesifikasyonlu bir çalışma alanı — Ekip planının üst sınırı — genellikle bir haftadan kısa sürede taşınabilir. Dışa aktarma işlemi aynı zamanda hangi spesifikasyonların hâlâ aktif olduğunu denetlemek için iyi bir fırsattır.

SwaggerHub'ın hâlâ mantıklı olduğu durumlar

SwaggerHub bazı senaryolarda daha uygun seçenektir.

• Kuruluş ölçeğinde API yönetişimi: Özel stil kılavuzları, Spectral kural setleri, yüzlerce spesifikasyon ve çok sayıda ekip arasında standardizasyon raporları gerekiyorsa SwaggerHub'ın Kurumsal katmanları bu kullanım için tasarlanmıştır.
• Pact tabanlı sözleşme testi: Mikro hizmet ekipleri arasında Pact iş akışı kritikse, Sözleşme Testi modülü önemli bir farklılaştırıcıdır.
• Ağ geçidi senkronizasyonu: Spesifikasyonlarınızın dağıtım sürecinde AWS API Gateway, Azure API Management veya Apigee ile çift yönlü senkronize olması gerekiyorsa SwaggerHub entegrasyonları daha olgundur.

Geçiş; ekibiniz API'leri ağırlıklı olarak tasarlıyor, test ediyor, belgeliyor ve mock'lıyorsa anlamlıdır. Buna karşılık günlük işler için ölçülü yürütmeler, markalı portal ve eklenti maliyetleri platform yönetişimi fiyatları oluşturuyorsa alternatif değerlendirmek gerekir.

Tasarım odaklı araçları karşılaştırıyorsanız, Stoplight artık SmartBear çatısı altında olduğu için Stoplight karşılaştırmamızı da inceleyin.

Sıkça sorulan sorular

SwaggerHub şimdi ne kadar?

Yeniden başlatılan Swagger platformunda Bireysel plan kullanıcı başına aylık 22,80 dolardan başlar. Ekip planı 34,44 dolar, Kurumsal plan 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çtüğü alanlarda gerçekten sınırsız mı?

Evet. API'ler, istekler, test çalıştırmaları ve zamanlanmış yürütmeler; ücretsiz katman dahil tüm Apidog planlarında sınırsızdır.

SwaggerHub, Enterprise Plus altında test yürütmelerini ayda 50 ila 100 arasında ölçer ve alt katmanlarda API sayısını 10 ila 50 ile sınırlar.

SwaggerHub spesifikasyonlarımı Apidog'a aktarabilir miyim?

Evet. Spesifikasyonunuzu OpenAPI YAML veya JSON olarak dışa aktarın ve doğrudan içe aktarın.

Şemalar, endpoint'ler, örnekler ve açıklamalar aktarılır. Paylaşılan Domains kullanıyorsanız, dışa aktarma sırasında bunların spesifikasyonda çözümlenmiş olması gerekir.

Apidog, SwaggerHub gibi önce spesifikasyon odaklı tasarımı destekliyor mu?

Evet. Apidog, OpenAPI için görsel ve kod düzenleyicileri ile dal tabanlı inceleme sunar. Spesifikasyon, belgeleri, mock'ları ve testleri otomatik olarak yönlendirir.

Kuruluş genelinde özel linting kural setleri sunmaması ise SwaggerHub'ın yönetişim avantajı olarak kalır.

SwaggerHub'ın API ağ geçidi entegrasyonları ne durumda?

Apidog, spesifikasyonları AWS, Azure veya Apigee ağ geçitlerine yerel olarak aktarmaz. Ağ geçidi senkronizasyonu kesin bir gereksinimse, geçiş yapmadan önce bu iş akışını değerlendirin.

Her iki tarafta da OpenAPI üzerinden dışa ve içe aktarma yapılabilir.

Spesifikasyonu tasarlayın, sonra çalıştırın

SwaggerHub'dan bir spesifikasyonu içe aktarın ve tek tanımdan neler üretebildiğinizi doğrulayın:

• Kendi alan adınızdaki belgeler
• Gerçekçi veriler üreten mock sunucu
• Zamanlanabilir test senaryoları
• CI/CD içinde çalıştırılabilir API testleri

Apidog'u indirin. 4 kişilik ekipler ücretsiz değerlendirme yapabilir; diğer ekipler için kullanıcı başına maliyet, 34,44 $ artı eklentilere karşı 9 $'dır.