Installation, Express-generator, & API Eğitimi

Eğitim Hakkında

Express kurulumu, express-generator iskeleti ve temel API geliştirme

Bu eğitim Node.js üzerinde Express ile ilk API'nin sıfırdan kurulmasını anlatır. Node.js ve npm kurulumu, npx express-generator ile iskelet oluşturma, bin/www ve app.js yapısı, router ve route parametreleri, express.json gövde ayrıştırma, morgan/cors/helmet ara katmanları, özel hata middleware'i işlenir. Ürün kaynağı için CRUD uç noktaları yazılır, doğru durum kodları döndürülür, PostgreSQL bağlantısı kurulur, Supertest ile test edilir ve dotenv ile yapılandırma yönetilir.

Süre ve Format

2 Gün. Her gün dört modül; katılımcılar Express Kurulumu ve İlk API → API Kalitesi ve Veritabanı sırasıyla ilerler.

Seviye

Temel Seviye — Express kurulumu, express-generator iskeleti ve temel API geliştirme.

Öğrenme Metodu

Katılımcılar her adımda kendi bilgisayarında Express projesi kurar, uç noktaları yazar ve Postman ile çalışırlığını doğrular.

Neden Bu Eğitim?

⚡Hızlı Başlangıç

express-generator ile iskeleti dakikalar içinde kurar ve çalıştırırsınız.

🧩Middleware Mantığı

İstek yaşam döngüsünü ara katmanlarla kontrol etmeyi öğrenirsiniz.

✅Doğru API

Durum kodu ve JSON sözleşmesi doğru çalışan bir API teslim edersiniz.

Anahtar Konular

express-generatorExpress.jsNode.js APIExpress kurulumuNode.js REST APIExpress routerExpress middlewareSupertestnpmJavaScript API eğitimi

“İlk çalışan uç nokta, bin satırlık planın değerini aşar.”

Ö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, Express iskeletini express-generator ile kurar, yönlendirme ve ara katman yapısını ele alır, 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

Node.js Express Kurulumu ve express-generator

Node.js ve npm kurulumu, npx express-generator ile proje iskeleti ve oluşan klasör yapısı (bin/www, app.js, routes)
Router, route parametreleri (req.params), sorgu (req.query) ve gövde ayrıştırma (express.json)
Ara katman (middleware) zinciri: morgan günlükleme, cors, helmet ve özel hata yakalayıcı middleware
Görünüm motorunu kaldırıp yalnızca JSON dönen API iskeletine çevirme
dotenv ile ortam değişkenleri, nodemon ile geliştirme döngüsü ve PORT yapılandırması
Supertest ve Jest ile Express uç noktalarına birim ve entegrasyon testi yazma

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, REST API katmanlarını veritabanına bağlar ve ortamlara dağıtım adımlarını uygular ve API kimlik doğrulama yöntemlerini, JWT yapısını ve OWASP API Top 10 risklerini ele alır.

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

REST API Mimarisi ve Veritabanı Dağıtımı

Katmanlı mimari: controller, service, repository ve veri erişim sınırlarının ayrılması
ORM ile ilişkisel veritabanı erişimi, bağlantı havuzu (HikariCP/pg-pool) ve işlem (transaction) sınırları
Flyway veya Liquibase ile şema geçişi (migration) ve sürümlü veritabanı değişiklikleri
Dockerfile ve docker-compose ile API + PostgreSQL ortamını tek komutla ayağa kaldırma
Ortama göre yapılandırma: secret yönetimi, sağlık uç noktası (/health) ve readiness kontrolü
Dağıtım sonrası duman testi, veritabanı yedeği ve geri alma (rollback) planı

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.

🧩

Express İskeleti

express-generator ile iskelet kurup yönlendirme ve ara katmanlarla çalışan bir API ayağa kaldırabilirsiniz.

🛠️

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.

🚀

REST ve Veritabanı

Katmanlı bir REST API'yi veritabanıyla birlikte konteyner olarak dağıtabilirsiniz.

🔎

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?

Node.js'e yeni başlayan geliştiriciler
frontend'den backend'e geçenler
ilk kez API yazacak öğrenciler ile profesyoneller için uygundur

Sıkça Sorulan Sorular

Bu eğitim kimler için uygundur?

Node.js'e yeni başlayan geliştiriciler, frontend'den backend'e geçenler ve ilk kez API yazacak öğrenciler ile profesyoneller için uygundur.

Node.js bilgisi gerekli mi?

Temel JavaScript yeterlidir; Node.js kurulumu ve npm eğitimde gösterilir.

Görünüm motoru (Pug) kullanılıyor mu?

Generator iskeleti incelenir, ardından yalnızca JSON dönen API yapısına dönüştürülür.

TypeScript ele alınıyor mu?

Eğitim JavaScript ile yapılır; TypeScript geçişi için kısa bir yönlendirme verilir.

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

INSTALLATION, EXPRESS-GENERATOR, & API EĞİTİMİ