Ana içeriğe geç

Giriş

API geliştirme biçimi değişiyor. Yirmi yıl boyunca işlemleri yapan, grafik arayüzde tıklayan bir insandı; API sözleşmesini kullanan ise belgeleri okuyan bir insandı. Şimdi her iki taraf da dönüşüyor:

  • İşlemleri giderek daha fazla, niyeti eyleme dönüştüren bir yapay zekâ asistanı gerçekleştiriyor;
  • Sözleşmeyi kullanan ise giderek daha fazla, API'yi MCP üzerinden bir araç olarak çağıran bir yapay zekâ ajanı oluyor.

Önceki dönemin araçları — API istemcisi, spesifikasyon görüntüleyicisi ve istek koleksiyonu — klavye başındaki insan için tasarlanmıştı. Powerduck bu yeni dönem için geliştirildi. Yalnızca daha iyi bir API istemcisi veya daha şık bir spesifikasyon görüntüleyicisi değil; tek bir OpenAPI dosyasıyla başlayan, yapay zekâyı merkezine alan bir platformdur.

Temel: tek bir yerel OpenAPI dosyası​

Her şey deponuzdaki sıradan bir openapi.yaml dosyasıyla başlar. Bu dosya açık biçimlidir, sürüm kontrolüne uygundur ve hem insanlar hem de yapay zekâ tarafından okunabilir. Başlangıç noktası, kapalı bir veritabanı veya bulut hesabı değildir.

                one local openapi.yaml
                         |
      you + AI -> design debug test mock docs data-model
                         |
                      MCP tools
                         |
               any AI coding agent

Sözleşme bu dosyadır. Her iş akışı onu okur; aynı dosya MCP üzerinden herhangi bir yapay zekâ kodlama ajanına da sunulabilir. Böylece siz, yerleşik asistan ve tüm harici ajanlar tek bir doğruluk kaynağını paylaşırsınız. Tasarım, hata ayıklama, testler, mock'lar ve belgeler aynı dosyayı okuyunca araçları eşzamanlı tutmak ayrı bir iş olmaktan çıkar. Bu, tasarımın doğal sonucudur.

Powerduck OpenAPI 3.2 ile çalışır; mevcut 3.0 ve 3.1 belgelerini ve Swagger 2.0 belgelerini yerinde yükselterek okur. HTTP dışındaki API'ler — SSE, WebSocket, GraphQL, gRPC ve MCP — yalnızca REST'e uygun bir yapıya zorlanmak yerine x-protocol uzantısıyla normal yol öğeleri olarak modellenir.

Yapay zekâyla çalışma​

  • Bir YAML dosyası açtığınızda asistan onunla neler yapabileceğinizi hemen önerir;
  • İstediğiniz sonucu doğal dille belirtin: “sipariş uç noktalarını oluştur”, “test verilerini hazırla” veya “ödeme akışını çalıştır ve rapor ver”. Asistan doğru aracı seçer ve değişikliği önerir;
  • Her değişiklik inceleyebileceğiniz bir kart olarak sunulur; siz onaylamadan uygulanmaz;
  • Bir API'yi düzenlerken asistan o API'ye odaklanır ve belgenin başka yerlerine kaymadan yalnızca istediğiniz değişiklikleri yapar;
  • Yerel dosyalar diskte kalır. Uzak yapay zekâ, ilgili bağlamı yapılandırdığınız model hizmetine o hizmetin kimlik bilgileriyle gönderir. Cloud'a yayımlama, seçilen içeriği yükler. İsteğe bağlı kullanım istatistikleri varsayılan olarak kapalıdır ve ayrı yönetilir; yerel çalışma için hesap gerekmez.

Varsayılan olarak yerel çalışma​

Powerduck bilgisayarınızda çalışır, gerçek dosyaları açıp kaydeder, çevrimdışı kullanılabilir ve API anahtarları ile istemleri tarayıcının dışında tutar. Bulut, paylaşım ve yayımlama için isteğe bağlı bir uzantıdır; başlamak için gerekli değildir.

