REST API: Metotlar ve Formatlarla Çalışma

Eğitim Hakkında

REST API metotları ve formatter'ları: idempotency, PATCH, içerik pazarlığı, JSON/XML ve hipermedya

Bu eğitim, REST API'de HTTP metotlarını ve yanıt formatlarını doğru kullanmaya odaklanır. GET/HEAD/OPTIONS güvenliği, PUT ve DELETE idempotency'si, POST ile kaynak oluşturma ve Location başlığı, PATCH için JSON Merge Patch ve JSON Patch, Idempotency-Key, ETag ve If-Match ile iyimser kilit işlenir. Accept/Content-Type ile içerik pazarlığı, 406/415 yanıtları, Jackson ve System.Text.Json formatter yapılandırması, ISO 8601 tarih biçimi, HAL ve JSON:API hipermedya biçimleri ve Postman testleri uygulanır.

Süre ve Format

2 Gün. Her gün dört modül; katılımcılar HTTP Metotları ve Durum Kodları → Formatlar, Hipermedya ve Test sırasıyla ilerler.

Seviye

Temel Seviye — REST API metotları ve formatter'ları: idempotency, PATCH, içerik pazarlığı, JSON/XML ve hipermedya.

Öğrenme Metodu

Katılımcılar bir API'de metot ve format hatalarını bulup düzeltir, içerik pazarlığı ve özel formatter yapılandırır, Postman ile doğrular.

Neden Bu Eğitim?

🔧Doğru Metot

Her işlem için uygun HTTP metodunu ve beklenen davranışını seçersiniz.

📑Esnek Format

Aynı kaynağı JSON ve XML olarak içerik pazarlığıyla sunarsınız.

🔁Güvenli Tekrar

İdempotency ile ağ hatalarında tekrar denenen isteklerin zarar vermemesini sağlarsınız.

Anahtar Konular

HTTP metotlarıidempotencyPATCH JSON Patchiçerik pazarlığıJSON XML formatterETag If-MatchHATEOASREST API metotlarJacksonAccept Content-Type

“Doğru metot ve doğru format, iyi API'nin sessiz sözleşmesidir.”

Ön Koşullar

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

1

HTTP Temel Bilgisi

URL, istek ve yanıt kavramlarına genel aşinalık yeterlidir.

2

Programlama Deneyimi

Herhangi bir dilde temel değişken, fonksiyon ve JSON okuma becerisi beklenir.

3

Kurulu Araçlar

Postman veya curl ile bir kod düzenleyici (VS Code / IntelliJ) kurulu olmalıdır.

4

Çalışma Ortamı

İnternet erişimli, yönetici izni olan ve en az 8 GB RAM'li bir dizüstü bilgisayar gerekir.

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ı HTTP istek ve yanıt yapısını curl ile satır satır inceler, GET, POST, PUT, PATCH ve DELETE metotlarını güvenlik ve idempotency açısından ayırır, HTTP durum kodlarını seçer ve RFC 7807 Problem Details ile hata yanıtı tasarlar ve Basit bir kaynak üzerinde CRUD uç noktalarını uygulayıp curl ile doğrular.

Modül 1

HTTP Protokolü ve İstek/Yanıt Yapısı

İstek satırı, başlıklar ve gövde: Host, Accept, Content-Type, Content-Length ve User-Agent alanlarının rolü
HTTP/1.1, HTTP/2 ve HTTP/3 farkları: keep-alive, çoklama (multiplexing) ve başlık sıkıştırma (HPACK)
TLS el sıkışması, sertifika zinciri ve curl -v ile bağlantı kurulumunun adım adım izlenmesi
Önbellek başlıkları: Cache-Control, ETag, If-None-Match ve 304 Not Modified akışı
Çerez, Authorization ve CORS ön uçuş (preflight OPTIONS) isteklerinin tarayıcıdaki davranışı
URL anatomisi: şema, host, port, path, query string ve yüzde kodlama (percent-encoding) kuralları

Modül 2

HTTP Metotları ve Idempotency

