API DESIGN: API DEVELOPMENT EĞİTİMİ

API'nizi tasarlayın, sonra geliştirin

REST kısıtlarından OpenAPI sözleşmesine, hata yönetimi ve güvenliğe uzanan API tasarım ve geliştirme akışı

REST kısıtlarından OpenAPI sözleşmesine, hata yönetimi ve güvenliğe uzanan API tasarım ve geliştirme akışı. API tasarımından geliştirmeye uçtan uca REST yaklaşımı odağında uygulamalı laboratuvarlarla işlenir.

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

Eğitim Hakkında

API tasarımından geliştirmeye uçtan uca REST yaklaşımı

Eğitim API'nin kaynak modellemeden yayına kadarki tasarım akışını kapsar. REST kısıtları, Richardson olgunluk modeli, URI ve HTTP metot semantiği, JSON veri modelleri, cursor sayfalama, RFC 9457 hata yanıtı, OpenAPI 3 ile sözleşme, sürümleme, OAuth 2.0 ve JWT güvenliği, ETag önbellekleme ve API-first iş akışı uygulamalı işlenir.

Süre ve Format

3 Gün. Her gün dört modül; 1. gün API Temelleri ve Kaynak Modelleme; 2. gün Veri, Sorgu ve Hata Tasarımı; 3. gün Evrim, Güvenlik ve API-First Geliştirme.

Seviye

Orta Seviye — API tasarımından geliştirmeye uçtan uca REST yaklaşımı

Öğ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 development
“İyi API, kullanıcısının zamanını korur.”

Ö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 Kavramı ve Web Servis Türleri konusunu çalıştırır, REST Mimari İlkeleri ve HTTP Metot ve Durum Kodu Semantiği ile ilerleyip URI Tasarımı ve Kaynak Modelleme kararlarını gerekçelendirir.
Modül 1
API Kavramı ve Web Servis Türleri
  • API nedir: kütüphane API'si, işletim sistemi API'si ve web API'si ayrımı
  • İstemci-sunucu modeli, istek / yanıt döngüsü ve HTTP mesaj yapısı (başlık, gövde, durum satırı)
  • Web servis türleri: REST, SOAP, GraphQL ve gRPC'nin kullanım alanları
  • Genel, ortak (partner) ve özel (private) API ayrımı ile iş modelleri
  • JSON ve XML veri biçimleri, Content-Type ve Accept başlıkları
  • Gerçek bir genel API'yi tarayıcı geliştirici araçları ve curl ile inceleme
Modül 2
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 3
HTTP Metot ve Durum Kodu Semantiği
  • GET, POST, PUT, PATCH, DELETE, HEAD, OPTIONS metotlarının amaçları
  • Güvenli (safe) ve idempotent metot kavramı, PUT ile POST farkı
  • PATCH için JSON Patch (RFC 6902) ve JSON Merge Patch (RFC 7396)
  • 2xx, 3xx, 4xx, 5xx durum kodu aileleri; 201 + Location, 204, 202 kullanımı
  • 400, 401, 403, 404, 405, 409, 415, 422, 429 kodlarının doğru ayrımı
  • Content negotiation: Accept, Accept-Language ve 406 / 415 yanıtları
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 Sayfalama, Filtreleme ve Sıralama konularını uygulayarak Hata Yönetimi ve Problem Details ile OpenAPI ile Sözleşme ve Dokümantasyon 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
Sayfalama, Filtreleme ve Sıralama
  • Offset / limit ile cursor (keyset) sayfalama arasındaki performans farkı
  • Link başlığı (RFC 8288) ve next / prev bağlantıları
  • Filtre sözdizimi: eşitlik, aralık, arama ve çoklu değer
  • sort=-createdAt gibi sıralama parametreleri ve güvenli alan beyaz listesi
  • Alan seçimi (fields) ve ilişkili kaynakları genişletme (expand / include)
  • Toplam kayıt sayısının maliyeti ve X-Total-Count alternatifleri
