Powerduck logo Powerduck

Yerel çalışmayı esas alan, AI destekli OpenAPI stüdyosu

API’niz: yerel geliştirmeden
belgelere ve AI’a.

Codex, Claude Code ve Cursor, API tanımlarınıza göre kod yazsın. Yerel çalışmayı ön planda tutan Powerduck masaüstü uygulamasında koddan dokümantasyon oluşturun, testleri yapay zekâyla düzenleyin. OpenAPI dokümanlarını ve MCP sunucularını Hub’da ücretsiz barındırın.

Masaüstü uygulamasını indirHub’da ücretsiz yayımla
commerce-api/openapi.yaml OpenAPI 3.1 · yerel dosya
Tek OpenAPI sözleşmesi 
/orders
  post  createOrder
  get   listOrders
/products
  get   listProducts
/customers
  get   listCustomers
Çalıştırılabilir MCP sunucusuna dönüştürüldü · 12 çağrılabilir araç
Kodlama aracınız Cursor · Claude Code · Codex
powerduck · MCP server
powerduck.read_spec() 12 işlem bulundu
powerduck.start_mock("POST /orders") Mock sunucusu 4010 numaralı bağlantı noktasında çalışıyor
powerduck.generate_tests("POST /orders") orders.test.js yazıldı
powerduck.call_api("POST /orders", {total:49}) 200 OK · sözleşmeye göre doğrulandı
powerduck.publish_docs() Başvuru belgeleri güncellendi
Tek bir OpenAPI dosyası, aracınızın çağırdığı araçlara dönüşür: mock’lar, testler, API çağrıları ve belgeler aynı sözleşmeye göre doğrulanır.

Yerel çalışma için hesap gerekmez. Uzak AI seçtiğiniz model hizmetini kullanır; çevrimiçi barındırma için Cloud hesabı gerekir.

Belirtim düzenleyici · API hata ayıklama · Test · Mock · API belgeleri · MCP sunucusu

POWERDUCK HUB

Tek OpenAPI belirtimi. Yerelde geliştirin. Çevrimiçi paylaşın.

API işlerinizi masaüstü uygulamasında yürütün. Belgeleri paylaşmak ve AI araçlarını API’nize bağlamak için Hub’ı kullanın.

  1. 01

    Geliştirin ve doğrulayın

    Powerduck’ta API tasarlayın, hata ayıklayın ve test edin.

  2. 02

    OpenAPI’den yayımlayın

    Belirtiminizi barındırılan belgelere ve bir MCP uç noktasına dönüştürün.

  3. 03

    Paylaşın ve bağlayın

    Belge bağlantısını paylaşın, bir MCP istemcisi bağlayın ve projenizin herkese açık listede görünüp görünmeyeceğini seçin.

Hub’da ücretsiz yayımlaHub’ı keşfet

Plan sınırları içinde ücretsiz barındırma. İş API’niz kendi arka ucunuzda çalışmaya devam eder.

Neden Powerduck?

Bir yığın API aracı yerine tek yerel dosya.

Deponuzdaki tek OpenAPI YAML dosyası tasarımı, hata ayıklamayı, testleri, mock’ları, belgeleri ve MCP’yi yönetir. Kodlama aracılarınız da aynı dosyayı kullanır.

Tek dosya tüm özellikleri yönetir

Aynı OpenAPI belirtiminden tasarlayın, hata ayıklayın, test edin, mock oluşturun, belgeleyin ve MCP sunun; hiçbir şey birbirinden kopmasın.

Diğer yaklaşımlar Ayrı koleksiyon, belge, mock ve test dosyaları
Powerduck Tek YAML tüm araçları ve aracıları yönetir

Her yanıt sözleşmeye göre doğrulanır

Yanıtlar yalnızca gösterilmez, OpenAPI belirtimine göre denetlenir. Yanlış tür veya yol anında yakalanır.

Diğer yaklaşımlar İsteği gönderir ve 200 yanıtını gösterir
Powerduck Yanıt gelir gelmez belirtimden sapma işaretlenir

