API Designer

API'yi tasarlayın. Proxy'yi yayına alın. Arada tek tık var.

Elle YAML yazmadan OpenAPI oluşturun, elinizdekini içe aktarın ve spec'i tek tıkla aynı gateway üzerinde canlı, yönetişim altında bir API'ye dönüştürün. Aynı spec; Portal'daki Swagger UI'ı, JSON, YAML, PDF, HTML ve Markdown çıktılarını besler — tüketicilerinizin konuştuğu her dilde.

  • SpesifikasyonlarOpenAPI 3 · Swagger 2 · WSDL
  • ÇıktıCanlı API Proxy + Portal dokümantasyonu
  • Çift yönlüSpec ↔ Proxy senkron

Yetenekler · derinlemesine

Bir OpenAPI spesifikasyonunu canlı, yönetilen bir API'ye dönüştüren sekiz özellik.

YAML boğuşması olmadan görsel spec düzenleme, iki başlangıç yolu, tek tıkla API Proxy üretimi, çift yönlü senkron, WSDL modernizasyonu, anında çok formatlı dokümantasyon, spec-as-code akışları ve Portal'a otomatik yayın — her özellik gerçek bir Apinizer yeteneğidir, yol haritası vaadi değil.

01 · Görsel spec düzenleme

Elle YAML yazmadan OpenAPI oluşturun.

Spec'i, bir API'yi düşündüğünüz gibi düzenleyin — endpoint'ler, istek gövdeleri, yanıtlar, veri modelleri — yanında canlı YAML veya JSON görünümü olan yönlendirmeli bir editörde. Hatalar siz yazarken yakalanır ve aynı ekran, tüketicilerin Portal'da göreceğini birebir önizler.

  • Yan yana tasarım ve kod görünümü — istediğiniz an geçiş yapın
  • Endpoint'ler, parametreler, header'lar, istek gövdeleri, yanıtlar — hepsi birinci sınıf
  • Özellikleri, örnekleri ve doğrulama kurallarıyla yeniden kullanılabilir veri modelleri
  • Siz yazarken OpenAPI Spesifikasyonu'na karşı anında doğrulama
  • Geliştirme, test ve üretim taban URL'leri için çoklu sunucu tanımları
  • İletişim, lisans ve hizmet koşulları aynı ekranda tutulur
  • Spec düzeyinde kimlik doğrulama kurulumu — ayrı bir iş akışı yok
  • Uzun spec'leri path'e veya veri modeline göre filtreleyin — büyük API'ler için tasarlandı
  • Design view
  • Code view
  • Live validation
  • Data models
  • Multi-server
Apinizer Spec Designer — left sidebar with API Overview, Paths, and Data Models; main canvas showing the GET /orders/{id} operation with parameters, request body, and a 200 response; right panel showing the live YAML view; validation chip at the bottom reporting zero errors.

02 · Başlamanın iki yolu

Sıfırdan başlayın — ya da elinizdekini getirin.

Designer'ı açın ve bir başlangıç noktası seçin. Boş bir API ile başlayıp endpoint endpoint inşa edin ya da bir URL'den veya dosyadan mevcut bir spec'i içe aktarıp başkasının bıraktığı yerden devam edin. OpenAPI 3, Swagger 2 ve WSDL aynı editöre iner.

  • Boş API — temiz bir spec ile başlayın, ilerledikçe büyütün
  • URL'den içe aktarma — editör spec'i sizin için çeker ve ayrıştırır
  • Dosyadan içe aktarma — YAML, JSON veya WSDL dosyası bırakın
  • Uçtan uca OpenAPI 3.0.x desteği
  • Swagger 2.x desteklenir; tek işlemle OpenAPI 3'e yükseltilebilir
  • WSDL içe aktarımları otomatik olarak OpenAPI yüzeyine dönüştürülür
  • Mevcut spec'in üzerine yeniden içe aktarma — özelleştirmeleriniz korunur
  • İçe aktarılan değişikliği uygulamadan önce yan yana diff
  • Blank API
  • Import from URL
  • Import from file
  • OpenAPI 3
  • Swagger 2
  • WSDL
