REST API Tasarımı ve Geliştirme Eğitimi

Eğitim Hakkında

REST mimari stilinin tasarım, güvenlik ve işletim boyutları

Eğitim, Fielding'in kısıtlarından başlayarak REST API tasarımının tamamını işler. Kaynak odaklı URI, HTTP metod semantiği ve durum kodları, sayfalama, filtreleme, ETag ve idempotency, RFC 9457 hata modeli, sürümleme, Spring Boot veya Express ile servis geliştirme, Postman ve Newman testleri, OpenAPI, OAuth 2.0 + PKCE, OWASP API Top 10, retry ve circuit breaker, webhook, gRPC ve GraphQL karşılaştırması ile API gateway ele alınır.

Süre ve Format

2 Gün. Her gün dört modül; 1. gün HTTP, Kaynak Modelleme ve Servis Geliştirme; 2. gün Güvenlik, İstemci, Asenkron Etkileşim ve Yaşam Döngüsü.

Seviye

Orta Seviye — REST kısıtlarından API tasarımı, OpenAPI, güvenlik, dayanıklı istemci ve API yaşam döngüsüne uzanan yelpaze

Öğrenme Metodu

Katılımcılar bir kaynak modeli tasarlar, çalışan bir REST servisi geliştirir, Postman/Newman ile otomatik test yazar, OpenAPI belgesi üretir ve OAuth 2.0 ile korur.

Neden Bu Eğitim?

🧩Doğru Tasarım

Kaynak, URI ve HTTP metodunu semantiğine uygun kullanarak tutarlı API'ler üretirsiniz.

🔐Güvenli API

OAuth 2.0 ve OWASP API Top 10 ilkeleriyle yaygın zafiyetleri önlersiniz.

🔧Üretime Hazır

Sürümleme, hata modeli, dayanıklı istemci ve gateway ile işletilebilir API'ler kurarsınız.

Anahtar Konular

rest api eğitimirest api tasarımırestful servisopenapi swaggeroauth 2.0 pkceowasp api top 10http durum kodlarıapi sürümlemepostman newmanapi gateway

“İyi bir API, yazıldığı gün değil, yıllar sonra kullanıldığı gün anlaşılır.”

Ön Koşullar

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

1

Programlama Deneyimi

Herhangi bir dilde temel programlama deneyimi gerekir.

2

HTTP ve JSON

İstek-yanıt modeli, başlıklar ve JSON yapısına aşinalık beklenir.

3

Araçlar

Postman, curl ve bir IDE kurulu bir bilgisayar gerekir.

4

Laboratuvar Ortamı

Java 17 veya Node.js 20 kurulu bir geliştirme ortamı hazırlanmalıdır.

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 HTTP davranışını ve REST kısıtlarını kavrar, API davranışlarını tasarlar ve test edilebilir bir servis geliştirir.

Modül 1

HTTP Protokol Derinliği ve Ağ Davranışı

HTTP/1.1, HTTP/2 çoklama ve HTTP/3 (QUIC) farkları; keep-alive ve bağlantı yeniden kullanımı
İstek satırı, başlıklar, gövde, Transfer-Encoding: chunked ve Content-Length ilişkisi
TLS el sıkışması, sertifika zinciri, HSTS ve mTLS ile servisler arası kimlik doğrulama
Çerez, SameSite, Authorization başlığı ve token'ın güvenli saklanması
Proxy, CDN ve ters vekil (reverse proxy) katmanlarında Cache-Control, Vary ve X-Forwarded-* başlıkları
curl -v, Wireshark ve tarayıcı DevTools ile isteğin ağ üzerindeki yolculuğunun incelenmesi

Modül 2

REST Mimari Stili ve Kaynak Modelleme

Roy Fielding'in altı kısıtı: istemci-sunucu, durumsuzluk, önbelleklenebilirlik, tek tip arayüz, katmanlı sistem, isteğe bağlı kod
Kaynak odaklı tasarım: çoğul isimli URI'ler (/orders/42/items), iç içe kaynaklar ve fiil içeren URI hataları
HTTP metodları GET, POST, PUT, PATCH, DELETE; güvenli (safe) ve idempotent kavramları
Durum kodları: 200, 201 + Location, 204, 400, 401, 403, 404, 409, 422, 429, 500 doğru kullanım rehberi
Richardson Olgunluk Modeli (seviye 0-3) ve HATEOAS bağlantılarının rolü
İçerik pazarlığı: Accept ve Content-Type başlıkları, JSON şema tasarımı, tarih ve para birimi formatları

Modül 3

API Davranışları: Sayfalama, Filtreleme, Sürümleme ve Hata Modeli

Koleksiyonlarda sayfalama: offset/limit ile cursor tabanlı sayfalama ve Link başlığı
Sıralama ve filtreleme için sorgu parametresi kuralları (?sort=-created&status=open&fields=id,name)
API sürümleme: URI (/v1), başlık ve media type tabanlı yaklaşımların karşılaştırması; geriye dönük uyumluluk
RFC 9457 Problem Details (application/problem+json) ile standart hata gövdesi
Önbellekleme: ETag, If-None-Match, Cache-Control ve eşzamanlı güncelleme için If-Match ile optimistic locking
Idempotency-Key başlığı ile POST isteklerinin güvenle yeniden denenmesi ve rate limit başlıkları

Modül 4

REST Uygulaması: Servis Geliştirme ve Test

Spring Boot veya Express ile örnek CRUD servisi ve katmanlı (controller-service-repository) yapı
Girdi doğrulama (Bean Validation / Joi) ve merkezi hata yakalama (ControllerAdvice, error middleware)
Postman koleksiyonları, ortam değişkenleri ve Newman ile otomatik API testi
curl ve HTTPie ile ham isteklerin incelenmesi, -v çıktısıyla başlık analizi
Sözleşme testi ve mock sunucu: WireMock, Prism ve consumer-driven contract (Pact) fikri
Test piramidinde API testlerinin yeri; durum kodu, şema ve performans (k6) doğrulamaları

