Bump.sh vs Scalar

Bump.sh, CEO Sébastien Charrier liderliğindeki küçük ve tamamen uzaktan çalışan bir Fransız ekibin barındırılan API dokümantasyon platformu. OpenAPI ve AsyncAPI tanımlarını repodan alıp hızlı referans dokümanlara çeviriyor, her yeni sürümü öncekiyle karşılaştırarak breaking change'leri işaretliyor ve changelog'u otomatik üretiyor. API sözleşmesini tek doğru kaynak kabul eden ekipler için docs-as-code yaklaşımı sunuyor.

Her commit veya pull request, CLI ya da GitHub Action ile dokümanı yayınlayabiliyor veya önizleme oluşturabiliyor; API hub'ları birden fazla API'yi özel alan adlı tek portalda topluyor. Pro planı branch yönetimi, API Explorer, sürüm geri alma ve otomatik changelog ekliyor. Ücretsiz plan yok: Basic 10 doküman için aylık 50 dolar, Pro 30 doküman için aylık 120 dolar ve 14 gün deneme içeriyor; Custom ise SSO, embed modu ve yüzde 99,99 SLA sunuyor. Açık kaynak projeler ücretsiz Pro erişimi isteyebiliyor.

Bump.sh, çok sayıda iç veya herkese açık API yayınlayan platform ekiplerine, özellikle olay tabanlı mimarilere uygun; AsyncAPI desteği birinci sınıf. Uzun rehberler ve pazarlama odaklı portallar için zayıf. Anlatı tipi dokümanda ReadMe ve Mintlify daha güçlü, Redocly benzer OpenAPI araçlarını daha fazla linting ve self-host seçeneğiyle sunuyor, Stoplight design-first düzenlemeye odaklanıyor.

En önemli yenilik, yakın zamanda sunulan yönetilen MCP platformu: Bump.sh artık API tanımlarından ve Arazzo iş akışı dosyalarından MCP sunucuları üretip kimlik doğrulama ve izlemeyle barındırıyor; böylece AI ajanları API'nizi güvenle çağırabiliyor. Basic planda yalnızca beş MCP aracı olduğunu unutmayın. Fiyatlar dolar bazlı.

Scalar, OpenAPI standardı etrafında kurulmuş, API dokümantasyonu ve testi için açık kaynak bir platform. En bilinen ürünü Scalar API Reference: bir OpenAPI veya Swagger dosyasından üretilen modern, etkileşimli bir referans sayfası. Yerleşik API istemcisi sayesinde okuyucular curl komutu kopyalamak yerine gerçek istekleri doğrudan dokümandan gönderebilir.

Referans sayfası tek bir script etiketiyle ya da ASP.NET Core, FastAPI, Express, NestJS, Hono ve Laravel gibi çatılar için hazır entegrasyonlarla projeye eklenebilir; bu yüzden Swagger UI'ın modern bir yerine sıkça tercih ediliyor. Microsoft'un ASP.NET Core dokümantasyonu, .NET 9 ile Swashbuckle varsayılan şablondan çıkarıldıktan sonra OpenAPI belgelerini göstermenin yollarından biri olarak Scalar'ı listeliyor. Scalar API Client, uç noktaları test etmek için Postman'e benzer bağımsız bir uygulama olarak da kullanılabilir. Açık kaynak araçların üzerine Scalar, özel alan adı, tema ve ekip özellikleriyle API referansı ve rehber yayınlamak için ücretli bir barındırma platformu sunar.

Scalar, minimum kurulumla ve lisans maliyeti olmadan şık API referansları isteyen geliştiricilere ve startup'lara uyar. Türkiye'de .NET ve Node.js ile API geliştiren ekipler için Swagger UI'dan geçiş birkaç satırlık iş. Köklü oyunculara göre daha genç; analitik, erişim kontrolü ve gelir modeli gibi kurumsal geliştirici portalı özellikleri hâlâ gelişiyor ve topluluk daha küçük. Swagger UI ve Redoc klasik ücretsiz görüntüleyiciler, Mintlify ve ReadMe tam kapsamlı barındırılan dokümantasyon platformları, Postman ise baskın API istemcisi.