API çalışma alanınız bir GUI'de yaşar. İş gününüz bir terminalde geçer. İkisi arasındaki her bağlam değişikliği saniyelere ve odaklanmaya mal olur ve bir CI hattında veya bir yapay zeka ajanı oturumunda GUI bir seçenek bile değildir. Apidog CLI bu boşluğu kapatır: tüm Apidog platformunu, testleri, uç noktaları, şemaları, ortamları, sahte beklentileri ve belgeleri, zaten açık olan kabuk istemcinize getirir.
Her şeyden önce dürüst bir tanım. Apidog CLI başka bir curl değildir. Tek seferlik bir GET isteği göndermek ve JSON'a göz gezdirmek isterseniz, curl ve HTTPie bunu zaten iyi yapar ve terminal ve TUI REST istemcileri incelemesi interaktif tarafı kapsar. Apidog CLI, API çalışma alanınızın kendisi için bir istemcidir: oluşturduğunuz test senaryolarını çalıştırır, API sözleşmesini okur ve günceller, ve proje içinde ve dışında spesifikasyonları taşır, tüm bunları bir betik veya ajan tarafından çağrılabilecek komutlarla yapar.
Burada "terminalinizde yaşamak" ne anlama geliyor
Terminal HTTP araçları her seferinde tek bir isteği işler. Apidog CLI proje düzeyinde çalışır. Komut yüzeyi kırktan fazla grubu kapsar ve bunlar beş işte kümelenir:
| Görev | Komutlar |
|---|---|
| Testleri çalıştır | run, test-scenario, test-suite, test-case, test-data, test-report |
| Sözleşmeyi yönet | endpoint, schema, folder, common-parameter, response-component, security-scheme |
| Belgeleri ve sahteleri gönder | doc, docs-site, shared-doc, mock |
| Yapılandır ve bağlan | environment, variables, vault, database-connection, websocket, socketio |
| Ekip olarak çalış | branch, merge-request, runner, scheduled-task, audit-log, import, export |
Her komut `--help` desteğine sahiptir, çıktı yapılandırılmış JSON'dur ve çoğu yanıt, size (veya ajanıza) sonra ne çalıştıracağınızı söyleyen `agentHints.nextSteps` içerir. Bu son ayrıntı küçük görünüyor. Aracın hissini değiştiriyor: CLI, ezberlediğinizi varsaymak yerine iş akışını yönlendirir.
Tek komutla kurun
CLI, bir npm paketi (apidog-cli) olarak gönderilir ve macOS, Linux ve Windows'ta çalışır. Node.js 16 veya sonraki bir sürümünü gerektirir.
npm install -g apidog-cli
apidog --version
Ardından bir API erişim belirteciyle oturum açın. Bunu Apidog uygulamasından alın: avatarınıza tıklayın, Hesap Ayarları'nı açın ve API Erişim Belirteci altındaki belirteci kopyalayın.
apidog login --with-token <BELİRTECİNİZ>
Belirteç `~/.apidog/config.toml` dosyasına kaydedilir, bu nedenle onu depolarınızdan ve günlüklerinizden uzak tutun; CI'da, bunun yerine bir sır olarak `--access-token` ile her çalıştırmada iletin. Dört global bayrak çoğu bağlamı kapsar: `--project` projeyi seçer, `--branch` dalı seçer, `--access-token` kaydedilen oturum açmayı geçersiz kılar ve `--api-base-url` CLI'yi kendi kendine barındırılan bir Apidog dağıtımına yönlendirir. Apidog CLI kimlik doğrulama kılavuzu, CI için belirteçleri ayrıntılı olarak açıklar.
Görsel olarak oluşturduğunuz testleri çalıştırın
İşte CLI'ın etrafında inşa edildiği iş akışı. Apidog'un görsel düzenleyicisinde bir test senaryosu oluşturursunuz: zincirleme istekler, bir yanıttan çıkarılan ve bir sonrakine enjekte edilen değişkenler, durum ve gövde üzerindeki iddialar. Ardından, bir kabuk bulunan herhangi bir yerde çalıştırırsınız.
# Bu komutu, kimlikler dahil, senaryonun CI/CD sekmesinden kopyalayın
apidog run -t <senaryo_kimliği> -e <ortam_kimliği> -r cli
Her onay geçtiğinde komut `0` ile çıkar ve herhangi bir şey başarısız olduğunda sıfır olmayan bir değerle çıkar, bu nedenle bir işlem hattı ek bir bağlantıya gerek kalmadan buna dayanır. Aynı senaryoyu geliştirme, hazırlık veya üretim ortamlarına yönlendirmek için `-e` değerini değiştirin. Ona bir CSV veya JSON dosyası besleyin ve senaryoyu her satır üzerinde tekrarlar, bu da veri odaklı testin adımları kopyalamadan nasıl çalıştığıdır. Sıfırdan başlıyorsanız, adım adım REST API kılavuzu kurulumdan ilk başarılı çalıştırmaya kadar götürür.
Raporlar dört biçimde çıkar: `cli` adım adım sonuçları terminale yazdırır, `html`, `json` ve `junit` ise panolar ve CI yapıtları için `apidog-reports/` dizinine düşer. Onları `-r cli,junit` örneğindeki gibi serbestçe birleştirebilirsiniz. Test raporları kılavuzu her formatın neye benzediğini gösterir.
Dizüstü bilgisayarınıza bağlı olmaması gereken çalıştırmalar için, `runner` ve `scheduled-task` komutları, Apidog'daki planlanmış API testlerinin arkasındaki aynı mekanizma olan kendi kendine barındırılan çalıştırıcıları ve zamanlanmış yürütmeleri yönetir.
Uygulamayı açmadan API sözleşmesini yönetin
Bu, başka hiçbir terminal test aracının sunmadığı bir özelliktir. Testlerinizi çalıştıran aynı CLI, API tanımının kendisini okuyabilir ve yazabilir:
apidog endpoint list --project <proje_kimliği>
apidog schema get <şema_kimliği>
apidog environment list
apidog mock list
Uç noktalar, veri şemaları, klasörler, ortamlar, değişkenler, güvenlik şemaları ve yeniden kullanılabilir bileşenlerin tümü sorgulanabilir ve düzenlenebilir. `mock` komutu, sahte sunucunuzun döndürdüğü sabit istek-yanıt çiftleri olan sahte beklentileri yönetir. `doc` ve `docs-site` komutları yayınlanmış belgelere dokunur. WebSocket ve Socket.IO uç noktaları kendi gruplarına sahiptir ve `database-connection`, test senaryolarınızın okuduğu veritabanı yapılandırmalarını kapsar.
İçe ve dışa aktarma, önemli formatları destekler: OpenAPI 3.x ve Swagger 2.0 (çoğu araç zincirinin standartlaştırdığı spesifikasyon) artı Postman koleksiyonları. Bu, CLI'yi geçiş betiklerinde bir köprü haline getirir: bir spesifikasyonu bir sistemden çekin, Apidog'a itin ve tüm alışverişi sürümleyin.
apidog import openapi.json --project <proje_kimliği>
apidog export --format openapi
Yapay Zeka ajanlarının kullanabileceği şekilde tasarlandı
CLI'nin 2026 sürümleri tek bir fikre güçlü bir şekilde odaklanıyor: bir yapay zeka kodlama aracısı, API çalışma alanınızı bir insan kadar güvenli bir şekilde işletebilmelidir. Dört parça bunu sağlar.
Birincisi, yapılandırılmış çıktı. Her komut, bir ajanın ayrıştırabileceği JSON döndürür ve `agentHints.nextSteps`, hatalardan nasıl kurtulacağı da dahil olmak üzere her sonuçtan sonra ne yapacağını ona söyler.
İkincisi, yayınlanmış bir giriş şeması. `apidog cli-schema list` ve `apidog cli-schema get`, her yazma komutunun beklediği kesin JSON şeklini ortaya çıkarır ve `apidog cli-schema validate` herhangi bir şey projeye dokunmadan önce bir yükü kontrol eder. Güvenli yazma ritüeli her zaman aynıdır: şemayı alın, JSON'u oluşturun, doğrulayın ve ancak ondan sonra `create` veya `update` komutunu çalıştırın.
Üçüncüsü, paketlenmiş bir beceri. `skill` komutu, CLI'nin çalışma bilgisini ajanların doğrudan yüklediği bir biçimde gönderir, bu da Apidog CLI becerisini neden oluşturduğumuzun arkasındaki hikayedir. Kendi ölçümlerimizde, CLI şeması üzerinden çalışan ajanlar, yükleri tahmin eden ajanlara göre yaklaşık %30 daha az araç çağrısı ve %25 daha az jeton kullandı; sayılar bu analizde ayrıntılı olarak açıklanmıştır.
Dördüncüsü, izin kapıları. Varsayılan olarak, yapay zeka kaynaklı bir dalla yazmalar, bir insan Harici Yapay Zeka Düzenleme İzinlerini etkinleştirene kadar (Apidog istemcisi 2.8.32 veya üzeri sürümlerde, Proje Ayarları, Özellik Ayarları, Yapay Zeka Özellik Ayarları altında) engellenir. Alternatif olarak bir yapay zeka dalı vardır: bir ajanın ihtiyaç duyduğu kaynakları içe aktardığı, düzenlemelerini yaptığı ve sonucu inceleme için bir birleştirme isteği olarak geri verdiği yalıtılmış bir dal. Dokunulmamış yapay zeka dalları 24 saat sonra otomatik olarak arşivlenir, böylece deneyler birikmez. Bir ajan ilk taslağı yazsa bile API sözleşmeniz incelenebilir kalır.
Apidog CLI ne değildir
Üç sınır, açıkça belirtilmiştir, çünkü dürüst bilgilere dayanarak araç seçmek, boşlukları daha sonra keşfetmekten iyidir.
Etkileşimli bir istek istemcisi değildir. Ad-hoc bir POST yazan ve yanıtı güzelce yazdıran bir komut yoktur; curl, HTTPie ve TUI istemcileri bu işe sahiptir ve bu işte daha iyidirler.
Açık kaynak değildir. Paket tescillidir, npm tek kurulum kanalıdır ve `--help` dışındaki herhangi bir şeyi yapmak bir Apidog hesabı gerektirir. Ücretsiz katman burada açıklanan tüm iş akışını kapsar, ancak denetlenebilir bir lisans katı bir gereklilikse, açık kaynak bir çalıştırıcı dürüst bir öneridir.
Bağımsız değildir. CLI, platformun terminal koludur: senaryolar, uç noktalar ve ortamlar yerel dosyalarda değil, Apidog projenizde yaşar. Bu, tasarım, test, sahteler ve belgeler arasında tek bir doğru kaynak elde etmenizi sağlayan bir takastır.
Terminal araç kutusunda nereye oturuyor
Diğer çalıştırıcılara karşı, fark yazma işleminin nerede gerçekleştiğidir. Newman ve Postman CLI, Postman'da yazılmış koleksiyonları çalıştırır; Hurl ve Bruno metin dosyaları olarak yazılmış testleri çalıştırır; Apidog CLI ise sözleşmenizi, sahtelerinizi ve belgelerinizi de barındıran görsel bir düzenleyicide yazılmış senaryoları çalıştırır. Apidog CLI vs Newman karşılaştırması daha derine iner ve tüm alan en iyi terminal tabanlı API test araçları derlemesinde sıralanır.
Çoğu ekip için çalışan bir kurulum: yoklamalar için curl veya xh'yi kas hafızasında tutun ve `apidog run`'ın CI'daki paketleri taşımasına izin verin. GitHub Actions kılavuzunda başlangıç için kopyala-yapıştır bir boru hattı bulunur.
SSS
Apidog CLI'yı kullanmak ücretsiz mi? Evet. Paket npm'den ücretsiz olarak kurulur ve Apidog'un ücretsiz katmanı senaryo oluşturmayı ve bunları CLI aracılığıyla çalıştırmayı kapsar. Ücretli planlar temel CLI erişimi değil, ekip ölçekli özellikler ekler.
curl veya HTTPie'nin yerini mi alıyor? Hayır ve bunu denemez. Bu araçlar özel istekler gönderir; Apidog CLI kayıtlı test senaryolarını çalıştırır ve proje kaynaklarını yönetir. Çoğu terminalde ikisi de bulunur.
CI'da tamamen başsız çalışabilir mi? Evet. Bir CI sırrından `--access-token` ile kimlik doğrulayın, senaryo kimliğinizle `apidog run` komutunu çalıştırın ve derlemeyi çıkış koduna göre kontrol edin. Çalıştırıcıda hiçbir masaüstü uygulamasına gerek yoktur.
Hangi formatları içe ve dışa aktarabilir? OpenAPI 3.x, Swagger 2.0 ve Postman koleksiyonlarını her iki yönde de. Bu, içe göçleri ve dışa entegrasyonları kapsar.
Yapay zeka ajanları bunu güvenli bir şekilde nasıl kullanır? Şema-doğrula-yazma ritüeli ve izin kapıları aracılığıyla: `cli-schema validate`, hatalı yükleri varmadan önce yakalar ve yapay zeka dalları, ajan düzenlemelerini bir insan birleştirene kadar izole tutar. Claude Code'da Apidog CLI'yı nasıl kullanacağınızı anlatan makalede bir ajanın içinde çalıştığını görebilirsiniz.
Terminal, testlerinizin zaten çalıştığı ve ajanlarınızın zaten çalıştığı yerdir. API istemcisini de oraya koymak, son bağlam geçişini ortadan kaldırır. Apidog'u indirin, CLI'yı npm'den kurun ve bir senaryoyu uçtan uca çalıştırın; `run` komutunun ötesine geçmeye hazır olduğunuzda Apidog CLI sayfasında tam komut referansı bulunur.