Yerel öncelikli, hesapsız, aracılara hazır

Dosyalarınız bilgisayarınızda kalır; hesap veya yükleme olmadan çalışın. Codex, Claude Code ve Cursor sizinle aynı belirtimi okur.

Diğer yaklaşımlar Başlamadan önce bulut hesabı ve yükleme gerekir
Powerduck Yerelde çalışır; aracılarınız aynı dosyayı okur
~/commerce-api/openapi.yaml OpenAPI 3.1.0 3 sorun kaydedilmedi
142 /users/{id}:
143 get:
144 operationId: getUser
145 summary: Retrieve a user
146 tags: [Users]
147 parameters:
148 - $ref: '#/components/parameters/UserId'
149 responses:
150 '200':
151 description: The requested user
152 content:
153 application/json:
154 schema:
155 $ref: '#/components/schemas/User'
156 '404': # description is required
157 contents:
158 application/json:
159 schema:
160 $ref: '#/components/schemas/Erorr'
161 delete:
162 summary: Delete a user
Sorunlar 2 hata · 1 uyarı 3.1 lehçesiyle doğrulandı
156:9 contents is not a valid Response Object key. Did you mean content? oas3-schema
160:24 Unresolved $ref — schemas/Erorr does not exist. ref-resolution
162:7 Operation has no operationId. It will be skipped when generating MCP tools. operation-operationId
Satır 156, sütun 9 YAML UTF-8 Boşluk: 2 3.1.0
openapi.yaml dosyasından oluşturulan koleksiyonlar Postman içe aktarma Sözleşme denetimi açık
GET ▾
{{baseUrl}}/users/{{userId}}?include=profile
Hazırlık ortamı ▾
Parametreler1 Kimlik doğrulamasıbearer Başlıklar3 Gövde Betikler Ayarlar
# GET has no requestBody in the specification — body disabled
# Path parameter id resolved from environment → userId = usr_8Kd2Xa
200 OK 148 ms 1.2 KB Sözleşme: 1 uyumsuzluk
Gövde Başlıklar9 Çerezler Sözleşme1 Zaman çizelgesi 
{
  "id": "usr_8Kd2Xa",
  "email": "ada@example.com",
  "created": 1757030400,
  "profile": {
    "name": "Ada L.",
    "locale": "en-GB"
  },
  "scope": "users:read orders:read"
}
Contract mismatch — response differs from the specification scope is present in the response but is not declared on components/schemas/User. Add the property to the schema or remove it from the handler.
mcp://localhost:7433 çalışıyor stdio + HTTP

openapi.yaml dosyasından oluşturuldu

6 araç 7 kaynak 1 kısıtlı Kaydedildiğinde yeniden oluşturulur

Every operation with an operationId becomes a tool. Arguments come from parameters and requestBody. Nothing is hand-written.

POST /auth/login → operationId → loginUser
loginUser

Exchange credentials for a bearer token.

email : string password : string
sağlıklı args from requestBody
GET /users/{id} → operationId → getUser
getUser

Retrieve a single user by identifier.

id : string include? : string
sağlıklı args from 2 parameters
POST /orders → operationId → createOrder
createOrder

Create an order for the authenticated customer.

items : array currency : string
sağlıklı args from requestBody
POST /orders/{id}/refund → operationId → refundOrder
refundOrder

Refund an order in full or in part.

id : string amount? : integer
kısıtlı amount has no description
14:02:11 watch openapi.yaml changed (line 144)
14:02:11 build parsed 3.1.0 · 11 operations · 14 schemas
14:02:11 build 6 araç, 7 resources · 1 skipped (no operationId)
14:02:12 serve listening on stdio and http://localhost:7433
14:02:31 call getUser { id: "usr_8Kd2Xa" } → 200 in 148 ms
docs.example.dev/reference/users/get Statik dışa aktarma Tanımla eşitlenmiş

Retrieve a user

GET /v1/users/{id}

Returns the user object for a valid identifier. If the user has been deleted, an Error object is returned with status 404.