Two large start cards — Blank API on the left with a plus icon, Import API Spec on the right with URL and File sub-options — surrounded by chips for OpenAPI 3, Swagger 2.x, and WSDL.

03 · Tek tıkla API Proxy

Spec bir YAML dosyasında kalmaz. Tek tık — ve canlı, yönetişim altında bir API.

Diğer tüm tasarım araçları, sonradan gateway'inize kendinizin bağlaması gereken bir YAML dosyası üretir. Apinizer bu adımı ortadan kaldırır. Create API Proxy'ye basın; spec gerçek, çalışan, tam yönetişimli bir API'ye dönüşür — endpoint'ler, metotlar, istek ve yanıt şemaları bir Worker pod'una eşlenir ve diğer tüm Apinizer API'lerini koruyan aynı kimlik doğrulama, hız limiti, denetim ve analitik yığınının arkasına yerleşir.

  • Tek işlem, spec'i gateway üzerinde canlı bir API Proxy'ye dönüştürür
  • Her path yönlendirilebilir bir endpoint, her metot bir operasyon olur
  • Çalışma anında doğrulama için istek ve yanıt şemaları bağlanır
  • Elle kurulmuş bir proxy ile aynı politika yığını — kimlik doğrulama, kısıtlama, denetim, analitik
  • Aynı gözlemlenebilirlik — her çağrı, tam istek bağlamıyla kaydedilir
  • Ortamı proxy oluşturulurken seçin — geliştirme, test veya üretim
  • Trafiği, diğer tüm Apinizer API'leriyle aynı Worker pod'ları üzerinden yönlendirir
  • Tasarımdan canlı endpoint'e saniyeler içinde — ayrı bir deploy pipeline'ı yok
  • One click
  • Full proxy
  • All endpoints
  • All schemas
  • Same gateway
  • Same policies

AI için aynı şerit

Proxy oluşturulurken MCP'yi açın; AI agent'lar yeni API'yi canlıya alındığı anda keşfeder — ikinci bir yayımlama adımı yok.

Spec card on the left with a YAML preview, a single Create API Proxy button in the middle with a dashed arrow, and an API Proxy card on the right listing four endpoints with HTTP methods — showing the spec turn into a live, governed API in one step.

04 · Senkron kalın

Spec'i düzenleyin. Proxy takip etsin. Kopyala-yapıştır yok.

Bir spec'i değiştirdiğinizde — path ekleyin, alan yeniden adlandırın, şema güncelleyin — bağlı API Proxy değişikliği otomatik devralır. Endpoint'ler, metotlar ve şemalar hizalı kalır. Elle bağladığınız politikalar yerinde durur. Sapma yok, paralel dosyalar yok, spec'in söylediğiyle üretimin gerçekte sunduğu arasında elle mutabakat yok.

  • Spec'i yeniden uygulayın; proxy yerinde güncellensin
  • Endpoint'ler, metotlar ve şemalar spec'ten yeniden senkronlanır
  • Bağlı politikalar — kimlik doğrulama, kısıtlama, mediation — korunur
  • Spec ve proxy tek bir tanımlayıcıyı paylaşır — asla iki doğruluk kaynağı olmaz
  • Yeniden senkron üretime inmeden önce isteğe bağlı onay adımı
  • Spec'i geri alın, proxy de geri alınsın — tek operasyon
  • Her spec değişikliğinde sürüm geçmişi
  • Aynı spec'i geliştirme, test ve üretim ortamları boyunca terfi ettirin
  • Auto-sync
  • No drift
  • Policies preserved
  • Versioned
  • Promote across environments
Spec editor on the left showing a diff with a new path highlighted, an arrow labeled Re-apply in the middle, and the same API Proxy on the right gaining the new endpoint — with the existing policy stack pinned above the proxy and unchanged.

05 · Eski sistemleri ileri taşıyın

Bir WSDL bırakın. Modern bir OpenAPI yüzeyi alın.

