API ÖNCELİKLİ TASARIM EĞİTİMİ

Önce sözleşmeyi, sonra kodu yazın

API-first süreç, OpenAPI ile tasarım, mock sunucuyla paralel geliştirme, sözleşme testi ve sürümleme

API-first süreç, OpenAPI ile tasarım, mock sunucuyla paralel geliştirme, sözleşme testi ve sürümleme. API öncelikli tasarım süreci odağında uygulamalı laboratuvarlarla işlenir.

3 gün Orta Seviye Online / Yüz Yüze / Hibrit Sertifikalı

Eğitim Hakkında

API öncelikli tasarım süreci

Eğitim API-first yaklaşımını tasarım atölyeleriyle öğretir. Kullanıcı yolculuğundan kaynak modeli çıkarma, URI ve veri modeli, problem+json hata yapısı, OpenAPI 3 ile sözleşme, Spectral ile stil kuralları, Postman mock sunucusuyla istemci geliştirme, tüketici sözleşme testi, sürümleme ve deprecation, OAuth 2.0 şeması ve geliştirici portalı uygulamalı işlenir.

Süre ve Format

3 Gün. Her gün dört modül; 1. gün API-First Yaklaşımı ve Kaynak Tasarımı; 2. gün Model, Hata ve Sözleşme; 3. gün Evrim, Doğrulama ve Yönetim.

Seviye

Orta Seviye — API öncelikli tasarım süreci

Öğrenme Metodu

Her konu, gerçek bir API üzerinde istek göndererek ve tasarım kararlarını tartışarak işlenir; katılımcılar OpenAPI tanımı yazıp Postman ve curl ile sonuçlarını doğrular.

Neden Bu Eğitim?

📐Tasarım Kuralları

HTTP semantiği, URI ve model kararlarını standartlara dayandırarak tutarlı API'ler tasarlarsınız.

🔍Canlı İnceleme

Gerçek istek ve yanıtları curl ve Postman ile inceleyerek teoriyi hemen pratiğe dökersiniz.

📄Sözleşme Odaklılık

OpenAPI ile yazılan sözleşme sayesinde ekipler arası uyumu ve dokümantasyonu otomatikleştirirsiniz.

Anahtar Konular

rest apirestful apiapi tasarımıopenapiswaggerhttp metotlarıjsonapi geliştirmeapi öncelikli tasarım
“Sözleşme yazılmadan başlayan iş, tahmine dayanır.”

Ön Koşullar

Eğitimden verim almak için faydalı olacak bilgi ve ortam gereksinimleri

1
Programlama Temeli

Herhangi bir dilde temel programlama bilgisi ve JSON okuyabilme becerisi yeterlidir.

2
Web Bilgisi

Tarayıcı, URL ve HTTP'nin kabaca nasıl çalıştığına dair temel fikir faydalıdır.

3
Araçlar

Postman, curl ve bir metin editörü (VS Code) kurulu bir bilgisayar gerekir.

4
Merak

Örnek API'ler üzerinde deneme yapmaya açık olmak yeterli ön koşuldur.

Eğitim İçeriği

Programın gün gün akışı aşağıdadır. Bir güne tıklayarak o günün modüllerini ve içeriklerini görebilirsiniz.

Günün hedefiKatılımcı gün sonunda API Öncelikli Tasarım Süreci konusunu çalıştırır, API Stratejisi ve Ürün Yaklaşımı ve REST Mimari İlkeleri ile ilerleyip URI Tasarımı ve Kaynak Modelleme kararlarını gerekçelendirir.
Modül 1
API Öncelikli Tasarım Süreci
  • API-first ve code-first yaklaşımları: ekipler arası paralel çalışma avantajı
  • Kullanıcı yolculuğundan (user journey) kaynak ve işlem listesinin çıkarılması
  • Sözleşmeyi önce yazıp mock sunucudan istemci geliştirmeyi başlatma
  • Tasarım gözden geçirme (API review) oturumu ve stil rehberi oluşturma
  • Spectral kuralları ve CI içinde sözleşme lint'i
  • Breaking change tespiti için openapi-diff ve sözleşme sürüm kontrolü