Yol parametreleri
id string Zorunlu
The identifier of the user, prefixed with usr_.
Sorgu parametreleri
include string
Expand a related object.

BİR İŞ AKIŞINDA GÖRÜN

Alışılmış işleri sözleşmeye dayalı akışlara dönüştürün.

Aşağıdan bir görev seçin. Powerduck görevi bilgisayarınızdaki OpenAPI dosyasından yürütür; ortamlar, testler ve mock’lar dahildir. Hesap veya yükleme gerekmez.

Yerel çalışma, eksik özelliklerle çalışmak değildir.

Yerel API çalışma alanınıza hesap veya yükleme olmadan başlayın. İsteklerinizi, kimlik doğrulamanızı, ortamlarınızı ve doğrulamalarınızı kullanın. Çevrimiçi yayımlamak istediğinizde Cloud’u seçin.

  • cURL / Postman / OpenAPI içe aktarma
  • Kimlik doğrulama ve ortamlar
  • Betikler ve doğrulamalar
  • Koleksiyonlar ve senaryo testleri
  • Yerel mock sunucuları
  • 7 protokolde hata ayıklama

Yerel çalışma için hesap gerekmez. Uzak AI seçtiğiniz model hizmetini kullanır; çevrimiçi barındırma için Cloud hesabı gerekir.

Hangi işi artık elle yapmak istemiyorsunuz?

Bu senaryoları keşfedin

API belgelerinin doğru olup olmadığını anlamak için hâlâ kaynak kodu mu okuyorsunuz?

Projeden belge oluşturun.

İncelenebilir bir API tanımı ve yerel belge bağlantısı.

Kurulumu ve gereksinimleri gör

AI’a belirtimi verdiniz ama farklı alanlar ve yollar mı döndü?

Gerçek API sözleşmesine göre geliştirin.

Sözleşmenin yönlendirdiği, gerçek yanıtlarla denetlenmiş bir uygulama.

Kurulumu ve gereksinimleri gör

Her API değişikliğinden sonra aynı iş akışını elle mi tekrarlıyorsunuz?

İş senaryosunun tamamını çalıştırın.

Yalnızca üretilmiş bir test betiği değil; adım adım sonuçlar ve başarısız doğrulamalar.

Kurulumu ve gereksinimleri gör

Sıradaki uç nokta farklı bir protokol kullanıyor diye araç mı değiştiriyorsunuz?

Yedi protokolü tek yerde inceleyin.

Tam olarak ne olduğunu incelemek istediğinizde elle denetim.

Kurulumu ve gereksinimleri gör

AI yardımı gerektiğinde her seferinde istek ve yanıtları sohbete mi kopyalıyorsunuz?

Gerçek istek bağlamıyla inceleyin.

İstek sonuçlarına dayalı tanı ve inceleyebileceğiniz değişiklikler.

Kurulumu ve gereksinimleri gör

Yalnızca API belgelerini ve MCP’yi paylaşmak için ayrı barındırma altyapısı mı yönetiyorsunuz?

Tek API’den belgeler ve MCP yayımlayın.

Kendi barındırma altyapınızı işletmeden barındırılan belgeler ve MCP adresi.

Kurulumu ve gereksinimleri gör

KENDİ BİLGİSAYARINIZDA BAŞLAYIN

İndirin. Kendi ortamınızda çalışın.

Powerduck bir masaüstü API çalışma alanıdır. Yerel dosyanızı açın, ilk isteğinizi gönderin ve hazır olduğunuzda kodlama aracınızı bağlayın. Başlamak için hesap gerekmez.

ANA ÇALIŞMA ALANI

API çalışma tezgâhınız burada.

Yerel dosyalar, kod tarama ve yerel protokol hata ayıklama burada. Tasarım, inceleme veya test için yardım istediğinizde seçtiğiniz AI modelini bağlayın.

  1. 1 Uygulamayı indirin ve yerel örneği deneyin; hesap veya model anahtarı gerekmez.
  2. 2 OpenAPI dosyanızı açın veya mevcut kod tabanını tarayın.
  3. 3 Bir kodlama aracısı bağlayın, kodu değiştirin ve gerçek arka ucu sözleşmeye göre doğrulayın.
