⭐ Mayıs ayı, taşınma sonrası kurulum işlerini azaltmaya, kurumsal kimlik doğrulama güvenliğini güçlendirmeye ve günlük API hata ayıklama çıktılarını daha eksiksiz hale getirmeye odaklanan pratik bir sürümdür.
Ekipler API çalışmalarını araçlar arasında taşırken, zor olan kısım nadiren sadece dosyaları içe aktarmaktır. Gerçek sürtünme içe aktarma sonrası ortaya çıkar: temel URL'lerin düzeltilmesi, ortamların ayarlanması, oluşturulan kodun kimlik doğrulama gerektirmesi ve CI çalıştırıcılarının daha katı altyapı kurallarına uyması gerekir.
Bu ay Apidog, iş akışının bu kısımlarını iyileştiriyor. Postman içe aktarmaları artık daha akıllı Temel URL eşlemesi içeriyor, Kurumsal Politikalar Kimlik Doğrulama Güvenlik kontrolleriyle başlıyor, Spec-First Modu önce Git bağlanmadan denenebiliyor, Runner kök ayrıcalıkları olmadan çalışabiliyor, oluşturulan istek kodu kimlik doğrulama bilgilerini içerebiliyor ve çeşitli istek paylaşımı, test senkronizasyonu ve Sahte veri oluşturma sorunları giderildi.
Bu ay değişenler şunlardır:
⭐ Yeni Güncellemeler
📦 Postman Verilerini Daha Akıllı Temel URL Eşlemesi ile İçe Aktarma
Apidog, Postman içe aktarma sırasında paylaşılan bir Temel URL'yi güvenilir bir şekilde tespit edebildiğinde, bu değeri ortamlarınızdaki eşleşen modül için Temel URL alanına yerleştirmeye yardımcı olabilir.
Postman'dan geçiş yapan ekipler için bu, yaygın bir temizleme adımını azaltır. İçe aktarma sonrası, isteklerin manuel olarak içe aktarılan URL'leri kontrol etmeden ve modül Temel URL'lerini ortam ortam doldurmadan doğrudan gönderilmeye daha hazır olması muhtemeldir.
| Öncesi | Şimdi |
|---|---|
|
|
Bu iyileştirme hem yerel Postman dosyası içe aktarmayı hem de Postman API aracılığıyla içe aktarmayı destekler. İstek URL'leri net bir paylaşılan adres veya tanınabilir bir değişken içerdiğinde, Apidog kullanılabilir Temel URL'yi ayıklamaya çalışacak ve onu ilgili ortamlarda modülün Temel URL'sinin yapılandırıldığı yere yerleştirecektir.
🛡️ Kurumsal Politikalar, Kimlik Doğrulama Güvenlik Kontrolleriyle Başlıyor
Apidog, kuruluş düzeyinde güvenlik kontrolleri için bir yönetim çerçevesi olarak Kurumsal Politikaları sunuyor ve Kimlik Doğrulama Güvenliği ile başlıyor.
Kimlik Doğrulama Güvenliği, kimlik doğrulama yapılandırmasındaki kimlik bilgilerinin ifşasını azaltmaya odaklanır. Kuruluş yöneticileri, hassas Kimlik Doğrulama alanları için, kimlik bilgilerinin ham değerler yerine değişkenler veya Gizli Kasa Sırları olarak saklanmasını teşvik etmek veya zorunlu kılmak gibi kurallar tanımlayabilir.
Gizli Kasa Sırları için ekipler, UI'da düz metin olarak görünmesini de engelleyebilir. Üyeler yine de istek yürütme için sırrı referans alabilir, ancak değer bir göz simgesi veya ekran paylaşımı aracılığıyla rastgele ifşa edilmez.
🔒 Bu, kurumsal ekiplere, API hata ayıklamasını ayrı bir güvenlik sürecine dönüştürmeden kimlik doğrulama bilgilerini yönetmek için daha net bir yol sunar.
📝 Spec-First Modu Artık Önce Git Kurulumu Gerektirmiyor
Spec-First Modunu denemek artık daha kolay. Önce bir Git deposu bağlamadan bir Spec-First projesi oluşturabilir, ardından hazır olduğunuzda bir OpenAPI dosyası ekleyebilir veya içe aktarabilirsiniz.
Bu, tam bir Git tabanlı kuruluma geçmeden önce Apidog'da dosya dostu, OpenAPI merkezli bir iş akışını keşfetmek isteyen ekipler için engeli düşürür.
ℹ️ Bu, özellikle Spec-First iş akışlarını değerlendiren veya depolama yapısını standartlaştırmadan önce erken geri bildirim toplayan ekipler için kullanışlıdır.
🔒 Runner Artık Kök Olmayan Bir Kullanıcı Olarak Çalışabilir
Runner artık kök olmayan bir kullanıcı olarak çalışmayı desteklemektedir.
Bu, özellikle kök olarak işlem çalıştırmanın tavsiye edilmediği veya politika tarafından engellendiği daha katı sunucu, konteyner ve CI/CD ortamlarında kullanışlıdır. Ekipler, mevcut otomasyon iş akışlarına hala uyarken Runner'ı daha küçük bir izin ayak iziyle dağıtabilir.
✅ Bu güncelleme, ekiplerin Runner dağıtımını genel test iş akışını değiştirmeden dahili güvenlik gereksinimleriyle uyumlu hale getirmesine yardımcı olur.
🔐 Oluşturulan İstek Kodu Kimlik Doğrulama Bilgilerini İçerebilir
Bir API isteğinden istek kodu oluştururken Apidog, daha önce yapılandırılmış olan kimlik doğrulama bilgilerini artık dahil edebilir.
Bu, oluşturulan kod parçacıklarının doğrudan çalıştırabileceğiniz bir şeye daha yakın olduğu anlamına gelir. Dışa aktarma sonrası belirteçleri, başlıkları veya diğer kimlik doğrulama parametrelerini manuel olarak eklemek yerine, geliştiriciler baştan daha eksiksiz bir örnek alabilirler.
Bu, bir API çağrısını hızla doğrulamanız, çalıştırılabilir bir örneği ekip arkadaşlarınızla paylaşmanız veya bir isteği başka bir hata ayıklama bağlamına yapıştırmanız gerektiğinde kullanışlıdır.
✅ Optimizasyonlar
🧩 CLI Betik Yürütme Artık Daha Kısıtlı
Betik yürütme riskini azaltmak için CLI artık yalnızca "Harici Programlar" dizinindeki betiklerin çağrılmasına izin vermektedir.
Ekibiniz otomasyon akışlarında CLI betikleri kullanıyorsa, mevcut betik yollarının yeni yürütme kuralıyla eşleşip eşleşmediğini kontrol etmek faydalı olacaktır. Bu daha sıkı sınır, istenmeyen veya aşırı geniş betik yürütmeyi azaltmaya yardımcı olurken, amaçlanan harici program iş akışlarını kullanılabilir kılar.
📋 Kopyalanan cURL Komutları Daha Fazla İstek Yapılandırması İçerir
Apidog'dan cURL kopyalanırken, oluşturulan komut artık yapılandırılmış Başlık ve Gövde parametrelerini daha güvenilir bir şekilde içerir.
Bu, kopyalanan cURL komutlarını uygulamada yapılandırdığınız gerçek isteğe daha yakın hale getirir. Terminalde hata ayıklama yapıyor, tekrarlanabilir bir isteği paylaşıyor veya sorun giderme notlarına bir komut ekliyor olun, daha az manuel temizleme gereklidir.
🧪 Otomatik Test Adımları Yöntem Değişikliklerinden Sonra Senkronize Kalır
Bir uç nokta istek yöntemi GET'ten POST, PUT veya başka bir yönteme değiştiğinde, ilgili otomatik test adımları artık güncellenmiş yapılandırmayı daha doğru bir şekilde senkronize eder.
Bu, eski istek yöntemi bilgilerinin neden olduğu test uyuşmazlıklarını azaltır ve uç nokta güncellemelerinden sonra otomatik test sonuçlarına daha kolay güvenilmesini sağlar.
🎲 Daha Güvenilir Sahte Veri Oluşturma
Bu sürüm, çarpan kuralları, arrayElements ifadeleri ve JavaScript üretimi ile Sahte veri üretiminin birlikte kullanıldığı durumlardaki toplu üretim sorunları dahil olmak üzere çeşitli Sahte veri üretimi sorunlarını düzeltir.
Ön uç-arka uç entegrasyonu, toplu test verisi üretimi ve otomatik test için, Sahte çıktı artık daha kararlı ve yapılandırdığınız kurallara daha yakın olmalıdır.
🐞 Hata Düzeltmeleri ve Küçük İyileştirmeler
Bu ay ayrıca bir dizi düzeltme ve yaşam kalitesi iyileştirmesi yayınladık, bunlar arasında:
- Paylaşılan dokümantasyon istek parametrelerinin varsayılan örnekleri göstermemesi sorunu düzeltildi.
- Yalnızca Markdown belgeleri olan ve uç noktası olmayan bir projenin dışa aktarımının başarısız olabileceği bir sorun düzeltildi.
- JavaScript üretimi ve Sahte veri üretiminin birlikte kullanıldığı toplu üretim, sayı çarpan kuralları ve
arrayElementsmin ve max ifadeleri dahil olmak üzere çeşitli Sahte veri üretimi sorunları düzeltildi. - Proje genel bakış sabit bağlantılarının, farklı projelerden bağlantılar art arda açıldıktan sonra 500 hatası döndürebilmesi sorunu düzeltildi.
- Arayüzün bazı durumlarda
Error: Cannot read properties of null (reading 'nullable')hatasını gösterebilmesi sorunu düzeltildi. - Paylaşılan dokümantasyonda seçilen örnek adlarının açık temada okunmasının zor olabileceği bir kontrast sorunu düzeltildi.
- Windows kullanıcılarının AI Agent Debugger'ı normal şekilde kullanamaması sorunu düzeltildi.
- Birden fazla yüklü dosyaya sahip bir form-data gövde alanının, toplu düzenlemeyi açıp kaydettikten sonra yalnızca bir dosya göstermesi sorunu düzeltildi.
🌟 Bu Ne Anlama Geliyor
Mayıs ayı, API iş akışlarındaki küçük ama maliyetli sürtünme kaynaklarını ortadan kaldırmakla ilgili.
| Alan | Gelişenler | Neden Önemli |
|---|---|---|
| Postman geçişi | Apidog güvenilir bir şekilde algılayabildiğinde paylaşılan Temel URL'ler eşlenir. | Koleksiyonları içe aktardıktan ve ortamları yapılandırdıktan sonra daha az manuel temizleme. |
| Runner dağıtımı | Runner, kök olmayan bir kullanıcı olarak çalışabilir. | Daha katı sunucu, kapsayıcı ve CI/CD politikalarına daha iyi uyum. |
| Kurumsal güvenlik | Kurumsal Politikalar, Kimlik Doğrulama Güvenlik kontrolleriyle başlar. | Yöneticiler, kimlik doğrulama iş akışlarındaki ham kimlik bilgilerinin ifşasını azaltabilir. |
| Spec-first iş akışları | Spec-First projeleri artık kullanmadan önce Git bağlaması gerektirmiyor. | Ekipler, bir depo iş akışı kurmadan önce OpenAPI merkezli çalışmayı deneyebilir. |
| İstek paylaşımı | Oluşturulan kod ve cURL çıktıları, yapılandırılan isteğin daha fazlasını içerir. | Örnekler daha kolay çalıştırılabilir, yeniden üretilebilir ve paylaşılabilir. |
| Test ve Mocking | Test adımları daha doğru senkronize olur ve Sahte veri üretimi daha kararlıdır. | Ekipler, yapılandırma kaymalarını ve beklenmedik test verilerini kovalamak için daha az zaman harcar. |
Bu güncellemelerin hiçbiri karmaşıklık eklemekle ilgili değil. Kurulum sonrası işin daha az kırılgan hissettirmesiyle ilgili: daha az manuel düzeltme, daha güvenli varsayılanlar ve zaten yapılandırdıklarınızla daha iyi eşleşen çıktılar.
💬 Sohbetimize 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 ayrıntıları için Apidog Değişiklik Günlüğü'ne bakın!
Saygılarımızla,
Apidog Ekibi