Çoğu kurum, hiçbir yere gitmeyecek uzun bir SOAP servisleri kuyruğunun üzerinde oturur. Designer, bir WSDL'i — URL veya dosyayla — alır ve özgün operasyonlara eşlenmiş bir OpenAPI spec'i üretir. Sonrası aynı tek tık akışıdır: SOAP backend'in önüne bir REST proxy'si çıkarın, Portal'da belgeleyin ve yeni tüketiciler eski sözleşmelere takılmadan ilerlesin.

  • WSDL'i URL veya dosya olarak bırakın
  • Operasyonlar, tipler ve fault'lar OpenAPI yüzeyine eşlenir
  • SOAP servisinin önünde bir REST proxy'si üretin — SOAP-as-REST
  • Mevcut SOAP tüketicilerine dokunulmaz — yeni tüketiciler REST'e geçer
  • Çift yönlü düzenleme — WSDL hizasını kaybetmeden OpenAPI tarafını düzenleyin
  • Aynı Designer tuvali — öğrenilecek ayrı bir WSDL aracı yok
  • Dokümantasyon, Portal'da diğer tüm API'ler gibi görüntülenir
  • Mediation'ı gateway üstlenir — bakımı yapılacak ara servisler yok
  • WSDL import
  • SOAP-as-REST
  • Round-trip editing
  • Legacy modernization
WSDL document on the left, a conversion arrow with a WSDL to OpenAPI label in the middle, and a REST endpoint surface on the right — with a small Portal preview card showing the converted API ready for consumers.

06 · Dokümantasyon, anında

Her spec kendi dokümantasyonuyla gelir — ekibinizin ihtiyaç duyduğu her formatta.

Dokümantasyon artık ayrı bir proje değil. Aynı spec; Portal içindeki Swagger UI görünümünü besler, araç uyumluluğu için JSON veya YAML'a dışa aktarılır ve hukuk ya da iş ortağı ekibi istediğinde PDF, HTML veya Markdown olarak paketlenir. Türkçe ve İngilizce varsayılan olarak gelir; üçüncü bir dil tek anahtar uzağınızdadır.

  • API Portal içinde canlı Swagger UI görünümü
  • Ham spec'i herhangi bir harici araç için JSON veya YAML olarak dışa aktarın
  • İş ortakları, denetçiler veya satın alma için PDF ya da HTML olarak dışa aktarın
  • İç wiki'niz veya geliştirici merkeziniz için Markdown olarak dışa aktarın
  • Aynı spec'ten üretilen Türkçe ve İngilizce dokümantasyon
  • Üçüncü dili tek anahtarla ekleyin — ek yazım işi yok
  • cURL ve popüler diller için otomatik üretilen kod örnekleri
  • Spec yeniden uygulandığı anda dokümantasyon güncellenir — asla bayatlamaz
  • Swagger UI
  • JSON · YAML
  • PDF · HTML · Markdown
  • Turkish + English
  • Code samples
Portal documentation page on the left with a Swagger UI render of an endpoint, a stack of export chips labeled JSON, YAML, PDF, HTML, Markdown in the middle, and a language toggle showing Turkish and English on the right.

07 · Spec-as-code

API sözleşmenize kod tabanınızın geri kalanı gibi davranın.

OpenAPI düz YAML veya JSON'dur — ve Designer, ekibinizin zaten kullandığı kaynak kontrol iş akışıyla uyum içinde çalışacak şekilde tasarlanmıştır. Spec'i deponuzda diff'leyin, CI'da doğrulayın, APIops üzerinden gönderin. API sözleşmelerinde pull request incelemeleri, koddaki incelemelerle aynı şekilde işler.

  • Spec düz YAML veya JSON olarak saklanır — doğası gereği diff dostu
  • Spec'leri CI'da doğrulayın — bozuk sözleşmeleri merge edilmeden reddedin
  • APIops apply spec'i gönderir — arayüzle aynı kimlik doğrulama, aynı denetim
  • İncelenmiş spec'i pipeline'ınız üzerinden geliştirmeden üretime terfi ettirin
  • Yalnızca ara kodda değil, API sözleşmelerinde de pull request incelemesi
  • Sürümleme deponuzda yaşar — paralel bir sürüm kaydı yok
  • Şablonlar ve ortak şemalar birden çok spec'te yeniden kullanılabilir
  • API sözleşmelerinde branch korumaları — sürpriz kırıcı değişiklik yok
  • YAML · JSON
  • Diff-friendly
  • Validate in CI
  • APIops apply
  • Promote through pipeline