Günün hedefiKatılımcı gün sonunda OpenAPI ve OAuth 2.0 ile güvenli belgeleme yapar, dayanıklı istemci yazar, asenkron seçenekleri değerlendirir ve API yaşam döngüsünü yönetir.

Modül 1

OpenAPI, Güvenlik ve Üretim Hazırlığı

OpenAPI 3.x belgesi: paths, components/schemas, parameters, responses ve örnekler
Swagger UI ve Redoc ile canlı dokümantasyon; kod üretimi (openapi-generator) ve tasarım-önce yaklaşım
OAuth 2.0 Authorization Code + PKCE ve Client Credentials akışları, JWT erişim token'ı ve scope kavramı
OWASP API Security Top 10: BOLA, bozuk kimlik doğrulama, aşırı veri ifşası ve mass assignment örnekleri
CORS, TLS, rate limiting, API gateway (Kong, Azure APIM) ve girdi boyutu sınırlamaları
Gözlemlenebilirlik: korelasyon kimliği, yapılandırılmış log, metrik ve dağıtık izleme; REST ile gRPC / GraphQL seçim kriterleri

Modül 2

REST İstemcisi Geliştirme ve Dayanıklılık

İstemci kütüphaneleri: fetch / axios, requests, HttpClient (.NET), RestTemplate / WebClient
Zaman aşımı, yeniden deneme (exponential backoff + jitter) ve Retry-After başlığına uyum
Circuit breaker, bulkhead ve fallback kalıpları: Resilience4j ve Polly örnekleri
Sayfalı koleksiyonları tüketme, oran sınırı (429) yönetimi ve toplu istek optimizasyonu
Token yenileme, 401 yönetimi ve istemci tarafı önbellek
SDK üretimi (OpenAPI Generator) ve tüketici tarafı sözleşme doğrulaması

Modül 3

Asenkron Etkileşim: Webhook, SSE, WebSocket ve gRPC/GraphQL

Uzun süren işlemler için 202 Accepted + durum kaynağı (polling) kalıbı
Webhook tasarımı: imza doğrulama (HMAC), yeniden gönderim ve idempotent alıcı
Server-Sent Events ve WebSocket ile gerçek zamanlı veri; REST ile birlikte kullanım
gRPC (protobuf, streaming) ile REST karşılaştırması ve gRPC-Web
GraphQL: şema, query/mutation, N+1 problemi ve REST ile seçim kriterleri
Olay güdümlü mimari: mesaj kuyruğu, Kafka ve REST API'nin rolü

Modül 4

API Yaşam Döngüsü ve Ürünleştirme

API gateway ile kimlik doğrulama, kota, rate limit ve trafik yönetimi (Kong, Apigee, Azure APIM)
Geliştirici portalı, API anahtarı yönetimi ve kullanım analitiği
Kullanımdan kaldırma politikası: Deprecation ve Sunset başlıkları, sürüm geçiş planı
Breaking change kontrolü: oasdiff ile OpenAPI karşılaştırması ve CI'a entegrasyonu
API stil rehberi (Zalando, Microsoft) ve tasarım incelemesi süreci
SLA / SLO tanımı, hata bütçesi ve API sağlık panoları

Eğitim Kazanımları

Program sonunda katılımcılar:

✅

HTTP Derinliği

HTTP başlıkları, TLS ve önbellek katmanlarını inceleyerek API davranışını açıklayabilirsiniz.

🎯

REST Tasarım İlkeleri

Kaynakları doğru URI ve HTTP metoduyla modelleyen REST arayüzleri tasarlarsınız.

🔧

API Davranışları

Sayfalama, sürümleme ve standart hata modeliyle tüketici dostu API'ler yazarsınız.

🧩

Servis Geliştirme ve Test

Doğrulama, hata yönetimi ve otomatik testli bir REST servisi geliştirirsiniz.

📦

OpenAPI ve Güvenlik

API'yi OpenAPI ile belgeleyip OAuth 2.0 ve OWASP ilkeleriyle güvenli hale getirirsiniz.

🚀

Dayanıklı İstemci

Retry, circuit breaker ve zaman aşımıyla dayanıklı REST istemcileri yazarsınız.

🔒

Asenkron Etkileşim

Webhook, SSE ve gRPC/GraphQL seçeneklerini REST ile karşılaştırarak doğru modeli seçersiniz.

📊

API Yaşam Döngüsü

API'yi sürüm, kota ve kullanımdan kaldırma politikalarıyla ürün gibi yönetirsiniz.

Kimler İçin Uygundur?

Yazılım geliştiriciler
API tasarımcıları
mimarlar
test mühendisleri
entegrasyon ekipleri için uygundur

Sıkça Sorulan Sorular

Bu eğitim kimler için uygundur?

Yazılım geliştiriciler, API tasarımcıları, mimarlar, test mühendisleri ve entegrasyon ekipleri için uygundur.

Hangi dilde uygulama yapılır?

Servis örneği Spring Boot veya Express ile yapılır; tasarım konuları dilden bağımsızdır.

GraphQL ve gRPC konusu var mı?

Evet. REST ile karşılaştırma ve seçim kriterleri ayrı bir modülde ele alınır.

OpenAPI uygulamalı mı?

Evet. Tasarım-önce yaklaşımla OpenAPI belgesi yazılır, Swagger UI ile yayınlanır ve kod üretimi denenir.

Eğitim sonunda hangi belge verilir?

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

REST EĞİTİMİ