API Yönetimi İçin En İyi Hafif CLI Araçları

API yönetimi çoğu zaman güçlü bir kontrol düzlemi gerektirir: gösterge paneli, veritabanı, Kubernetes pod’ları ve günlük olarak kontrol edilen bir giriş sayfası. Ancak yapılandırmayı senkronize etmek, ortamlar arasında değişiklikleri taşımak, rotaları bağlamak, sahte sunucuları veya belirtimleri güncel tutmak gibi günlük işler betiklenebilir. Bu işler betiklenebildiğinde, küçük bir CLI genellikle tarayıcı sekmesinden daha hızlı ve tekrarlanabilir olur.

Apidog'u bugün deneyin

Bu yazıda, tam bir platformu dizüstü bilgisayarınıza kurmadan gerçek API yönetimi işleri yapabileceğiniz hafif komut satırı araçlarını ele alacağız. Çoğu, PATH içine ekleyebileceğiniz tek bir Go ikili dosyası veya tek seferlik bir npm paketidir. Hızlı başlar, denemek için az yapılandırma ister ve CI süreçlerine kolayca eklenir.

Tam bir kontrol düzlemi seçiyorsanız, 2026 için en iyi API yönetimi araçları rehberine ve daha geniş API yönetimi genel bakışına göz atın. Bu yazının odağı daha dar: bir dakika içinde kurabileceğiniz, terminal öncelikli araçlar.

“API yönetimi” iki farklı anlama gelebilir:

• Ağ geçidi/platform yönetimi: Yönlendirme, kimlik doğrulama, hız limitleri, kotalar ve üretim trafiğinin önündeki katman. Örnekler: Kong, Tyk, Apigee, KrakenD.
• API projesi yönetimi: Belirtimler, uç noktalar, ortamlar, değişkenler, mock’lar ve belgeler. Bunlar API’nin yaşam döngüsünü oluşturan kaynaklardır.

Aşağıdaki CLI’lar bu iki kapsamı da içerir. Araç seçerken önce hangi problemi çözdüğünüzü belirleyin: trafik katmanını mı, API projesini mi yönetiyorsunuz?

Her araç için şunları göreceksiniz:

1. Kurulum komutu
2. Çalıştığını doğrulayan ilk komut
3. CI kullanımına yönelik pratik not
4. Aracın kapsamı ve sınırları

Bir CLI aracını API yönetimi için “hafif” yapan nedir?

Hafif olmak, yetersiz olmak demek değildir. Bu listedeki bir araç şu özellikleri taşımalıdır:

• Tek bir ikili dosya veya paket olarak gelir. Örneğin curl ile indirilen bir Go ikili dosyası ya da global npm kurulumu.
• Yerelde hızlı başlar. Bir yapılandırma dosyası veya OpenAPI belirtimi üzerinde çalıştırıp saniyeler içinde sonuç alabilirsiniz.
• Az yapılandırmayla ilk değerini üretir. İlk yararlı komut için yüzlerce satır YAML yazmanız gerekmez.
• CI ile uyumludur. Anlamlı çıkış kodları, check, validate veya dry-run gibi doğrulama modları ve makine tarafından işlenebilir çıktı sunar.

Buradaki araçların tamamı terminal önceliklidir. Bazılarının arkasında ticari bir bulut hizmeti bulunabilir; ancak CLI’lerin kendisi küçük, hızlı ve belirli bir işi otomatikleştirmeye odaklıdır.

decK: Kong Ağ Geçidi için bildirimsel yapılandırma

decK, Kong’un bildirimsel yapılandırma aracıdır. Kong Gateway’deki hizmetleri, rotaları, eklentileri ve tüketicileri YAML olarak dışa aktarabilir; bu dosyayı Git’te yönetip tekrar ağ geçidine senkronize edebilirsiniz.

Bu yaklaşım özellikle Kong için GitOps uygulamak isteyen ekipler için uygundur. Ayrıca canlı ağ geçidindeki yapılandırma ile Git’teki dosya arasındaki farkı tespit ederek drift detection sağlar.

