API Error Handling: Best Practices Eğitimi

Eğitim Hakkında

API hata yönetiminde iyi uygulamalar

Eğitim API'lerde hata yönetimini hem sunucu hem istemci tarafından ele alır. RFC 9457 problem+json yapısı, 400/401/403/404/409/422/429 durum kodu seçimi, doğrulama hata listesi, bilgi sızıntısı önleme, correlation ID, Retry-After, Resilience4j ile retry ve circuit breaker, yapılandırılmış log, güvenlik olayı loglama ve MockMvc ile Postman hata senaryosu testleri uygulanır.

Süre ve Format

2 Gün. Her gün dört modül; 1. gün Hata Tasarımı ve HTTP Semantiği; 2. gün Hata İzleme, Güvenlik ve Test.

Seviye

Orta Seviye — API hata yönetiminde iyi uygulamalar

Öğ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 error handling: best practices

“Hatayı iyi anlatan API, güven kazanı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 Hata Yönetimi ve Problem Details konusunu çalıştırır, HTTP Metot ve Durum Kodu Semantiği ve Dayanıklılık Kalıpları ile ilerleyip Gelişmiş API Özellikleri kararlarını gerekçelendirir.

Modül 1

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 2

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 3

Dayanıklılık Kalıpları

Circuit breaker durumları (closed, open, half-open) ve Resilience4j yapılandırması
Retry stratejileri: exponential backoff ve jitter
Bulkhead, rate limiter ve timeout limiter ile kaynak izolasyonu
Fallback ve graceful degradation tasarımı
Sağlık uçları: liveness ve readiness probe ayrımı
Chaos engineering'e giriş: Chaos Monkey ile hata enjeksiyonu

Modül 4

Gelişmiş API Özellikleri

Rate limiting algoritmaları: fixed window, sliding window, token bucket ve X-RateLimit başlıkları
Webhook tasarımı: imza doğrulama (HMAC), yeniden teslimat ve olay türleri
Uzun süren işlemler: 202 Accepted, durum kaynağı ve polling / callback
Idempotency-Key başlığı ile güvenli yeniden deneme
Toplu (bulk/batch) işlemler ve kısmi başarı yanıtları (207 Multi-Status)
Streaming: Server-Sent Events, WebSocket ve chunked transfer ile canlı veri

Günün hedefiKatılımcı Gözlemlenebilirlik: Log, Metrik, İzleme ve Yetersiz Loglama ve İzleme konularını uygulayarak TDD ile API Geliştirme ile Postman Test Betikleri ve Doğrulamalar adımlarını aynı örnek üzerinde birleştirir.

Modül 1

Gözlemlenebilirlik: Log, Metrik, İzleme

Yapılandırılmış JSON log ve correlation ID'nin servisler arası taşınması
Dağıtık izleme: OpenTelemetry, span, trace context ve Jaeger/Zipkin
Prometheus metrik tipleri (counter, gauge, histogram) ve Micrometer
Grafana panoları ve RED/USE yöntemleriyle servis sağlığı yorumlama
Spring Boot Actuator uçları ve özel health indicator yazımı
SLI, SLO ve hata bütçesi ile uyarı (alerting) kuralları

Modül 2

Yetersiz Loglama ve İzleme

Hangi olayların loglanacağı: kimlik doğrulama, yetki reddi, girdi doğrulama hataları
Log injection ve log içinde hassas veri (parola, token, PAN) sızıntısı
Merkezî log toplama: ELK / OpenSearch ve Loki ile korelasyon
SIEM kuralları: kaba kuvvet, olağandışı trafik ve token tekrar kullanımı
Saldırı tespiti için WAF ve API gateway log verisi kullanımı
Olay müdahale akışı, uyarı eşikleri ve tatbikat

Modül 3

TDD ile API Geliştirme

JUnit 5 ve AssertJ ile birim test yazımı
Mockito ile repository ve istemci bağımlılıklarını taklit etme
MockMvc ve @WebMvcTest ile controller katmanı testi
REST Assured ile uçtan uca HTTP testi (given-when-then)
Testcontainers ile gerçek veritabanı üzerinde @DataJpaTest
Test önce yazılan bir sipariş API'sinin adım adım geliştirilmesi

Modül 4

Postman Test Betikleri ve Doğrulamalar

pm.test ve pm.expect (Chai) ile durum kodu, süre ve başlık doğrulamaları
pm.response.json() ile gövde alanı doğrulama ve JSON Schema (tv4/Ajv) kontrolü
Pre-request script ile dinamik veri, zaman damgası ve imza üretimi
Collection, folder ve request seviyesinde script kapsamı ve çalışma sırası
postman.setNextRequest ve pm.execution.setNextRequest ile akış kontrolü
Test sonuçlarında başarısızlık analizi ve flaky testlerin ayıklanması

Eğitim Kazanımları

Program sonunda katılımcılar:

✅

Hata Yönetimi

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

🧩

HTTP Semantiği

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

🔧

Dayanıklı Servisler

Circuit breaker, retry ve bulkhead kalıplarıyla hataya dayanıklı servisler yazabilirsiniz.

📐

Gelişmiş Özellikler

Webhook, rate limit, idempotency ve uzun süren işlem kalıplarını API'nize ekleyebilirsiniz.

🛡️

Gözlemlenebilirlik

OpenTelemetry, Prometheus ve Grafana ile dağıtık sistemlerde sorun kaynağını izleyebilirsiniz.

🧪

Güvenlik İzleme

Güvenlik olaylarını loglayıp SIEM kurallarıyla saldırı belirtilerini yakalayabilirsiniz.

🚀

TDD ile API

Testi önce yazarak çalışan bir REST API geliştirebilirsiniz.

📊

Postman Testleri

pm.test ile durum kodu, başlık ve gövde doğrulayan otomatik testler yazabilirsiniz.

Kimler İçin Uygundur?

Backend geliştiricileri
API tüketicileri
test mühendisleri için uygundur

Sıkça Sorulan Sorular

Bu eğitim kimler için uygundur?

Backend geliştiricileri, API tüketicileri ve test mühendisleri için uygundur.

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

API ERROR HANDLING: BEST PRACTICES EĞİTİMİ