GET, HEAD, OPTIONS metotlarının güvenli (safe) olması ve PUT, DELETE metotlarının idempotent olması
POST ile PUT arasındaki fark: kaynak oluşturma, tam değiştirme ve 201 Created ile Location başlığı
PATCH ile kısmi güncelleme: JSON Merge Patch (RFC 7396) ve JSON Patch (RFC 6902) karşılaştırması
Idempotency-Key başlığı ile ödeme gibi kritik POST isteklerinin tekrar güvenli hale getirilmesi
Koşullu istekler: If-Match ve ETag ile iyimser eşzamanlılık (optimistic concurrency) kontrolü
Metot override (X-HTTP-Method-Override) ve OPTIONS ile Allow başlığının keşif amaçlı kullanımı

Modül 3

Durum Kodları ve Hata Modelleri

2xx, 3xx, 4xx, 5xx sınıfları: 200, 201, 202, 204, 301, 304, 400, 401, 403, 404, 409, 422, 429, 500, 503 ayrımı
401 Unauthenticated ile 403 Forbidden arasındaki fark ve WWW-Authenticate başlığı
400 ile 422 arasında doğrulama hatası kararı ve alan bazlı hata listesi döndürme
RFC 7807 application/problem+json biçimi: type, title, status, detail ve instance alanları
Retry-After, 429 Too Many Requests ve 503 durumlarında istemci tarafı yeniden deneme davranışı
Hata yanıtlarında yığın izi sızıntısı ve hassas bilgi ifşasını önleme kuralları

Modül 4

Bir REST API'yi Baştan Sona Ayağa Kaldırma

Bir "ürün" kaynağı için GET /products, GET /products/{id}, POST, PUT, DELETE uç noktalarının planlanması
Bellek içi depo ile ilk sürüm, ardından kalıcı veritabanına geçiş
İstek gövdesi doğrulaması ve 400/404/409 durumlarının uygulanması
Location başlığı, 201 Created ve 204 No Content yanıtlarının doğru döndürülmesi
curl ve Postman ile uç noktaların elle doğrulanması, ardından otomatikleştirilmesi
Basit sürümleme ve sağlık kontrolü (/health) uç noktasının eklenmesi

Günün hedefiKatılımcı Accept/Content-Type ile içerik pazarlığı yapar ve JSON ile XML serileştirmesini karşılaştırır, Hipermedya bağlantılarını HAL ve JSON:API biçimleriyle yanıtlara ekler, pm.test ve pm.expect ile otomatik doğrulama yazar, koleksiyonu veri dosyasıyla çalıştırır ve Tarayıcı geliştirici araçları, curl, Fiddler ve mitmproxy ile API trafiğini inceler.

Modül 1

İçerik Pazarlığı, JSON ve XML Formatları

Accept ve Content-Type başlıkları, 406 Not Acceptable ve 415 Unsupported Media Type yanıtları
JSON veri tipleri, iç içe nesneler, null yönetimi ve tarih/saat için ISO 8601 biçimi
XML ad alanları, öznitelik-eleman ayrımı ve JSON ile XML arasında dönüşüm tuzakları
Jackson, Gson veya System.Text.Json gibi serileştiricilerde özel formatter yapılandırması
Accept-Language ve Accept-Encoding ile yerelleştirme ve gzip/brotli sıkıştırma
application/vnd.firma.v2+json gibi vendor media type ile sürüm yönetimi

Modül 2

HATEOAS ve Hipermedya Formatları

HATEOAS fikri: istemcinin sonraki eylemleri yanıttaki bağlantılardan keşfetmesi
HAL (_links, _embedded), JSON:API ve Siren biçimlerinin karşılaştırılması
Spring HATEOAS ile EntityModel, CollectionModel ve link ilişkisi (rel) oluşturma
Durum geçişlerine bağlı dinamik bağlantılar: sipariş iptal edilebilirse cancel linki gösterme
Sayfalama bağlantıları: self, next, prev, first, last ve Link başlığı (RFC 8288)
Hipermedya kullanımının istemci karmaşıklığına etkisi ve pratikte ne zaman değer kattığı

Modül 3