Git diff view on the left with added and removed lines on an OpenAPI spec, a CI status panel in the middle showing a passing validation step, and an APIops apply card on the right pushing the spec to a target environment.

08 · Proxy canlıya alındığı anda katalogda

Editörden çalışan bir Try-It konsoluna saniyeler içinde.

Proxy canlıya alındığında, kaynağı olan spec Portal katalog sayfasını zaten besliyordur. Tüketiciler yeni API'yi aramada bulur, dokümantasyonu açar ve doğru kimlik doğrulama akışı bağlanmış hâlde bir Try-It çağrısı çalıştırır — kimse elle bir şey yayımlamadan. İnsanlar ve AI agent'lar yeni API'yi aynı yüzeyde keşfeder.

  • Proxy canlıya alındığı anda API Portal'da otomatik yayım
  • Katalog girdisi, arama indeksleme ve kategori yerleşimi sizin yerinize yapılır
  • Try-It konsolu doğru kimlik doğrulama akışına otomatik bağlanır
  • Sürümleme, kullanımdan kaldırma rozetleri ve değişiklik günlükleri tüketicilere sunulur
  • İnsan geliştiriciler ve MCP üzerinden AI agent'lar için aynı yüzey
  • Kitle başına görünürlük seçin — açık, yalnızca oturum açanlar veya onaylı iş ortakları
  • Kod örnekleri en güncel spec'ten yeniden üretilir
  • Abonelik ve kimlik bilgisi akışı Portal'dan devralınır — bağlanacak bir şey yok
  • Auto-publish
  • Try-It console
  • Auth-aware
  • Versioning
  • Same surface for AI agents

AI için aynı şerit

Bu spec'in indiği Portal kataloğu, AI agent'ların MCP üzerinden gezdiği katalogla aynıdır — tek tasarım geçişi, iki kitle.

Designer card on the left, an arrow labeled One spec, one click in the middle, and a Portal catalog card on the right showing the API title, version, an Authorize button, an endpoint list, and a green Try It Out badge.

Pakete dahil

Neler dahil

Aşağıdaki yetenekler standart kurulumun parçasıdır — ek SKU'lar ve ayrı lisanslar yoktur.

Oluşturma

  • Yan yana tasarım ve kod görünümü
  • OpenAPI 3.0.x ve Swagger 2.x
  • Anında doğrulamalı YAML ve JSON formatları
  • Özellikleri ve örnekleriyle yeniden kullanılabilir veri modelleri
  • Geliştirme, test ve üretim için çoklu sunucu tanımları
  • Spec düzeyinde kimlik doğrulama ve güvenlik kurulumu
  • Uzun spec'leri path'e veya veri modeline göre filtreleme
  • Boş API ile ya da URL'den veya dosyadan içe aktararak başlama

Çıktı ve entegrasyon

  • Aynı gateway üzerinde tek tıkla API Proxy üretimi
  • Politikaları koruyan spec-proxy çift yönlü senkronizasyonu
  • SOAP-as-REST sunumuyla WSDL içe aktarma
  • Try-It konsoluyla API Portal'da otomatik yayım
  • Swagger UI görünümü; JSON, YAML, PDF, HTML, Markdown dışa aktarma
  • Varsayılan olarak Türkçe ve İngilizce dokümantasyon
  • cURL ve popüler diller için kod örnekleri
  • Spec-as-code iş akışlarıyla APIops apply

Tasarımdan çalışma ortamına

Bir kez tasarlayın. YAML'ı değil, API'yi yayına alın.

Designer'ın bir OpenAPI spec'ini canlı, yönetişim altında bir proxy'ye dönüştürmesini izleyin — Portal dokümantasyonu, Try-It ve Swagger UI, yayına alındığı anda hazır.