API DESIGN: API STRATEGY & DESIGN EĞİTİMİ

Stratejiyle başlayan API tasarımı

API'leri iş hedeflerine bağlayan strateji, yaşam döngüsü, tasarım standartları ve ürünleştirme yaklaşımı

API'leri iş hedeflerine bağlayan strateji, yaşam döngüsü, tasarım standartları ve ürünleştirme yaklaşımı. API stratejisinden tasarım standartlarına odağında uygulamalı laboratuvarlarla işlenir.

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

Eğitim Hakkında

API stratejisinden tasarım standartlarına

Eğitim API tasarımını iş stratejisiyle birlikte ele alır. API-as-a-product yaklaşımı, API portföyü ve yaşam döngüsü, API-first süreç, stil rehberi ve Spectral lint, kaynak ve URI modelleme, veri modeli ve sürümleme kararları, problem+json hata yanıtı, OpenAPI sözleşmesi, OAuth 2.0 güvenliği, geliştirici portalı ve kullanım metrikleri uygulamalı işlenir.

Süre ve Format

3 Gün. Her gün dört modül; 1. gün Strateji, Yaşam Döngüsü ve API-First; 2. gün Kaynak, Veri ve Evrim Tasarımı; 3. gün Sözleşme, Güvenlik ve Ürünleştirme.

Seviye

İleri Seviye — API stratejisinden tasarım standartlarına

Öğ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 design: api strategy & design
“Strateji yoksa API, sadece uç noktalar yığınıdı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 Stratejisi ve Ürün Yaklaşımı konusunu çalıştırır, API Yaşam Döngüsü Yönetimi ve API Öncelikli Tasarım Süreci ile ilerleyip REST Mimari İlkeleri kararlarını gerekçelendirir.
Modül 1
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 2
API Yaşam Döngüsü Yönetimi
  • Yaşam döngüsü aşamaları: planlama, tasarım, geliştirme, yayın, işletim, emeklilik
  • Ortam ve onay akışı: geliştirme, test, üretim ve API durum yönetimi
  • API envanteri ve katalog ile gölge (shadow) API riskinin azaltılması
  • Değişiklik yönetimi, sürüm takvimi ve tüketici bildirim süreci
  • Hizmet düzeyi anlaşması (SLA) ve kota planları
  • Emeklilik: kullanım takibi, geri sayım duyurusu ve erişimin kapatılması
Modül 3
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 4
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ı
Günün hedefiKatılımcı URI Tasarımı ve Kaynak Modelleme ve REST API Veri Modelleri konularını uygulayarak Sürümleme ve API Evrimi ile Hata Yönetimi ve Problem Details adımlarını aynı örnek üzerinde birleştirir.
Modül 1
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ı
Modül 2
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 3
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 4
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
Günün hedefiKatılımcı gün sonunda OpenAPI ile Sözleşme ve Dokümantasyon konusunu çalıştırır, OAuth 2.0, JWT ve API Yetkilendirme ve Geliştirici Portalı ve Para Kazanma ile ilerleyip API İzleme, Analitik ve SLA Takibi kararlarını gerekçelendirir.
Modül 1
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 2
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 3
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ü
Modül 4
API İzleme, Analitik ve SLA Takibi
  • Temel API metrikleri: istek sayısı, gecikme yüzdelikleri, hata oranı, kullanılabilirlik
  • Uçtan uca sentetik izleme ve sağlık uç noktaları
  • Kullanım analitiği: en çok kullanılan uç, tüketici bazlı trafik, coğrafi dağılım
  • Alarm eşikleri, on-call süreci ve olay sonrası inceleme (post-mortem)
  • SLA, SLO ve hata bütçesi ilişkisi
  • Maliyet ve kapasite planlaması için trend analizi

Eğitim Kazanımları

Program sonunda katılımcılar:

✅
API Stratejisi

API'leri iş hedefleriyle ilişkilendiren bir strateji ve yol haritası oluşturabilirsiniz.

🧩
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.

📐
Veri Modeli Tasarımı

JSON Schema ile doğrulanan, sürdürülebilir REST veri modelleri tasarlayabilirsiniz.

🛡️
API Evrimi

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

🧪
OpenAPI Sözleşmesi

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

🚀
OAuth ve JWT

OAuth 2.0 akışlarını ve JWT doğrulamasını güvenli biçimde API'nize uygulayabilirsiniz.

📊
API İzleme

API sağlığını metrik ve alarmlarla izleyip SLA hedeflerine göre raporlayabilirsiniz.

Kimler İçin Uygundur?

  • API ürün sahipleri
  • mimarlar
  • teknik liderler
  • kıdemli backend geliştiricileri içindir

Sıkça Sorulan Sorular

Bu eğitim kimler için uygundur?
API ürün sahipleri, mimarlar, teknik liderler ve kıdemli backend geliştiricileri 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 Design: API Strategy & Design Eğitimi Sertifika Kodu DV-2026XX00 Tarih 27.10.2026 Yetkili İmza DV AKADEMİ

Eğitim Bilgileri

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

Bu Eğitimle Birlikte Tercih Edilenler

API ve Mikroservis MimarisiConsuming the Web API Eğitimi
Yazılım Geliştirme Eğitimleri

Consuming the Web API Eğitimi

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

HttpClient, IHttpClientFactory, Polly, System.Text.Json, DelegatingHandler, Refit, CORS ve OAuth 2.0 ile Web API tüketimi eğitimi.

Detayları Gör →
API ve Mikroservis MimarisiData Analysis Using the Spark DataFrame API Eğitimi
Yazılım Geliştirme Eğitimleri

Data Analysis Using the Spark DataFrame API Eğitimi

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

PySpark DataFrame API, Parquet ve Delta, join ve window fonksiyonları, Spark SQL, Structured Streaming, AQE ve performans ayarı ile veri analizi eğitimi.

Detayları Gör →
API ve Mikroservis MimarisiData Transformation Using the Snowpark API Eğitimi
Yazılım Geliştirme Eğitimleri

Data Transformation Using the Snowpark API Eğitimi

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

Snowpark Python DataFrame, UDF, stored procedure, Stream ve Task, Dynamic Table ve Query Profile ile Snowflake içinde veri dönüşümü eğitimi.

Detayları Gör →
API ve Mikroservis MimarisiDataFrames and the DataFrame API Eğitimi
Yazılım Geliştirme Eğitimleri

DataFrames and the DataFrame API Eğitimi

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

DataFrame API ile okuma, dönüştürme, birleştirme, performans ayarı ve test. 2 gün uygulamalı eğitim, DVA Katılım ve Başarı Sertifikası.

Detayları Gör →
API ve Mikroservis MimarisiDesign Thinking for Microservices Eğitimi
Yazılım Geliştirme Eğitimleri

Design Thinking for Microservices Eğitimi

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

Tasarım odaklı düşünme, Event Storming ve DDD ile mikroservis sınırlarının keşfi. 2 gün uygulamalı eğitim, DVA Katılım ve Başarı Sertifikası.

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