Postman Test Betikleri ve Collection Runner

pm.test ve pm.expect (Chai) ile durum kodu, süre, başlık ve JSON alan doğrulamaları
pm.response.json() ile yanıttan veri çekip pm.environment.set ile sonraki isteğe aktarma (zincirleme)
tv4 / Ajv ile JSON şema doğrulaması ve ortak test kütüphanesi paylaşımı
Collection Runner ile CSV/JSON veri dosyası kullanarak veri güdümlü (data-driven) test
postman.setNextRequest ile akış kontrolü ve koşullu istek sıralama
Negatif test senaryoları: eksik alan, geçersiz token, aşırı büyük gövde ve beklenen 4xx doğrulaması

Modül 4

Web API Keşfi ve Hata Ayıklama Araçları

Tarayıcı DevTools Network sekmesi: zamanlama (waterfall), başlık ve yük inceleme, HAR dışa aktarımı
curl ile -X, -H, -d, -i, -w ve --trace seçenekleriyle istek oluşturma ve gecikme ölçme
Fiddler Everywhere veya mitmproxy ile HTTPS trafiğini araya girerek inceleme ve istek değiştirme
HTTPie ve jq ile komut satırından JSON yanıtlarını biçimlendirme ve süzme
Yaygın sorun sınıfları: CORS hataları, yanlış Content-Type, sıkıştırma ve yönlendirme döngüleri
Sunucu tarafı erişim günlükleri, correlation ID ve istek izleme ile uçtan uca hata takibi

Eğitim Kazanımları

Program sonunda katılımcılar:

✅

HTTP Yapısı

HTTP istek satırı, başlıkları ve gövdesini okuyup hata ayıklayabilirsiniz.

🧩

HTTP Metotları

Metotları güvenli ve idempotent olma özelliklerine göre doğru senaryoda kullanabilirsiniz.

🛠️

Hata Modeli

Doğru HTTP durum kodlarını seçip RFC 7807 uyumlu hata yanıtları tasarlayabilirsiniz.

🔐

CRUD API

Bir kaynak için CRUD uç noktalarını yazıp durum kodlarıyla birlikte doğrulayabilirsiniz.

📈

İçerik Formatları

JSON ve XML temsillerini içerik pazarlığı ile aynı uç noktadan sunabilirsiniz.

🧪

Hipermedya

Yanıtlara HAL veya JSON:API bağlantıları ekleyerek keşfedilebilir API sunabilirsiniz.

🚀

Postman Testleri

pm.test betikleriyle yanıtları otomatik doğrulayıp veri güdümlü koleksiyon çalıştırabilirsiniz.

🔎

API Hata Ayıklama

curl, tarayıcı DevTools ve proxy araçlarıyla API sorunlarının kaynağını bulabilirsiniz.

Kimler İçin Uygundur?

REST API geliştirenler
API tüketicileri
test mühendisleri için; HTTP metotlarını ve formatları doğru kullanmak isteyen herkes için uygundur

Sıkça Sorulan Sorular

Bu eğitim kimler için uygundur?

REST API geliştirenler, API tüketicileri ve test mühendisleri için; HTTP metotlarını ve formatları doğru kullanmak isteyen herkes için uygundur.

Kodlama gerekiyor mu?

Evet, kısa örneklerle (Java veya Node.js) uygulanır; Postman ile de çalışılabilir.

PATCH ve PUT arasında nasıl seçilir?

Tam değiştirme için PUT, kısmi güncelleme için PATCH; eğitimde iki standart patch biçimiyle karşılaştırılır.

XML hâlâ gerekli mi?

Kurumsal entegrasyonlarda sıkça karşılaşılır; JSON ile birlikte sunmanın yolları gösterilir.

Eğitim sonunda sertifika verilir mi?

Eğitimi tamamlayan katılımcılara Digital Vizyon Akademi Katılım ve Başarı Sertifikası verilir. Üçüncü taraf kurumların sınav ve sertifikalarıyla bir bağı yoktur.

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 API: WORKING WITH METHODS & FORMATTERS EĞİTİMİ