Modül 2
API Stratejisi ve Ürün Yaklaşımı
  • API'yi ürün olarak ele alma: hedef geliştirici, değer önerisi ve yol haritası
  • İş hedeflerinden API portföyüne: iç, partner ve genel API kümeleri
  • Gelir modelleri: kullanım bazlı, kademeli paket ve freemium
  • Geliştirici deneyimi (DX): ilk çağrıya kadar geçen süre ve örnek kodlar
  • API yönetişimi: stil rehberi, katalog ve sahiplik modeli
  • Başarı metrikleri: benimseme, aktif uygulama sayısı, hata oranı, gecikme
Modül 3
REST Mimari İlkeleri
  • Fielding'in altı kısıtı: istemci-sunucu, durumsuzluk, önbellek, tek tip arayüz, katmanlı sistem, isteğe bağlı kod
  • Kaynak (resource) odaklı düşünme ve temsil (representation) kavramı
  • Richardson Olgunluk Modeli seviye 0-3
  • Tek tip arayüz: kaynak tanımlama, temsil üzerinden manipülasyon, öz-açıklayıcı mesaj
  • Durumsuzluk (stateless) ve oturum bilgisinin istemcide veya token'da taşınması
  • REST ile RPC tarzı API'lerin karşılaştırılması
Modül 4
URI Tasarımı ve Kaynak Modelleme
  • İsim tabanlı çoğul koleksiyon adları: /orders, /orders/{id}/items
  • İlişkili kaynaklar için iç içe yol ve sorgu parametresi tercihleri
  • Kaynak olmayan işlemler için eylem kaynakları (ör. /orders/{id}/cancellation)
  • Büyük/küçük harf, tire ve snake_case kuralları; sondaki eğik çizgi
  • Yol parametresi ile sorgu parametresi arasındaki ayrım ve filtre tasarımı
  • URI sürümleme ile başlık sürümlemenin kıyaslanması
Günün hedefiKatılımcı REST API Veri Modelleri ve Hata Yönetimi ve Problem Details konularını uygulayarak OpenAPI ile Sözleşme ve Dokümantasyon ile Postman Mock Sunucuları adımlarını aynı örnek üzerinde birleştirir.
Modül 1
REST API Veri Modelleri
  • JSON veri tipleri, null / eksik alan ayrımı ve tarih için ISO 8601 / RFC 3339
  • JSON Schema ile doğrulama: required, enum, pattern, oneOf
  • DTO ile alan modeli ayrımı ve verinin aşırı açığa çıkmasının önlenmesi
  • HAL, JSON:API ve Siren gibi hipermedya biçimlerinin karşılaştırılması
  • Para birimi, zaman dilimi ve çok dilli metin için model kararları
  • XML, Protocol Buffers ve MessagePack temsillerinin JSON ile kıyaslanması
Modül 2
Hata Yönetimi ve Problem Details
  • RFC 9457 / 7807 application/problem+json yapısı: type, title, status, detail, instance
  • Doğrulama hatalarında alan bazlı hata listesi biçimi
  • 4xx ile 5xx ayrımı: istemci hatası ile sunucu hatası sorumluluğu
  • Hata mesajlarında bilgi sızıntısını önleme (stack trace, SQL ifadesi)
  • İstek kimliği (correlation ID) ile hata yanıtlarının loglarla eşleştirilmesi
  • 429 Too Many Requests ve Retry-After ile istemci geri çekilme (backoff) yönlendirmesi
Modül 3
OpenAPI ile Sözleşme ve Dokümantasyon
  • OpenAPI 3.x yapısı: paths, components, schemas, parameters, responses
  • $ref ile yeniden kullanım, allOf / oneOf ve discriminator
  • securitySchemes: apiKey, http bearer, oauth2 ve openIdConnect
  • Swagger Editor ve Stoplight ile tasarım, Spectral ile kural tabanlı lint
  • openapi-generator ile sunucu iskeleti ve istemci SDK'sı üretimi
  • Örnek (example) alanları ve Redoc ile geliştirici dokümanı yayınlama
Modül 4
Postman Mock Sunucuları
  • Mock server oluşturma: collection'dan ve örnek yanıtlardan (examples) üretim
  • Örnek eşleştirme kuralları, yanıt gecikmesi ve statik hata yanıtları
  • Frontend ekibinin gerçek API hazır olmadan mock ile geliştirme yapması
  • Mock URL'sinin environment değişkeniyle gerçek sunucuyla değiştirilmesi
  • OpenAPI tanımından mock türetme
  • Mock'un sözleşmeden sapmasını önlemek için örneklerin güncel tutulması