Masaüstü uygulamasını indir

macOS 12+ · Windows 10+ · Linux

ÖNCE BİR BAKMAK MI İSTİYORSUNUZ?

Tarayıcıda kısa bir tur atın.

Web demosu ortak bir bulut modeli kullanır ve giriş gerektirir. Hesapsız yerel çalışma için masaüstü uygulamasını indirin.

Web uygulamasını aç

Sözleşme doğrulaması

Gerçek bir sözleşme hatası, ardından doğrulanmış bir düzeltme

Sıradan API istemcileri isteği gönderip yanıtı gösterir. Powerduck ayrıca her yanıtı OpenAPI sözleşmesine göre denetler; belirtimden sapma anında yakalanır.

Çalışan bir örnek gör
~/commerce-api — response check OpenAPI 3.1
Sözleşmenin gerektirdiği
total:
  type: number
Arka uç bir dize döndürüyor 
{
  "total": "49.00"
}
/total sayı olmalı — yanıt sözleşmeye uymuyor
Sayı döndürün 
{
  "total": 49
}
Yanıt sözleşmeye uyuyor

OpenAPI belirtim düzenleyici

OpenAPI Belirtim Düzenleyici

Ana hat görünümü girintilerden tahmin yürütmez; belirtimin gerçek yapısını izler. Yolları ve bileşenleri ağaç yapısında gezin, hataları bulundukları yerde düzeltin.

  • Şemaya göre doğrulama. Dosyanızda bildirilen 3.0, 3.1 veya 3.2 diyalektine göre doğrulayın.
  • $ref başvurularında gezinme. Tanımlara gidin, kullanımları inceleyin ve yanlış yazılmış başvurular için öneriler alın.
  • Dosyayı yerinde düzenleyin. Deponuz tek doğruluk kaynağı olmaya devam eder.
  • Kural adlarıyla tanılama. CI hataları ve düzenleyici tanılamaları aynı terimleri kullanır.
openapi.yaml 3 sorun
▾ info
▾ paths
　/users
　/users/{id}
　/orders
▾ components
　schemas
　responses
142 /users/{id}:
143 get:
144 operationId: getUser
145 responses:
156 contents:
160 $ref: Erorr
Sorunlar · 2 hata · 1 uyarı
156:9 contents is not a valid Response Object key
160:24 Unresolved $ref. Closest match: Error
API hata ayıklama Sözleşme denetimi açık
▾ Users
　GET listUsers
　GET getUser
▾ Orders
　POST createOrder
GET {{baseUrl}}/users/{{userId}} Gönder
Parametreler Kimlik doğrulaması Gövde Başlıklar 
{
  "id": "usr_8Kd2Xa",
  "email": "ada@example.com",
  "scope": "users:read"
}
Contract mismatch — "scope" is not declared on User.

API hata ayıklama

Belirtiminize Göre API Hata Ayıklama

Geliştiricilere tanıdık gelen bir istek oluşturucuya sözleşme tabanlı yanıt doğrulaması ekledik.

  • Yollardan ve etiketlerden koleksiyonlar. İçe aktarma adımı veya elle yeniden eşitleme gerekmez.
  • Her yanıtta sözleşme denetimi. Bildirilmeyen özellikleri, eksik alanları ve tür uyuşmazlıklarını doğrudan yanıtta görün.
  • Ortamlar ve değişkenler. Mevcut geliştirme ve hazırlık ortamı yapılandırmalarını yeniden kullanın.
  • securitySchemes tabanlı kimlik doğrulama. Bearer, API anahtarı ve OAuth yapılandırması belirtimden başlar.

MCP sunucusu oluşturucu

OpenAPI’den MCP Sunucusu Oluşturun

