Apidog 2.8.47–2.8.50 boyunca, bu ayki güncellemeler, API otomasyonunu, depo entegrasyonunu ve API dokümantasyonunu sürdürmeyi kolaylaştırıyor—modüler CLI içe aktarmalarından ve hata ayıklama durumu oluşturmadan Bitbucket Cloud'a, kendi kendine barındırılan GitLab bağlantılarına ve Doküman alt sitelerinden yayımlanan şemalara kadar.
Bu sürüm, otomasyonu ve Git işbirliğini daha az zahmetli bir kurulum süreci haline getirmekle ilgilidir.
Eylül ayının Apidog güncellemeleri, ekiplerin sıkça zaman kaybettiği noktalara odaklanıyor: büyük proje yapılarını betiklerden veya yapay zeka iş akışlarından yönetmek, API varlıklarını doğru modüle aktarmak, terminalden ayrılmadan test varlıkları oluşturmak ve ekiplerin zaten çalıştığı şekli değiştirmeden mevcut Git sağlayıcılarını bağlamak.
Bir bakışta:
- Apidog CLI otomasyonu: proje modüllerini yönetin, modüle göre çok formatlı API verilerini içe aktarın ve yapılandırma dosyalarından hata ayıklama test durumları oluşturun.
- Git depo entegrasyonları: Bitbucket Cloud ve GitLab On-Prem bağlantılarını proje içe/dışa aktarma iş akışlarına ekleyin.
- Günlük kullanılabilirlik: daha net URL işleme, daha iyi test raporu filtreleme, test verisi değişkeni tamamlama ve daha hızlı proje listesi.
- Belgeler ve performans görünürlüğü: Belge alt siteleri şemaları yayınlar ve performans testleri P95 ve P99 yanıt sürelerini raporlar.
🤖 API Otomasyonu ve Yapay Zeka İş Akışları için Apidog CLI
Apidog CLI, CI test çalışmaları ve otomasyon için zaten faydalı bir giriş noktası haline gelmişti. Bu sürüm, onu iş akışında daha erkene taşıyor: ekipler, proje yapısını yönetebilir, verileri doğru modüle getirebilir ve testleri çalıştırmadan önce hata ayıklama durumları oluşturabilir.
CLI'dan proje modüllerini yönetme
Apidog CLI artık proje modüllerini sorgulayabilir, oluşturabilir, güncelleyebilir ve silebilir.
Bu, modül yapısının otomatik bir iş akışının parçası olarak değişmesi gerektiğinde faydalıdır. Bir yazma işleminden sonra, CLI, moduleId içeren yapılandırılmış JSON döndürür, böylece betikler ve aracılar, tanımlayıcıyı daha sonraki içe aktarma, test veya bakım adımlarına geçirebilir; bunu kullanıcı arayüzünden kopyalamayı istemeye gerek kalmaz.
Bu, modül yönetimini API testi ve CI otomasyonu ile aynı tekrarlanabilir döngünün bir parçası yapar.
API verilerini seçilen bir modüle aktarma
CLI içe aktarma komutu, Apidog istemcisinin ayrıştırma yeteneklerini yeniden kullanmak üzere yeniden düzenlendi. Desteklenen kaynaklardan API verilerini, önce kullanıcı arayüzünde oluşturup daha sonra taşımak yerine, belirtilen bir proje modülüne aktarabilirsiniz.
Daha büyük geçişler için, içe aktarma sonuçları eklenen, güncellenen, göz ardı edilen ve kaldırılan öğelerin sayılarını içerir. Bu, betiklerin, CI işlerinin ve yapay zeka aracılarının bir sonraki adıma geçmeden önce ne olduğunu doğrulamalarını kolaylaştırır.
Bu, özellikle birden fazla formatın daha az manuel temizleme adımıyla aynı proje yapısına yerleşmesi gerektiğinde faydalıdır.
Yapılandırmadan hata ayıklama test durumları oluşturma
CLI kullanıcıları artık yapılandırma dosyalarından arayüz hata ayıklama test durumları oluşturabilir. Bir yapılandırma, durum adını, hedef API'yi, istek parametrelerini, istek gövdesini, kimlik doğrulamayı, ön işlemcileri, son işlemcileri ve yanıt doğrulamasını tanımlayabilir.
Oluşturulduktan sonra, hata ayıklama durumu diğer hata ayıklama durumları gibi Apidog'da açılabilir, düzenlenebilir ve yürütülebilir. Bu, otomasyon veya bir aracı ilk test varlığını hazırladığında, ancak bir geliştiricinin yine de onu görsel olarak incelemek ve iyileştirmek istediğinde faydalıdır.
Modül yönetimi, yapılandırılmış içe aktarmalar ve hata ayıklama durumu oluşturma, yerel betikler, CI/CD işlem hatları ve yapay zeka destekli iş akışlarındaki manuel çalışmayı birlikte azaltır.
Apidog CLI zaten yüklüyse, yeni yetenekleri kullanmadan önce onu güncelleyin:
npm install -g apidog-cli@latestEn son komut referansı için Apidog CLI dokümantasyonuna bakın.
🔗 Git Depo Entegrasyonları
Eylül ayı ayrıca Git tabanlı içe/dışa aktarımı iki yaygın depo ortamına genişletiyor.
Bitbucket Cloud
Proje içe ve dışa aktarma işlemleri artık Bitbucket Cloud depolarını destekliyor. Bitbucket Cloud'ı zaten kullanan ekipler, API varlıklarını başka bir Git platformuna taşımak yerine mevcut depolarını iş akışında tutabilirler.
GitLab On-Prem
Kuruluşlar, Apidog SaaS'ta bir GitLab On-Prem örneğini yapılandırabilir ve desteklenen Git depo iş akışlarında kullanabilir. Her kuruluş kendi bağlantısını bağımsız olarak yönetir, böylece ekipler mevcut kendi kendine barındırılan GitLab kurulumlarını kullanmaya devam edebilir.
Bağlanmadan önce, GitLab örneğinin adresinin ve ağ ortamının bağlantı gereksinimlerini karşıladığını doğrulayın.
⚙️ Günlük İyileştirmeler
Sürüm ayrıca günlük API çalışmalarından gelen sıkça geri bildirimleri de ele almaktadır.
Tam URL'ler artık ortam yoluyla çakışmıyor
Bir HTTP API oluştururken veya düzenlerken, http:// veya https:// ile başlayan tam bir URL girmek, ortam yolunu artık hemen gizler. Değeri tekrar göreceli bir yola değiştirmek, ortam yolunu geri yükler.
Bu, tam bir URL ve bir ortam yolunu aynı anda görmenin yarattığı karışıklığı ortadan kaldırır ve davranışı görmek için önce kaydetme ihtiyacını ortadan kaldırır.
Daha kullanışlı test raporu filtrelemesi
Test raporu listeleri artık çalıştırıcıya ve yürütme kaynağına göre filtrelemeyi destekliyor. İlgili görüntüleme alanları da eklendi, böylece uzun bir rapor listesini daraltmak ve farklı kaynaklardan gelen son kayıtları karşılaştırmak daha kolay hale geldi.
Tamamlamada test verisi değişkenleri görünür
Mevcut test verisi değişkenleri artık hem kod tamamlama hem de dinamik değer tamamlama bölümlerinde görünüyor. İstekleri veya testleri yazarken, adını kopyalamak için değişken listesine geri dönmek yerine değişkeni doğrudan arayıp seçebilirsiniz.
Daha hızlı proje listeleri
Apidog, proje listesi API'sinin yanıt süresini optimize etti. Çalışma alanına girerken veya bir proje bulurken proje listeleri daha hızlı yüklenerek sık navigasyon ve geçiş sırasında bekleme süresini azaltır.
✨ Bu Sürümde Ayrıca
Ayı, dokümantasyon, performans testi ve spec-first proje kurulumunu kapsayan üç değişiklik tamamlıyor.
Belge alt sitelerinden şemaları yayınlama
Apidog Belgelerindeki alt siteler artık uç noktaların yanı sıra şemaları da yayınlayabilir, böylece yayınlanmış bir sitenin okuyucuları ana siteye geri dönmek yerine onları yerinde görebilirler. Kurumsal alt siteler bu özelliği kendileri etkinleştirebilir.
Performans testlerinde P95 ve P99 yanıt süreleri
Performans testi sonuçları artık mevcut metriklerin yanı sıra P95 ve P99 yanıt sürelerini de rapor ediyor. Yüzdelikler, ortalamaların gizlediği yavaş kuyruğu açıklar; bu genellikle kullanıcıların aslında fark ettiği bir API'nin kısmıdır.
Spec Modu proje kurulumu ve OpenAPI içe aktarımı
Spec Modu projeleri artık daha net bir boş durumla açılıyor; OpenAPI içe aktarma ve oluşturma giriş noktaları doğrudan yüzeye çıkarılıyor, böylece spec-first bir proje giriş yolunu aramak zorunda kalmadan başlayabilir.
🛠️ Ek Düzeltmeler ve İyileştirmeler
Bu döngü ayrıca aşağıdaki düzeltmeleri ve daha küçük değişiklikleri içerir:
- Deneme durumu ve eylemlerinin ana pencere ve sekme çubuğunda nasıl görüntülendiği iyileştirildi.
- Bekleyen davetiyelerin kuruluş ve ekip üyesi listelerinde nasıl göründüğü iyileştirildi.
- Oluşturulan istek kodundaki Temel Kimlik Doğrulama değişkenlerinin genişletilmediği ve doğrudan Base64 olarak kodlandığı bir sorun düzeltildi.
- Bir sekmeyi düzenlerken
allOfkullanan referans verilen birleşik veri modeli alanlarının genişletilmemesi sorunu düzeltildi. - Bir projeyi klonladıktan veya kopyaladıktan sonra API'nin veri modellerine çapraz proje referanslarının yanlış olması sorunu düzeltildi.
- CLI tarafından oluşturulan hata ayıklama durumlarının Web istemcisinde kimlik doğrulama türünü "Kimlik Doğrulaması Yok" olarak göstermesi ve kimlik doğrulama uygulamaması sorunu düzeltildi.
- CLI içe aktarma sırasında OpenAPI yanıt
$reftanımlarının sessizce atıldığı bir sorun düzeltildi. - Rapor listesi sayfalama meta verilerinin yanlış
pageSizevepageIndexdeğerlerini döndürmesi sorunu düzeltildi. - Hem JUnit hem de HTML test raporları oluşturulduğunda JUnit raporunun yalnızca son test durumu sonucunu içermesi sorunu düzeltildi.
- Tek API testinde URL ortamları değiştirilirken ortam açılır menüsünün açılamaması sorunu düzeltildi.
- Ana sayfa davet ödülü girişini Kurumsal Politika aracılığıyla devre dışı bırakma desteği eklendi.
Tüm öğe bazında liste için Apidog Değişiklik Günlüğü'nü inceleyin.
🌟 Bunun Anlamı Nedir
Eylül ayı, çalışması giderek insanlar, betikler, aracılar ve Git depolarını kapsayan ekipler için pratik bir sürümdür.
| Odak Noktası | Ne İyileşiyor | Neden Önemli |
|---|---|---|
| CLI ve otomasyon | Modüller, içe aktarmalar ve hata ayıklama durumları CLI aracılığıyla oluşturulabilir ve yönetilebilir. | Otomasyon ve aracılar, manuel UI kurulumu olmadan daha erken katılabilir. |
| Git işbirliği | Bitbucket Cloud ve GitLab On-Prem, proje iş akışlarına bağlanır. | Ekipler, zaten kullandıkları depoları koruyabilirler. |
| Günlük kalite | URL işleme, rapor filtreleme, değişken tamamlama ve proje yükleme iyileşiyor. | Ortak kurulum ve inceleme adımları daha az dikkat gerektirir. |
| Belgeler, test ve özellikler | Şemalar Doküman alt siteleriyle yayınlanır, performans sonuçları P95 ve P99'u rapor eder ve Spec Modu daha net bir başlangıç yapar. | Şemalar, gecikme süresi ve spec-first bağlamı, iş akışından ayrılmadan görünür. |
💬 İletişimde Kalın
Geri bildirim veya sorularınız mı var? Diğer API mühendisleri ve Apidog ekibiyle iletişime geçin:
- Gerçek zamanlı tartışmalar ve destek için Discord topluluğumuza katılın.
- Teknik sohbetler için Slack topluluğumuza katılın.
- En son güncellemeler için bizi X (Twitter) ve LinkedIn'de takip edin.
Not: Bu sürümdeki her ayrıntı için Apidog Değişiklik Günlüğü'ne bakın.
Saygılarımızla,
Apidog Ekibi