Günün hedefiKatılımcı gün sonunda Sürümleme ve API Evrimi konusunu çalıştırır, API Sözleşme Testi ve OAuth 2.0, JWT ve API Yetkilendirme ile ilerleyip Geliştirici Portalı ve Para Kazanma kararlarını gerekçelendirir.
Modül 1
Sürümleme ve API Evrimi
  • Kırıcı (breaking) ve kırıcı olmayan değişikliklerin sınıflandırılması
  • URI, başlık (Accept vendor media type) ve sorgu parametresiyle sürümleme
  • Alan ekleme, alan kaldırma ve alan yeniden adlandırma stratejileri
  • Deprecation ve Sunset başlıkları (RFC 8594) ile emeklilik duyurusu
  • Tolerant reader ilkesi ve tüketici uyumluluğu
  • Sürümler arası kullanım izleme ve geçiş takvimi planlama
Modül 2
API Sözleşme Testi
  • Sözleşme testi kavramı: sağlayıcı (provider) ve tüketici (consumer) beklentileri
  • OpenAPI şemasını Postman'a bağlayıp yanıt doğrulaması yapma
  • JSON Schema ile zorunlu alan, tip ve enum kontrolü
  • Geriye dönük uyumluluk bozan değişikliklerin tespiti
  • Pact ile tüketici güdümlü sözleşme testlerine karşılaştırma
  • Sözleşme testlerini CI hattına bağlayıp sürüm kapısı olarak kullanma
Modül 3
OAuth 2.0, JWT ve API Yetkilendirme
  • Authorization Code + PKCE, Client Credentials ve Refresh Token akışları
  • JWT yapısı: header, payload, imza; RS256 ve HS256 farkı
  • JWT zafiyetleri: alg=none, zayıf anahtar, süresi dolmuş token kabulü
  • Scope ve claim tabanlı yetkilendirme, RBAC ve ABAC
  • Token iptali, kısa ömürlü access token ve rotasyon
  • Keycloak ile yetkilendirme sunucusu kurulumu ve API entegrasyonu
Modül 4
Geliştirici Portalı ve Para Kazanma
  • Geliştirici portalı bileşenleri: katalog, dokümantasyon, kayıt, anahtar alma
  • API ürünleri, planlar ve abonelik onay akışı
  • Kullanım bazlı faturalama ve kota planları ile monetization
  • Sandbox ortamı ve test verisiyle geliştirici ilk deneyimi
  • Portal için SEO, örnek kod ve sürüm notu içerikleri
  • Geliştirici destek süreci ve geri bildirim döngüsü

Eğitim Kazanımları

Program sonunda katılımcılar:

✅
API-First Çalışma

Sözleşmeyi koddan önce tasarlayan bir API-first iş akışını ekibinize uygulayabilirsiniz.

🧩
REST İlkeleri

REST kısıtlarını ve olgunluk modelini kullanarak bir API'nin tasarım kalitesini değerlendirebilirsiniz.

🔧
URI Tasarımı

Tutarlı, okunabilir ve genişletilebilir URI şemaları tasarlayabilirsiniz.

📐
Hata Yönetimi

Tutarlı problem+json hata yanıtları üretip istemcilerin hatadan toparlanmasını kolaylaştırabilirsiniz.

🛡️
OpenAPI Sözleşmesi

OpenAPI ile makine okunur API sözleşmesi yazıp kod ve doküman üretebilirsiniz.

🧪
API Evrimi

Kırıcı değişiklikleri yönetip API'nizi tüketicileri bozmadan geliştirebilirsiniz.

🚀
Sözleşme Testi

API yanıtlarının sözleşmeyle uyumunu otomatik doğrulayan testler yazabilirsiniz.

📊
Geliştirici Portalı

Geliştirici portalı, plan ve abonelik yapısıyla API'leri dış kullanıcılara sunabilirsiniz.

Kimler İçin Uygundur?

  • API tasarımcıları
  • mimarlar
  • ürün sahipleri
  • frontend
  • backend ekipleri içindir

Sıkça Sorulan Sorular