Modül 3
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 4
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
Günün hedefiKatılımcı gün sonunda Sürümleme ve API Evrimi konusunu çalıştırır, OAuth 2.0, JWT ve API Yetkilendirme ve HTTP Önbellekleme ile ilerleyip API Öncelikli Tasarım Süreci 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
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
HTTP Önbellekleme
  • Cache-Control yönergeleri: max-age, s-maxage, no-store, no-cache, private, public
  • ETag ve If-None-Match ile koşullu GET, 304 Not Modified yanıtı
  • Last-Modified ve If-Modified-Since farkı
  • If-Match ile iyimser eşzamanlılık kontrolü ve 412 Precondition Failed
  • Vary başlığı ve CDN / ters vekil (Varnish, NGINX) önbelleği davranışı
  • Önbellek geçersizleştirme stratejileri ve stale-while-revalidate
Modül 4
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ü

Eğitim Kazanımları

Program sonunda katılımcılar:

✅
API Temelleri

API türlerini ayırt edip gerçek bir web API'sinin istek ve yanıtını okuyabilirsiniz.

🧩
HTTP Semantiği

HTTP metotlarını ve durum kodlarını doğru semantikle kullanan uçlar tasarlayabilirsiniz.

🔧
URI Tasarımı

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

📐
Koleksiyon Sorguları

Sayfalama, filtreleme ve sıralama uçlarını performanslı ve öngörülebilir şekilde tasarlayabilirsiniz.

🛡️
Hata Yönetimi

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

🧪
API Evrimi

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

🚀
OAuth ve JWT

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

📊
API-First Çalışma

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

Kimler İçin Uygundur?

  • API geliştiren backend yazılımcıları
  • teknik analistler
  • mimariye geçmek isteyen geliştiriciler içindir

Sıkça Sorulan Sorular

Bu eğitim kimler için uygundur?
API geliştiren backend yazılımcıları, teknik analistler ve mimariye geçmek isteyen geliştiriciler 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 Development 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 MimarisiAPI Ağ Geçitleri ve API Yönetimi Eğitimi
Yazılım Geliştirme Eğitimleri

API Ağ Geçitleri ve API Yönetimi Eğitimi

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

API gateway, Kong, Spring Cloud Gateway, OAuth 2.0, rate limit, geliştirici portalı ve Apigee ile kurumsal API yönetimi eğitimi.

Detayları Gör →
API ve Mikroservis MimarisiAPI Contract & Automation Testing with Postman: Contract Testing Eğitimi
Yazılım Geliştirme Eğitimleri

API Contract & Automation Testing with Postman: Contract Testing Eğitimi

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

Postman ile JSON Schema ve OpenAPI uyumlu API sözleşme testi, Newman ve CI entegrasyonu, Monitor ile zamanlı doğrulama eğitimi.

Detayları Gör →
API ve Mikroservis MimarisiAPI Contract & Automation Testing with Postman: Working with GraphQL APIs Eğitimi
Yazılım Geliştirme Eğitimleri

API Contract & Automation Testing with Postman: Working with GraphQL APIs Eğitimi

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

GraphQL sorgu, mutasyon ve fragment yazımı ile Postman'da errors dizisi doğrulaması, introspection ve derinlik limiti testleri eğitimi.

Detayları Gör →
API ve Mikroservis MimarisiAPI Design: API Strategy & Design Eğitimi
Yazılım Geliştirme Eğitimleri

API Design: API Strategy & Design Eğitimi

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

API-as-a-product yaklaşımı, yaşam döngüsü, API-first süreç, stil rehberi, OpenAPI, sürümleme ve geliştirici portalı konularını işleyen strateji ve tasarım eğiti

Detayları Gör →
API ve Mikroservis MimarisiAPI Design: RESTful APIs Eğitimi
Yazılım Geliştirme Eğitimleri

API Design: RESTful APIs Eğitimi

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

RESTful API tasarımı: Fielding kısıtları, HTTP semantiği, URI modelleme, sayfalama, ETag önbellekleme, problem+json ve OpenAPI uygulamalı eğitimi.

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