Belirtiminiz araçları tanımlayan bilgileri zaten içerir. Powerduck bunu çalıştırılabilir bir MCP sunucusuna dönüştürür ve her aracın hangi OpenAPI alanlarından üretildiğini gösterir.

  • Kaynağı görünür. Her araç, kaynak işlemine, operationId değerine ve şemasına kadar izlenebilir.
  • Kısıtlı ve atlanan öğeler görünür. Eksik meta veriler, sessizce yetersiz araçlar üretmek yerine açıkça gösterilir.
  • Kaydederken yeniden oluşturma. Belirtimi değiştirin; araçlar ayrı bir derleme adımı olmadan güncellensin.
  • Yerel aktarım seçenekleri. Yerel aracılar ve iş akışları için stdio veya HTTP üzerinden çalıştırın.
mcp://localhost:7433 çalışıyor
openapi.yaml dosyasından oluşturuldu 6 araç 7 kaynak
GET /users/{id} → operationId
getUser
id: string
POST /orders → operationId
createOrder
items: array
POST /auth/login
loginUser
email, password
DELETE /users/{id}
atlandı
operationId eksik
14:02 build 6 tools, 7 resources
14:02 serve listening on :7433
14:03 call getUser → 200
API başvurusu Statik dışa aktarma
Users
Genel bakış
Retrieve a user
List users
Update user

Retrieve a user

GET /v1/users/{id}
Returns the user object for a valid identifier.
Yol parametreleri
id · string · required
Dönüş değeri
User · object
curl /users/{id}

{
  "id": "usr_...",
  "email": "ada@..."
}

API belgesi oluşturucu

Aynı Sözleşmeden API Belgeleri

Doğrudan OpenAPI modelinizden başvuru belgeleri üretin. Statik dosyalara aktarın ve istediğiniz yerde barındırın.

  • Şemalardan parametre tabloları. Zorunluluk işaretleri, enum değerleri ve açıklamalar eşit kalır.
  • Birden fazla dilde örnekler. İşlemlerden cURL, Node, Python ve Go örnekleri üretin.
  • Gerçek sözleşmeden yanıtlar. Başarı ve hata yanıtları, hata ayıklayıcının doğruladığı nesnelerden gelir.
  • Statik dışa aktarma. Çalışma zamanı bağımlılığı veya belirli bir belge platformuna bağlılık yoktur.

Tek doğruluk kaynağı

Tek bir yerel OpenAPI dosyası.
Tüm yetenekler, AI ile birlikte.

Yerel openapi.yaml veya openapi.json dosyanızı açın. Powerduck, sahip olduğunuz sözleşmeyi eksiksiz bir API çalışma alanına dönüştürür. İçe aktarma, dönüştürme, ayrı koleksiyon veya bulut kopyası gerekmez. İstediğiniz sonucu doğal dille anlatın; yerleşik asistan işi inceleyebileceğiniz adımlarla yürütsün. Aynı dosyayı MCP üzerinden AI kodlama aracılarına da sunabilirsiniz.

YERELDE AÇIN
{ }
openapi.yaml
veya openapi.json

Dosya deponuzda kalır.

01 Belirtim düzenleyici

Gerçek sözleşmeyi düzenleyin, gezin ve doğrulayın.

02 API hata ayıklayıcı

Aynı işlemlerden üretilen istekleri gönderin.

03 MCP sunucusu

İşlemleri aracıların kullanabileceği araçlara dönüştürün.

04 API belgeleri

Aynı kaynaktan belgeler yayımlayın.

Powerduck

Bir API istemcisinden fazlası.
Bir belirtim görüntüleyicisinden fazlası.
AI ile API geliştirme alanınız.

OpenAPI dosyasının kendisi etrafında kurulmuş, yerel çalışan ve AI destekli bir çalışma alanı.

BULUT GEREKMEZYerel çalışma için belirtiminizi yüklemeniz gerekmez.
ELLE EŞİTLEME YOKSözleşmeyle eşit tutmanız gereken ayrı içerikler yoktur.
EK KOPYA YOKMevcut YAML veya JSON dosyanız çalışma alanınızdır.