Bu eğitim kimler için uygundur?
API tasarımcıları, mimarlar, ürün sahipleri, frontend ve backend ekipleri içindir.
Hangi dil ve çatı kullanılıyor?
Tasarım ilkeleri dilden bağımsızdır; uygulama örnekleri OpenAPI, Postman ve seçilen bir sunucu çatısı üzerinden gösterilir.
Hazır API mi kullanılacak, yoksa kendimiz mi yazacağız?
Her ikisi de; hazır genel API'lerle başlanır, ardından kendi örnek API'nizi tasarlayıp sözleşmesini yazarsınız.
Eğitim sonunda ne öğrenmiş olacağım?
Tutarlı bir REST API tasarlayıp OpenAPI ile belgeleyebilir, hata, sürümleme ve güvenlik konularında karar verebilirsiniz.
Sertifika veriliyor mu?
Evet, tamamlayan katılımcılara Digital Vizyon Akademi Katılım ve Başarı Sertifikası verilir.

Sertifikalandırma

Bu eğitim Digital Vizyon Akademi Başarı Sertifikası ile tamamlanır.

Eğitim başında “Ön Test”, bitiminde “Son Test” uygulanarak gelişim ölçümlenir. Değerlendirme formunu dolduran katılımcılar sertifikalarını alır. Sertifikanızın geçerliliğini Sertifika Sorgulama sayfasından doğrulayabilirsiniz.

Örnek Sertifika d Digital Vizyon AKADEMİ KATILIM SERTİFİKASI Bu sertifika [Katılımcı Adı Soyadı] adlı katılımcının aşağıdaki eğitim programını başarıyla tamamladığını belgeler. API Öncelikli Tasarım Eğitimi Sertifika Kodu DV-2026XX00 Tarih 27.10.2026 Yetkili İmza DV AKADEMİ

Eğitim Bilgileri

Süre3 gün
SeviyeOrta Seviye
FormatOnline / Yüz Yüze / Hibrit
Sertifika✓ Var
Hemen Bilgi Al
İlgili Eğitimler

Bu Eğitimle Birlikte Tercih Edilenler

API ve Mikroservis MimarisiWrenAI API ile Yapılandırma: Uygulamalar, Grafikler ve NL'den SQL'e Eğitimi
Yazılım Geliştirme Eğitimleri

WrenAI API ile Yapılandırma: Uygulamalar, Grafikler ve NL'den SQL'e Eğitimi

2 günİleriOnline / Yüz Yüze / Hibrit

WrenAI API eğitimi: Docker kurulumu, MDL semantik model, LLM yapılandırması, doğal dilden SQL üretimi, grafik oluşturma ve API ile uygulama entegrasyonu.

Detayları Gör →
API ve Mikroservis MimarisiKapsamlı Mikroservis Mimarisi Eğitimi
Yazılım Geliştirme Eğitimleri

Kapsamlı Mikroservis Mimarisi Eğitimi

4 günİleriOnline / Yüz Yüze / Hibrit

Domain-driven sınırlar, Kafka, saga, Kubernetes ve OpenTelemetry konularını uygulamalı işleyen kapsamlı mikroservis mimarisi eğitimi.

Detayları Gör →
API ve Mikroservis MimarisiMicroservices Development in Windows Eğitimi
Yazılım Geliştirme Eğitimleri

Microservices Development in Windows Eğitimi

3 günOrtaOnline / Yüz Yüze / Hibrit

Windows, Docker Desktop, WSL2 ve ASP.NET Core ile mikroservis geliştirme, test, konteynerleştirme ve Kubernetes dağıtımı eğitimi.

Detayları Gör →
API ve Mikroservis MimarisiMicroservices Eğitimi
Yazılım Geliştirme Eğitimleri

Microservices Eğitimi

3 günTemelOnline / Yüz Yüze / Hibrit

Mikroservis kavramı, servis sınırları, saga, circuit breaker, Docker ve Kubernetes dağıtımını temelden öğreten uygulamalı eğitim.

Detayları Gör →
API ve Mikroservis MimarisiMicroservices ile Reactive Programming Eğitimi
Yazılım Geliştirme Eğitimleri

Microservices ile Reactive Programming Eğitimi

3 günİleriOnline / Yüz Yüze / Hibrit

Reactor, Spring WebFlux, R2DBC, backpressure ve reactive Kafka ile engellemesiz mikroservis geliştirme ve test eğitimi.

Detayları Gör →
+90 (501) 369 40 14 WhatsApp [email protected] LinkedIn