Haziran güncellemeleri; yapay zeka destekli CLI işlemleri, daha düzenli içe aktarımlar, OAuth 2.0 otomatik token yenileme ve test/yapılandırma akışlarını kolaylaştıran iyileştirmelerle günlük API işlerini daha otomatik ve güvenilir hale getiriyor.
Bu sürüm özellikle API ekiplerinin sık zaman kaybettiği alanlara odaklanıyor:
- Yapay zeka ajanlarına gerçek proje kaynaklarına yapılandırılmış erişim vermek
- Postman, OpenAPI ve Swagger içe/dışa aktarımlarından sonra manuel temizlik ihtiyacını azaltmak
- OAuth korumalı isteklerin token süresi dolduğunda kesintiye uğramasını önlemek
- Test paketi oluşturma, zamanlama ve istek yapılandırmasını hızlandırmak
Aşağıda bu ay gelen değişiklikleri uygulama odaklı şekilde bulabilirsiniz.
Yeni Güncellemeler
Apidog CLI, Yapay Zeka Destekli API İş Akışlarını Destekliyor
Apidog CLI artık yapay zeka destekli API iş akışlarında yürütme katmanı olarak daha merkezi bir rol üstleniyor.
Amaç, kullanıcıların her CLI komutunu tek tek ezberlemesi yerine, yapay zeka ajanlarının Apidog proje kaynaklarıyla yapılandırılmış ve doğrulanabilir şekilde çalışabilmesini sağlamak.
Bu güncellemeyle CLI şu akışlarda daha kullanışlı hale geliyor:
- Apidog proje kaynaklarını okuma
- Proje üzerinde değişiklik yazma
- Test senaryolarını çalıştırma
- Senaryo durumları, uç noktalar ve test senaryoları gibi mevcut varlıklara referans verme
- Yerel formatta veya OpenAPI formatında daha kontrollü dışa aktarım yapma
Pratik olarak şu tür bir iş akışı hedeflenir:
1. Yapay zeka ajanı Apidog proje kaynaklarını okur.
2. Gerekli uç nokta veya test senaryosu değişikliğini üretir.
3. CLI üzerinden ilgili senaryoyu çalıştırır.
4. Sonucu doğrular.
5. Gerekirse değişikliği projeye geri yazar.
Apidog Becerileri ile birlikte kullanıldığında CLI, ajanlara daha net sınırlar ve daha güvenli işlem adımları sağlar. Böylece ajanlar API görevlerini yapılandırılmamış bilgilerden tahmin etmek yerine gerçek proje bağlamıyla tamamlayabilir.
CLI'ı, doğal dildeki yapay zeka talimatları ile yapılandırılmış Apidog proje işlemleri arasındaki köprü olarak düşünebilirsiniz.
İçe ve Dışa Aktarma İyileştirmeleri
Bu sürüm, özellikle Postman'den geçiş yapan veya OpenAPI/Swagger tanımlarını sürdüren ekipler için içe ve dışa aktarma akışlarını iyileştiriyor.
Postman API üzerinden veri içe aktarırken Apidog artık değişken adlarındaki boşlukları kaldırabilir. Bu, içe aktarma sonrası manuel düzenleme ihtiyacını azaltır ve değişkenlerin daha tutarlı kullanılmasına yardımcı olur.
Örneğin:
Önce: base url
Sonra: baseurl
Postman API üzerinden çalışma alanları içe aktarılırken Apidog, belirsiz "Çalışma Alanım" adlarını çalışma alanı yaratıcısına göre yeniden adlandırabilir. Birden fazla çalışma alanı içe aktaran ekipler için bu, hangi çalışma alanının kime veya hangi projeye ait olduğunu daha kolay ayırt etmeyi sağlar.
OpenAPI ve Swagger tarafında da destek genişletildi. Apidog artık içe/dışa aktarma sırasında şu parametre tiplerini destekler:
- Nesne tipi parametreler
- Referans tipi parametreler
Bu, daha karmaşık API belirtimlerinin daha az manuel düzeltmeyle taşınmasına yardımcı olur.
| Önce | Şimdi |
|---|---|
| İçe aktarılan değişkenler manuel temizlik gerektirebilirdi. | Postman API içe aktarımları, değişken adlarındaki boşlukları kaldırabilir. |
| Birden fazla içe aktarılan çalışma alanı kafa karıştırıcı adlara sahip olabilirdi. | Belirsiz çalışma alanı adları, daha kolay tanımlama için yeniden adlandırılabilir. |
| Karmaşık OpenAPI parametreleri içe/dışa aktarmadan sonra ek ayarlama gerektirebilirdi. | OpenAPI/Swagger içe/dışa aktarımı, nesne tipi ve referans tipi parametreleri destekler. |
OAuth 2.0 Artık Otomatik Token Yenilemeyi Destekliyor
OAuth 2.0 kimlik doğrulaması artık otomatik token yenilemeyi destekliyor.
Bir erişim tokeni sona ermeye yaklaştığında veya zaten sona erdiğinde, Apidog tokeni otomatik olarak yenileyebilir. Böylece istekleri çalıştırmadan önce manuel olarak yeniden kimlik doğrulamanız veya yeni token kopyalamanız gerekmez.
Bu özellikle şu durumlarda faydalıdır:
- OAuth korumalı API'lerde sık hata ayıklama
- Uzun süren test oturumları
- Tekrarlayan istek doğrulama
- Zamanlanmış veya yarı otomatik test akışları
Tipik akış:
1. İstek OAuth 2.0 ile çalıştırılır.
2. Access token süresi dolmak üzeredir veya dolmuştur.
3. Apidog tokeni otomatik yeniler.
4. İstek akışı kesilmeden devam eder.
Bu güncelleme, API hata ayıklama ve test sırasında kimlik doğrulama kaynaklı kesintileri azaltır.
Kullanıcı Geri Bildirim İyileştirmeleri
Daha İyi MCP İstemci Uyumluluğu
Apidog, MCP İstemci uyumluluğunu geliştirdi ve artık standart olmayan şemaları daha güvenilir şekilde ayrıştırabilir.
Bu iyileştirme, şema çıktısı beklenen formata tam uymayan MCP sunucuları veya araçlarıyla çalışırken önemlidir. Apidog, şema farklılıklarında hemen başarısız olmak yerine daha fazla gerçek dünya MCP yanıtını işleyebilir.
Sonuç olarak:
- MCP araç entegrasyonlarında daha yüksek başarı oranı
- Daha az şema uyumluluğu hatası
- Daha sorunsuz hata ayıklama deneyimi
Test Paketlerinde Statik Adımları Ada Göre Arama
Bir test paketine statik adım eklerken artık ada göre arama yapabilirsiniz.
Büyük projelerde çok sayıda uç nokta, test senaryosu veya senaryo bulunabilir. Bu durumda uzun listelerde manuel gezinmek yerine ilgili adımı adıyla aramak test paketi oluşturmayı hızlandırır.
Örnek kullanım:
1. Test paketini açın.
2. Statik adım ekleme ekranına gidin.
3. Uç nokta veya senaryo adını arayın.
4. Doğru adımı seçip pakete ekleyin.
Bu özellikle regresyon test paketleri veya modül bazlı test senaryoları oluştururken zaman kazandırır.
Zamanlanmış Görevlere "Her 8 Saatte Bir" Seçeneği Eklendi
Zamanlanmış görevler artık "Her 8 saatte bir" seçeneğini içeriyor.
Bu aralık şu iş akışları için uygundur:
- Gün içinde birden fazla kez çalışan otomatik API testleri
- İzleme tarzı periyodik kontroller
- Kritik uç noktaların düzenli doğrulanması
- Ortam sağlığı kontrolleri
Örnek zamanlama stratejisi:
00:00 İlk kontrol
08:00 İkinci kontrol
16:00 Üçüncü kontrol
Apidog Web Uygulaması, Otomatik Oluşturulan Başlıkları Yapılandırmayı Destekliyor
Apidog Web Uygulaması artık otomatik oluşturulan başlıkları yapılandırmayı destekliyor.
Bu, tarayıcı tabanlı kullanımda istek davranışı üzerinde daha fazla kontrol sağlar. Ekipler, otomatik eklenen başlıkların proje veya ortam gereksinimleriyle uyumlu olmasını daha kolay sağlayabilir.
Bu özellik özellikle şu durumlarda faydalıdır:
- Ekip standardı başlıkların korunması
- Ortam bazlı istek davranışının kontrol edilmesi
- Otomatik oluşturulan isteklerin beklenen formatta tutulması
Hata Düzeltmeleri ve Küçük İyileştirmeler
Bu ay ayrıca aşağıdaki düzeltmeler ve küçük iyileştirmeler yayınlandı:
- Büyük test senaryolarını alt dallara seçerken performans iyileştirildi ve zaman aşımı hataları olasılığı azaltıldı.
- Sprint dalı ve genel dal listeleri artık dal kimliklerini görüntülemeyi ve kopyalamayı destekliyor.
- macOS intranet istekleri gönderemediğinde daha kullanıcı dostu bir uyarı mesajı gösteriliyor.
- Yeni bir modüle Apidog verilerini yeniden içe aktarırken servis Temel URL'lerinin içe aktarılmaması ve uç noktaların belirtilen servise bağlanmaması sorunu düzeltildi.
- İstek başlığına eklenmek üzere ayarlanan OAuth 1.0 kimlik doğrulamasının gerçekte istek başlığına eklenmemesi sorunu düzeltildi.
- Temel Kimlik Doğrulama Çince değişkenler kullandığında oluşturulan uç nokta istek kodunun doğru çalışmaması sorunu düzeltildi.
- Uç nokta HTTP kullandığında oluşturulan istek kodunun yanlışlıkla HTTPS kullanması sorunu düzeltildi.
- Bir senaryo adımı ham formatta bir yanıt gövdesini referans aldığında CLI senaryolarını çalıştırmanın "Beklenmeyen token" hatası verebilmesi sorunu düzeltildi.
- Otomatik bir test senaryosu anormal şekilde sonlandırıldıktan sonra test raporu ayrıntılarının hâlâ çalışıyor olarak görünmesi sorunu düzeltildi.
- Kök klasördeki senaryo durumları çalıştırıldıktan sonra ilgili raporun test raporu listesinde görüntülenmemesi sorunu düzeltildi.
- Apidog Web Uygulaması'nı yenilediğinizde projenin otomatik olarak ana dala geri dönmesi sorunu düzeltildi.
- Dal içe aktarımı sırasında ve Markdown'a uç nokta eklerken etiket filtresi seçeneklerinin içeriği olmaması sorunu düzeltildi.
- Birden çok modül ve servis içeren Apidog dosyalarını içe aktarırken varsayılan olmayan servislerin tekrar tekrar eklenmesi sorunu düzeltildi.
- Apidog verileri içe aktarılırken Markdown belge etiketlerinin doğru şekilde içe aktarılmaması sorunu düzeltildi.
- Bazı durumlarda uç noktalar ana dalla birleştirildikten sonra hâlâ çakışmaların gösterilmesi sorunu düzeltildi.
- Bazı durumlarda SSE uç noktalarında hata ayıklarken ön uç hatalarının meydana gelebilmesi sorunu düzeltildi.
- Şirket içi proje istatistiklerinin yalnızca varsayılan modülden gelen verileri sayması sorunu düzeltildi.
- Ekip ayrıntıları sayfasından çok modüllü bir Apidog dosyasını içe aktarırken uç noktaların yanlışlıkla varsayılan modüle içe aktarılması sorunu düzeltildi.
- Bazı durumlarda değişiklikleri gönderdikten sonra değişikliklerin kaybolması sorunu düzeltildi.
- Şifre değiştirme akışında e-posta doğrulama sırasında yanlış bir hata mesajı gösterilmesi sorunu düzeltildi.
Bu Ne Anlama Geliyor
Bu güncellemeler birlikte değerlendirildiğinde Apidog; insanlar, yapay zeka ajanları, API spesifikasyonları ve otomatik testler arasında daha uygulanabilir bir çalışma akışı sunuyor.
| Alan | Ne Gelişiyor | Neden Önemli |
|---|---|---|
| Yapay zeka destekli CLI iş akışları | CLI, yapay zeka ajanlarının gerçek Apidog proje kaynakları üzerinde çalışmasına, test senaryoları çalıştırmasına, mevcut varlıklara referans vermesine ve dışa aktarımları daha hassas kontrol etmesine yardımcı olabilir. | Yapay zeka ajanları API görevlerini yapılandırılmamış bilgilerden tahmin etmek yerine yapılandırılmış proje bağlamıyla tamamlayabilir. |
| İçe ve dışa aktarma | Postman API içe aktarımları değişken adlarını temizleyebilir ve çalışma alanı adlarını netleştirebilir; OpenAPI/Swagger içe/dışa aktarımı nesne tipi ve referans tipi parametreleri destekler. | Geçiş sonrası daha az temizlik ve daha eksiksiz API spesifikasyon değişimi sağlar. |
| Kimlik doğrulama | OAuth 2.0 tokenleri otomatik olarak yenilenebilir. | API hata ayıklama ve test sırasında daha az kesinti yaşanır. |
| MCP uyumluluğu | MCP İstemcisi daha fazla standart dışı şemayı ayrıştırabilir. | Gerçek dünya MCP araçları ve sunucularıyla daha iyi uyumluluk sağlar. |
| Test iş akışları | Statik adımları bulmak daha kolaydır ve zamanlanmış görevler ek bir 8 saatlik aralığı destekler. | Test paketi kurulumu hızlanır ve yinelenen test yürütmesi daha esnek hale gelir. |
| Web Uygulaması yapılandırması | Otomatik oluşturulan başlıklar Apidog Web Uygulaması'nda yapılandırılabilir. | Tarayıcı tabanlı iş akışlarında istek davranışı üzerinde daha fazla kontrol sağlar. |
Özetle:
Daha iyi proje bağlamı + daha temiz içe aktarımlar + otomatik token yenileme + daha esnek test akışları
= daha az manuel iş ve daha güvenilir API geliştirme süreci
Sohbete Katılın
Diğer API mühendisleri ve Apidog ekibiyle bağlantı kurun:
- 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) üzerinden takip edin.
Not: Tüm güncellemelerin tam detayları için Apidog Değişiklik Günlüğü'nü kontrol edin.
Saygılarımızla,
Apidog Ekibi
Top comments (0)