REST API: Temel Özellikleri Keşfetme

Eğitim Hakkında

REST API temel özellikleri: HTTP, kaynaklar, CRUD, durum kodları ve JSON/XML formatları

Bu başlangıç eğitimi, REST API'nin temel özelliklerini örneklerle keşfettirir. HTTP istek/yanıt yapısı, URL ve kaynak kavramı, REST'in altı kısıtı, GET/POST/PUT/DELETE ile CRUD işlemleri, 200/201/204/400/404/500 durum kodları, JSON ve XML temsilleri, sorgu parametresiyle filtreleme ve sayfalama, curl ve Postman ile istek gönderme ve DevTools ile inceleme işlenir. Katılımcılar basit bir ürün kaynağı için kendi CRUD API'lerini geliştirir ve çağırır.

Süre ve Format

2 Gün. Her gün dört modül; katılımcılar REST ve HTTP Temelleri → Yanıtlar, Formatlar ve Araçlar sırasıyla ilerler.

Seviye

Başlangıç Seviye — REST API temel özellikleri: HTTP, kaynaklar, CRUD, durum kodları ve JSON/XML formatları.

Öğrenme Metodu

Katılımcılar curl ve Postman ile örnek bir REST API'ye adım adım istek gönderir ve küçük bir CRUD API geliştirerek öğrendiklerini pekiştirir.

Neden Bu Eğitim?

🌱Yumuşak Başlangıç

REST'in temel taşlarını sade ve örnek odaklı öğrenirsiniz.

🖐️Elle Deneme

Her kavramı gerçek isteklerle deneyerek anlarsınız.

📋Doğru Alışkanlık

Baştan doğru durum kodu ve URI tasarım alışkanlığı edinirsiniz.

Anahtar Konular

REST API temelleriREST API öğrenHTTP metotlarıCRUD APIdurum kodlarıJSON XMLcurlPostmanREST nedirAPI başlangıç

“REST'i öğrenmek, web'in kendi dilini konuşmayı öğrenmektir.”

Ö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, REST kısıtlarını ve Richardson olgunluk modelini örneklerle açıklar, Basit bir kaynak üzerinde CRUD uç noktalarını uygulayıp curl ile doğrular ve GET, POST, PUT, PATCH ve DELETE metotlarını güvenlik ve idempotency açısından ayırır.

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

REST Mimari Kısıtları ve Kaynak Modeli

Roy Fielding tezindeki altı kısıt: istemci-sunucu, durumsuzluk, önbellek, tektip arayüz, katmanlı sistem, isteğe bağlı kod
Richardson olgunluk modeli: Seviye 0 (RPC) ile Seviye 3 (HATEOAS) arasındaki farkın örnekle gösterilmesi
Kaynak (resource) ile temsil (representation) ayrımı ve URI ile kaynak kimliklendirme
Durumsuzluğun oturum yönetimi, ölçeklenme ve yük dengeleme üzerindeki etkisi
REST, SOAP, gRPC ve GraphQL karşılaştırması: hangi senaryoda hangisi seçilir
Gerçek bir genel API (GitHub, Stripe veya OpenWeather) üzerinde REST uyumluluk denetimi

Modül 3

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

Modül 4

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ı

Günün hedefiKatılımcı HTTP durum kodlarını seçer ve RFC 7807 Problem Details ile hata yanıtı tasarlar, Accept/Content-Type ile içerik pazarlığı yapar ve JSON ile XML serileştirmesini karşılaştırır, Tarayıcı geliştirici araçları, curl, Fiddler ve mitmproxy ile API trafiğini inceler ve Kaynak odaklı URI, sayfalama, filtreleme ve sürümleme kurallarını uygular.

Modül 1

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 2

İç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 3

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

Modül 4

API Tasarım İlkeleri ve Kaynak Adlandırma

Çoğul isim tabanlı URI tasarımı: /orders/{id}/items yerleşimi ve fiil içeren yolların neden kaçınılması gerektiği
Sayfalama stratejileri: offset/limit, sayfa numarası ve cursor tabanlı (keyset) sayfalama
Filtreleme, sıralama ve alan seçimi için sorgu parametresi sözleşmeleri (?status=open&sort=-created)
Sürümleme yaklaşımları: URI (/v1), başlık ve media type tabanlı sürümleme ile geri uyumluluk kuralları
Toplu işlem (bulk), uzun süren işlemler için 202 Accepted ve durum sorgulama kaynağı
API değişiklik yönetimi: deprecation, Sunset başlığı ve kırıcı değişiklik tespiti

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.

🧩

REST Kısıtları

REST kısıtlarını ve Richardson olgunluk seviyelerini bir API üzerinde değerlendirebilirsiniz.

🛠️

CRUD API

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

🔐

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.

🧪

İçerik Formatları

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

🚀

API Hata Ayıklama

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

🔎

API Tasarımı

İsimlendirme, sayfalama ve sürümleme kurallarına uygun tutarlı bir API tasarlayabilirsiniz.

Kimler İçin Uygundur?

REST API kavramına yeni başlayan yazılımcılar
öğrenciler
test uzmanları
API tüketecek yarı teknik çalışanlar için uygundur

Sıkça Sorulan Sorular

Bu eğitim kimler için uygundur?

REST API kavramına yeni başlayan yazılımcılar, öğrenciler, test uzmanları ve API tüketecek yarı teknik çalışanlar için uygundur.

Hiç programlama bilmiyorum, katılabilir miyim?

Evet, temel kavramlar araçlarla gösterilir; küçük kod örnekleri adım adım verilir.

Hangi dil kullanılacak?

Örneklerde JavaScript (Node.js) kullanılır.

Devam eğitimi önerisi nedir?

Methods & Formatters ve Architecture & Databases Deployment eğitimleri mantıklı devamdır.

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: EXPLORING THE BASIC FEATURES EĞİTİMİ