Powerduck'ı kullanmanın üç yolu​

ÜrünAçıklamaKimler için uygun?
Masaüstü İstemcisiYapay zekâ asistanı ve eksiksiz API çalışma alanı içeren, yerel çalışmaya öncelik veren Electron uygulamasıHer şeyi kendi bilgisayarında tutmak, çevrimdışı çalışmak ve anahtarlarla istemleri yerel ortamda saklamak isteyen geliştiriciler
Powerduck CloudOAS barındırma, çevrimiçi belgeler ve yönetilen MCP hizmetiAPI paylaşmak, kalıcı bağlantılar yayımlamak ve sunucu çalıştırmadan MCP sunmak isteyenler
Açık kaynak kütüphanelerBirlikte kullanılabilen @powerduck/* npm paketleriÖzel araçlar, CI işlem hatları veya gömülü bileşenler geliştirenler

Üç ürün de aynı motorları kullanır. Masaüstü istemcisi ve bulut, açık kaynak kütüphanelerden oluşturulur. Bu nedenle bir özellik yerel olarak çalıştırıldığında, ağ üzerinden çağrıldığında veya doğrudan paket olarak içe aktarıldığında aynı biçimde davranır.

Masaüstü İstemcisi​

Masaüstü istemcisi tamamen bilgisayarınızda çalışır. Diskteki gerçek dosyaları açıp düzenler, istekleri yerel bir süreç üzerinden gönderir, yerel bir mock çalıştırır ve yapay zekâ istemleriyle API anahtarlarını tarayıcı konsolunun dışında tutar. Modeli dilediğiniz gibi yapılandırabilirsiniz. Önerilen her değişiklik uygulanmadan önce inceleyebileceğiniz bir kartta gösterilir.

Powerduck Cloud​

Powerduck Cloud aynı iş akışını çevrimiçi ortama taşır. Bir dosya, Git deposu veya URL ekleyin; sunmak istediğiniz işlemleri seçin; oluşturulan belgeler ve yönetilen MCP uç noktası için kalıcı bağlantılar alın. Erişim, görüntüleme parolası veya MCP erişim anahtarıyla korunabilir. Ücretli planlar Git eşitlemesi, özel alan adları ve daha yüksek limitler sunar.

Açık kaynak kütüphaneler​

Kütüphaneler, ürünün altında çalışan motorlardır: OpenAPI ayrıştırıcısı ve yükselticisi, çok protokollü CLI, kod oluşturucu, MCP sunucusu, istek çalıştırıcısı, cURL ve Postman dönüştürücüleri ve gömülebilen editörler. Her biri kendi kurulum kılavuzu ve API başvurusuyla npm'de bağımsız olarak yayımlanır. Ayrıntılı teknik açıklamalar bu bölümlerde yer alır.

Sizin için ne değişiyor?​

  • Tıklamaları değil, sonucu yönlendirirsiniz. Hedefinizi anlatırsınız; asistan işi inceleyebileceğiniz adımlarla yürütür.
  • API'leriniz ajanlara hazır olur. Belgeleri oluşturan sözleşme MCP araçlarını da üretir; böylece yapay zekâ ajanları API'nizi en baştan doğru çağırabilir.
  • Her şey uyumlu kalır. Tasarım, hata ayıklama, testler, mock'lar ve belgeler tek dosyayı okur.
  • Tüm protokoller tek yerde bulunur. HTTP, SSE, WebSocket, GraphQL, gRPC ve MCP, altı ayrı araç yerine tek bir spesifikasyonda yer alır.
  • Bir sağlayıcıya bağımlı kalmazsınız. Kendi modelinizi seçer, anahtarları masaüstünde yerel olarak saklar ve deponuzdaki YAML dosyasının kontrolünü elinizde tutarsınız.

Sonraki adımlar​