macOS üzerinde Homebrew ile kurun:

brew install kong/deck/deck

Önce canlı Kong yapılandırması ile dosyanız arasındaki farkı kontrol edin:

deck gateway diff kong.yaml

Değişiklikler beklediğiniz gibiyse senkronize edin:

deck gateway sync kong.yaml

CI örneği

Pipeline içinde önce farkları denetleyip ardından senkronizasyon yapabilirsiniz:

deck gateway diff kong.yaml
deck gateway sync kong.yaml

En iyi olduğu yer: Kong için GitOps, yapılandırma senkronizasyonu ve drift tespiti.

Dürüst sınır: Yalnızca Kong’u yönetir. Genel amaçlı bir API proje yönetim aracı değildir. Kong, daha geniş geliştirici CLI ihtiyaçları için kongctl aracını da ayırmıştır; kullandığınız Kong sürümü için uygun aracı kontrol edin.

Tyk CLI: Tyk ağ geçidi eklentilerini paketleyin

Tyk açık kaynaklı bir API ağ geçididir. Komut satırı kullanımının önemli bir bölümü, özellikle özel middleware eklentilerinin paketlenmesine odaklanır.

Go, Python veya JavaScript ile özel bir eklenti yazdıysanız, bunu Tyk Gateway’in yükleyebileceği imzalı bir pakete dönüştürebilirsiniz.

Tyk Gateway v2.8’den itibaren paketleyici, ağ geçidi ikili dosyasına dahildir. Ayrı bir tyk-cli yüklemeniz gerekmez:

tyk bundle build -output bundle.zip

Oluşan paketi dağıtım sürecinize dahil edebilir ve gateway çalışma zamanında yükleyebilirsiniz.

En iyi olduğu yer: Kendi barındırdığınız Tyk Gateway için eklenti paketleme ve terminalden yapılandırma otomasyonu.

Dürüst sınır: CLI yüzeyi decK kadar geniş değildir. Tyk yönetiminin önemli bölümü hâlâ Dashboard API veya Gateway API üzerinden yapılır. Tyk altyapısını zaten çalıştırdığınızı varsayar.

apigeecli: Google Apigee’yi terminalden otomatikleştirin

apigeecli, Google Apigee için resmi komut satırı aracıdır. API proxy’lerini, API ürünlerini, ortamları, geliştiricileri ve uygulamaları script veya pipeline üzerinden yönetmenizi sağlar.

Kurulumu resmi betikle yapın:

curl -L https://raw.githubusercontent.com/apigee/apigeecli/main/downloadLatest.sh | sh -

Ardından Google Cloud erişim belirteci oluşturup kuruluşları listeleyin:

token=$(gcloud auth print-access-token)
apigeecli organizations list -t "$token"

Proxy import ve dağıtım süreçlerini CI içine taşıyarak konsola bağımlılığı azaltabilirsiniz.

apigeecli apis create bundle -n my-api -f ./proxy-bundle.zip -t "$token"

En iyi olduğu yer: Apigee proxy’lerini otomatikleştirme, API paketlerini içe aktarma ve dağıtma, Apigee işlemlerini CI/CD’ye bağlama.

Dürüst sınır: Yalnızca Apigee içindir ve Google Cloud kimlik doğrulaması gerektirir. Apigee kullanmıyorsanız bu araç sizin için değer üretmez.

KrakenD: Dosya tabanlı, durumsuz API ağ geçidi

KrakenD, Go ile yazılmış durumsuz bir API ağ geçididir. Yönetim modeli diğer ağ geçitlerinden farklıdır: veritabanı veya yönetim arayüzü yerine, ağ geçidinin durumu yapılandırma dosyasının kendisidir.

Bu nedenle KrakenD yönetimi çoğunlukla şu akıştan oluşur:

1. Yapılandırmayı Git’te tutun.
2. Değişiklikleri PR üzerinden inceleyin.
3. CI içinde yapılandırmayı doğrulayın.
4. Başarılı yapılandırmayı dağıtın.

Bir yapılandırmayı deploy etmeden önce doğrulayın:

krakend check -c krakend.json --lint

Daha büyük projelerde esnek yapılandırma özelliğiyle şablonlar ve ortam bazlı parçalar kullanabilirsiniz:

FC_ENABLE=1 FC_SETTINGS="config/prod" krakend check -c krakend.tmpl

Bu komutu CI aşamasında çalıştırmak, hatalı gateway yapılandırmalarının üretime ulaşmasını engeller.

En iyi olduğu yer: Ağ geçidi yapılandırmasını tamamen dosyalarla ve kod olarak yönetmek isteyen ekipler.

Dürüst sınır: Tasarımı gereği durumsuzdur. Yerleşik geliştirici portalı veya yönetilecek çalışma zamanı durumu yoktur. SSO ve denetim kaydı gibi bazı özellikler yalnızca Enterprise sürümündedir.

Speakeasy: API istemci SDK’larını yönetin

Speakeasy, API yönetimine tüketici tarafındaki yapıtlar üzerinden yaklaşır. Tek bir OpenAPI belirtiminden tür güvenli SDK’lar, Terraform provider’ları ve sözleşme testleri üretebilir.

API belirtiminiz değiştiğinde istemci SDK’larını yeniden üretmek istiyorsanız, bu süreci CI içinde otomatikleştirebilirsiniz.

Kurulum:

brew install speakeasy-api/tap/speakeasy

Etkileşimli başlangıç akışını çalıştırın:

speakeasy quickstart

Kurulumdan sonra belirtilen akışı çalıştırmak için:

speakeasy run

Bu komut belirtimi doğrular, SDK’ları oluşturur ve derler. CI pipeline’ında OpenAPI değişikliği olduğunda çalıştırmak için uygundur.

En iyi olduğu yer: OpenAPI belirtiminden bakımı yapılabilir istemci SDK’ları üretmek ve sürümlemek.

Dürüst sınır: Ağ geçidini veya çalışma zamanı trafiğini yönetmez. İstemci tarafındaki çıktıların yönetimine odaklanır; temel kullanımın ötesindeki çok dilli üretim özellikleri ücretli katmanlarda bulunabilir.

apidog-cli: API projesini, ortamları ve belirtimleri yönetin

Yukarıdaki araçlar ağırlıklı olarak ağ geçitlerini veya istemci SDK’larını yönetir. apidog-cli ise API projesinin kendisine odaklanır: API tasarımı, ortamlar, değişkenler, uç noktalar, şemalar, mock’lar, testler ve belgeler.

Apidog için komut satırı eşlikçisidir ve global npm paketi olarak kurulur:

npm install -g apidog-cli

Token ile oturum açın ve projelerinizi listeleyin:

apidog login --with-token <YOUR_TOKEN>
apidog project list

API proje kaynaklarını komut grupları üzerinden yönetebilirsiniz:

apidog environment
apidog variables
apidog endpoint
apidog schema

Bu komut gruplarıyla şunları otomatikleştirebilirsiniz:

• Ortamları ve ortam değişkenlerini yönetmek
• Uç noktaları ve veri modellerini güncellemek
• OpenAPI, Postman, Markdown veya HTML içe/dışa aktarmak
• Mock, dokümantasyon ve test senaryolarını çalıştırmak

Örneğin bir CI job’ında API çıktısını dışa aktarmak için:

apidog export

CLI çıktısı, agentHints.nextSteps içeren yapılandırılmış JSON üretebilir. Bu yapı, komutların betiklerden veya yapay zeka ajanlarından yönlendirilmesini kolaylaştırır. Ayrıntılar için yapay zeka ajanlarınızdan ayrılmadan API’leri nasıl yöneteceğinizi inceleyin.

