REST API: Siteler Arası Bilgi Alışverişi

Eğitim Hakkında

REST ile siteler arası bilgi alışverişi: HTTP, SOAP karşılaştırması, JSON/XML, CORS ve güvenlik

Bu eğitim, farklı sitelerin ve sistemlerin birbirleriyle veri alışverişinde REST desenini nasıl kullandığını anlatır. XML-RPC ve SOAP/WSDL ile REST farkı, HTTP metotları ve durum kodları, JSON ve XML temsilleri, Accept/Content-Type ile içerik pazarlığı, tarayıcıda Same-Origin Policy ve CORS, webhook ile olay bildirimi ve imza doğrulama, üçüncü taraf API anahtarı ve kota yönetimi işlenir. Katılımcılar iki siteyi REST API ile bağlayan basit bir mashup uygulaması geliştirir.

Süre ve Format

2 Gün. Her gün dört modül; katılımcılar Web Servisleri ve REST Deseni → Bilgi Alışverişi Uygulaması sırasıyla ilerler.

Seviye

Temel Seviye — REST ile siteler arası bilgi alışverişi: HTTP, SOAP karşılaştırması, JSON/XML, CORS ve güvenlik.

Öğrenme Metodu

Katılımcılar bir sitenin REST API'sini diğer sitede tüketen küçük bir uygulama yapar; CORS ve kimlik doğrulama sorunlarını deneyerek çözer.

Neden Bu Eğitim?

🔗Sistemleri Bağlama

Farklı sitelerin veri alışverişini standart bir desenle kurarsınız.

🌐CORS Hakimiyeti

Tarayıcı kaynaklı siteler arası sorunları nedenleriyle çözersiniz.

📡Olay Bildirimi

Webhook ile gerçek zamanlıya yakın veri akışı tasarlarsınız.

Anahtar Konular

REST APIsiteler arası veri alışverişiCORSSOAP vs RESTwebhookJSON XMLmashupweb servisleriAPI entegrasyonuREST deseni

“Web, bağlantıların ağıdır; REST bu bağlantılara ortak bir dil verir.”

Ö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, Web servisleri tarihçesini, SOAP/XML-RPC ile REST farkını ve mashup senaryolarını ele alır 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

Siteler Arası Veri Alışverişi ve REST Deseni

Web servislerinin tarihçesi: XML-RPC, SOAP/WSDL ve REST'in yükselişi
SOAP zarfı (Envelope), WSDL sözleşmesi ve REST + JSON karşılaştırması
Tarayıcıdan siteler arası istek: Same-Origin Policy, CORS ve JSONP'nin sınırları
Webhook ile olay tabanlı bildirim, imza doğrulama ve yeniden teslimat
Üçüncü taraf API tüketimi: anahtar yönetimi, kota ve sürüm değişikliklerine dayanıklılık
RSS/Atom ve açık veri API'leriyle basit bir mashup uygulaması geliştirme

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ı Accept/Content-Type ile içerik pazarlığı yapar ve JSON ile XML serileştirmesini karşılaştırır, HTTP durum kodlarını seçer ve RFC 7807 Problem Details ile hata yanıtı tasarlar, Basit bir kaynak üzerinde CRUD uç noktalarını uygulayıp curl ile doğrular ve API kimlik doğrulama yöntemlerini, JWT yapısını ve OWASP API Top 10 risklerini ele alır.

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

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 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

API Güvenliği: OAuth 2.0, JWT ve Oran Sınırlama

API anahtarı, Basic Auth, Bearer token ve OAuth 2.0 akışları: authorization code (PKCE), client credentials
JWT yapısı: header, payload, imza, exp/iat/aud talepleri ve RS256 ile HS256 farkı
Scope ve rol tabanlı yetkilendirme ile nesne düzeyi yetki kontrolü (BOLA) açığı örneği
OWASP API Security Top 10: aşırı veri ifşası, mass assignment ve bozuk kimlik doğrulama
Oran sınırlama (rate limiting) algoritmaları: token bucket, sliding window ve 429 yanıtı
CORS yapılandırması, girdi doğrulama ve TLS zorunluluğu (HSTS) ile temel sertleştirme

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.

🛠️

Servis Entegrasyonu

Siteler arası veri alışverişi için REST, SOAP ve webhook yaklaşımlarını karşılaştırıp seçebilirsiniz.

🔐

HTTP Metotları

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

📈

İçerik Formatları

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

🧪

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.

🔎

API Güvenliği

OAuth 2.0 ve JWT ile korunan API akışlarını kurup yaygın OWASP API risklerini kapatabilirsiniz.

Kimler İçin Uygundur?

Web geliştiricileri
entegrasyon uzmanları
farklı sistemlerin veri paylaşımını sağlayacak yazılımcılar ile öğrenciler için uygundur

Sıkça Sorulan Sorular

Bu eğitim kimler için uygundur?

Web geliştiricileri, entegrasyon uzmanları ve farklı sistemlerin veri paylaşımını sağlayacak yazılımcılar ile öğrenciler için uygundur.

SOAP hâlâ kullanılıyor mu?

Kurumsal sistemlerde yaygındır; eğitimde SOAP ile REST farkı ve ne zaman hangisinin seçileceği anlatılır.

Kod yazılacak mı?

Evet, JavaScript ve basit bir Node.js sunucuyla kısa uygulamalar yapılır.

Güvenlik konusu ne kadar işleniyor?

API anahtarı, OAuth 2.0 ve CORS yapılandırması temel düzeyde uygulanı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 - SİTELER ARASI BİLGİ ALIŞVERİŞİNDE KULLANILAN BİR DESEN EĞİTİMİ