Yerel çalışma, uzak hizmetler ve sizin seçimleriniz

Yerel dosyalar için hesap gerekmez. Uzak AI, ilgili bağlamı yapılandırdığınız sağlayıcıya gönderir; Cloud’a yayımlarken seçtiğiniz içerik yüklenir. İsteğe bağlı kullanım istatistikleri varsayılan olarak kapalıdır. Veri alanları ve denetimler için Gizlilik Politikasına bakın.

Gizlilik Politikası

Yerel kullanım için Cloud satın almanız gerekmez. Ücretsiz kullanım iki belirtim yuvası içerir; onaylanan paylaşım ödülleri bu sayıyı artırabilir. Masaüstü lisansı yuva sınırını kaldırır. Kendi anahtarınızın kullanımını model sağlayıcınız faturalandırır; barındırılan model kredileri ve Cloud barındırma ayrıdır.

Sonraki adımınızı seçin.

Ürünleri ve fiyatları karşılaştır →
Yerel geliştirme

Masaüstü lisansı

Yerel OpenAPI dosyalarıyla, sohbet üzerinden API tasarlayın, hata ayıklayın ve test edin.

Tek seferlik satın alma · süresiz lisans Çevrimiçi yayımlama

Cloud barındırma

Barındırılan API belgelerini ve MCP hizmetlerini ekibinizle ve AI aracılarıyla paylaşın.

Ücretsiz katman · aylık veya yıllık planlar Modelinizi seçin

AI kredileri

Kredi paketiyle barındırılan modelleri kullanın veya masaüstü uygulamasında kendi model sağlayıcınızı yapılandırın.

Ön ödemeli model kredileri

Sık sorulan sorular

Geliştiricilerin ilk sorduğu sorular

Yerel dosyalar, OpenAPI sürümleri, MCP üretimi ve lisanslama hakkında pratik bilgiler.

Powerduck, OpenAPI belirtimimi bir yere yükler mi?

Yerel dosyalar için hesap gerekmez. Uzak AI, ilgili bağlamı yapılandırdığınız sağlayıcıya gönderir; Cloud’a yayımlarken seçtiğiniz içerik yüklenir. İsteğe bağlı kullanım istatistikleri varsayılan olarak kapalıdır. Veri alanları ve denetimler için Gizlilik Politikasına bakın.

Hangi OpenAPI sürümleri destekleniyor?

OpenAPI 3.0, 3.1 ve 3.2. Powerduck, bildirilen sürümü algılar ve en düşük ortak özellik kümesi yerine uygun diyalekte göre doğrular.

MCP sunucusu nasıl oluşturuluyor?

operationId içeren işlemler MCP araçlarına dönüşür. Bağımsız değişkenler parametrelerden ve requestBody şemalarından türetilir. Bileşen şemaları kaynak olarak sunulabilir. Oluşturulan sunucu, belirtim her değiştiğinde güncellenir.

Masaüstü lisansı bir abonelik mi?

Hayır. Powerduck Desktop tek seferlik satın alınan süresiz bir lisanstır. Aynı ana sürüm içindeki güncellemeler dahildir. Gelecekteki ana sürüm yükseltmeleri isteğe bağlıdır.

Postman koleksiyonlarımı kullanmaya devam edebilir miyim?

Evet. Mevcut koleksiyonlar ve ortamlar kullanılmaya devam edebilir. Powerduck, OpenAPI belirtimini esas sözleşme olarak alır ve isteklerin bu sözleşmeden nerede saptığını bulmanıza yardımcı olur.

CI’da çalışır mı?

Evet. Aynı doğrulama ve üretim motoru @powerduck/openapi-cli aracılığıyla sunulur. Bu CI uyumlu komut satırı aracı, pull request’lerde ve otomatik işlem hatlarında çalışır. Altı protokolde (HTTP, SSE, WebSocket, gRPC, MCP, GraphQL) toplu test, ayarlanabilir eşzamanlılık ve CI entegrasyonu için JUnit uyumlu raporları destekler.

openapi-cli’yi keşfet →