En iyi olduğu yer: API projesini, ortamları, değişkenleri, uç noktaları ve belirtimleri tek bir terminal aracıyla yönetmek.

Dürüst sınır: Apidog bir API ağ geçidi değildir; Kong veya Apigee’nin trafik katmanının yerini almaz. Açık kaynak değildir ve ücretsiz katmanı olan ticari bir üründür. Ancak tasarım, mock, test ve dokümantasyon işlerini aynı CLI üzerinden yönetmenizi sağlar. Başsız kullanım senaryoları için başsız API yönetimi aracı incelemesine bakın.

Nasıl seçilir?

En hızlı filtre kapsamdır:

• Üretim trafiğini, yönlendirmeyi ve politikaları mı yönetiyorsunuz?
• Yoksa API tasarımını, ortamları, belirtimleri ve yaşam döngüsünü mü yönetiyorsunuz?

Araç	En iyi olduğu yer	Kurulum	Açık kaynak mı?	Kapsam
deck (Kong)	Kong için GitOps + kayma tespiti	brew install kong/deck/deck	Evet (Apache 2.0)	Ağ geçidi (Kong)
Tyk CLI	Bir Tyk ağ geçidi için eklentileri paketleme	tyk ikili dosyasına yerleşik (v2.8+)	Evet (MPL)	Ağ geçidi (Tyk)
apigeecli	Google Apigee'yi otomatikleştirme	curl .../downloadLatest.sh | sh -	Evet (Apache 2.0)	Ağ geçidi (Apigee)
KrakenD	Kod olarak yapılandırma durumsuz ağ geçidi	İkili / Docker	Evet (CE, Apache 2.0)	Ağ geçidi (herhangi)
Speakeasy	İstemci SDK'ları oluşturma + sürümleme	brew install speakeasy-api/tap/speakeasy	CLI evet (Apache 2.0)	İstemci/SDK tarafı
apidog-cli	API projesini, ortamları, belirtimleri yönetme	npm install -g apidog-cli	Hayır (ücretsiz katman)	Proje/yaşam döngüsü

Pratik seçim rehberi:

• Kong kullanıyorsanız: decK kullanın.
• Apigee kullanıyorsanız: apigeecli kullanın.
• Tyk kullanıyorsanız: Eklenti paketleme için yerleşik tyk bundle komutlarını kullanın.
• Dosya tabanlı, stateless bir gateway istiyorsanız: KrakenD uygun bir model sunar.
• Sorununuz istemci SDK’larıysa: Speakeasy kullanın.
• API tasarımı, ortamlar ve değişkenler günlük işinizse: apidog-cli bu kaynakları tek araçta toplar.

Birçok ekip hem gateway CLI’sı hem de proje CLI’sı kullanır. Bunun nedeni, “API yönetimi” ifadesinin farklı katmanları kapsamasıdır. Açık kaynak zorunluysa, açık kaynak API yönetimi araçları derlemesi lisanslar ve kendi kendine barındırma seçenekleri hakkında daha fazla ayrıntı sunar.

Hafif çözüm özeti

API yönetimi için tarayıcıda sürekli açık bir kontrol düzlemine ihtiyacınız yoktur.

• Gateway CLI’ları yönlendirme ve politikaları Git tabanlı iş akışlarına taşır.
• SDK CLI’ları istemci kütüphanelerini OpenAPI belirtimiyle senkronize tutar.
• Proje CLI’ları uç noktaları, ortamları ve değişkenleri betiklenebilir hale getirir.

Günlük işiniz API projesi tarafındaysa; tasarım, mock, test ve dokümantasyonu birlikte yönetmek istiyorsanız Apidog bu iş akışlarını birleştirir. Platformu denemek için Apidog’u indirin, ardından CI veya ajan iş akışlarında otomasyon gerektiğinde apidog-cli kullanın.

Tek bir ikili dosya veya paketle başlayın, doğrulamayı pipeline’ınıza ekleyin ve ihtiyaç duydukça otomasyonu genişletin.