REST API: Postman ve CRUD

Eğitim Hakkında

REST API CRUD tasarımı ve Postman ile test

Eğitim, REST API'nin CRUD işlemlerini doğru HTTP semantiğiyle tasarlamayı ve Postman ile test etmeyi öğretir. HTTP metotları, idempotency, durum kodları ve başlıklar, Create-Read-Update-Delete uç noktaları (201 Created, 204 No Content, PATCH ve PUT farkı) işlenir. Postman koleksiyonu, ortam değişkenleri, pm.test ile otomatik doğrulama, veri odaklı test, Newman ile komut satırı ve CI çalıştırma uygulanır. Basic, API Key, JWT ve OAuth2 ile kimlik doğrulamalı istekler gösterilir.

Süre ve Format

2 Gün. Her gün dört modül; HTTP ve CRUD Tasarımı; Postman ile Test ve Otomasyon ekseninde ilerleyen uygulamalı program.

Seviye

Başlangıç Seviye — REST API'yi Postman ile test etme ve CRUD uç noktaları: HTTP metotları, durum kodları, Newman otomasyonu ve kimlik doğrulama.

Öğrenme Metodu

Çalışan bir Spring Boot CRUD servisine karşı Postman koleksiyonu adım adım oluşturulur ve Newman ile otomatikleştirilir.

Neden Bu Eğitim?

🧪API Testi

Postman ile otomatik doğrulamalı API testleri yazarsınız.

🔁CRUD Doğruluğu

Doğru HTTP metodu ve durum kodunu seçmeyi öğrenirsiniz.

🤖CI Otomasyonu

Newman ile testleri pipeline'a bağlarsınız.

Anahtar Konular

postman eğitimirest api crudpostman test otomasyonunewman cihttp durum kodlarıapi testrest api tasarımıpostman jwtapi otomasyonujava rest api

“Test edilmeyen bir API, henüz çalışıp çalışmadığı bilinmeyen bir API'dir.”

Ön Koşullar

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

1

HTTP Temeli

İstek-yanıt mantığı bilmek yeterlidir.

2

JSON

JSON söz dizimine aşinalık gerekir.

3

Postman

Postman Desktop kurulu olmalıdır.

4

Örnek Servis

Eğitimde verilen örnek REST servisi çalıştırılacaktır; Java ön bilgisi şart değildir.

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 semantiğine uygun CRUD uç noktalarını tasarlar ve çağırır.

Modül 1

HTTP Metotları ve Durum Kodları

GET, POST, PUT, PATCH, DELETE anlamları
Idempotency ve güvenli metotlar
2xx, 3xx, 4xx, 5xx durum kodu seçimi
Başlıklar: Content-Type, Accept, ETag, Location
201 Created ve Location başlığı
Koşullu istekler: If-Match, If-None-Match

Modül 2

CRUD Uç Noktaları

Create: POST ile kaynak oluşturma ve 201 yanıtı
Read: tekil ve liste, 404 yönetimi
Update: PUT ile tam, PATCH ile kısmi güncelleme
Delete: 204 yanıtı ve silmenin idempotency'si
Sayfalama, filtre ve sıralama parametreleri
Postman ile CRUD akışını uçtan uca doğrulama

Modül 3

REST API Tasarımı

Kaynak odaklı URL tasarımı ve çoğul isimlendirme
HTTP metot ve durum kodu eşlemesi
Idempotency ve güvenli metotlar
Sayfalama, filtreleme ve sıralama parametreleri
API sürümleme stratejileri
HATEOAS ve Spring HATEOAS temelleri

Modül 4

Doğrulama ve Hata Yönetimi

Bean Validation: @NotNull, @Size, @Email, @Pattern
@Valid ve MethodArgumentNotValidException
@ControllerAdvice ve @ExceptionHandler
RFC 7807 ProblemDetail yanıtı
Özel validator (ConstraintValidator)
Tutarlı hata yanıt şeması

Günün hedefiKatılımcı Postman koleksiyonu ve testleri yazar, Newman ile otomatikleştirir.

Modül 1

Postman ile API Test

Koleksiyon, ortam (environment) ve değişkenler
İstek oluşturma: metot, başlık, gövde, kimlik doğrulama
Pre-request script ve test script (pm.test)
Chai assertion ile yanıt doğrulama
Veri odaklı test için CSV/JSON dosyaları
Collection Runner ile toplu çalıştırma

Modül 2

Postman Otomasyonu

Newman ile komut satırında koleksiyon çalıştırma
CI'da (GitHub Actions/Jenkins) Newman raporlama
Ortam değişkenlerini zincirleme (token yakalama)
Mock server ve örnek yanıt
Monitör ile zamanlanmış kontrol
Koleksiyondan OpenAPI üretimi/içe aktarımı

Modül 3

API Kimlik Doğrulama

Basic, API Key ve Bearer token farkları
JWT yapısı ve Postman'da token yönetimi
OAuth2 client credentials akışı
401 ve 403 ayrımı
Hız sınırlama (429) ve Retry-After
Güvenli test verisi ve gizli değişkenler

Modül 4

OpenAPI Dokümantasyonu

springdoc-openapi ile Swagger UI
@Operation ve @Schema ile açıklama
Güvenlik şemasının dokümanda gösterimi
OpenAPI'den istemci üretimi
Sözleşme öncelikli (contract-first) yaklaşım
Dokümantasyonu CI'da doğrulama

Eğitim Kazanımları

Program sonunda katılımcılar:

✅

HTTP Semantiği

Metot ve durum kodu seçimini gerekçelendirebilirsiniz.

🧩

CRUD Tasarımı

Eksiksiz CRUD uç noktalarını tasarlayabilirsiniz.

⚙

Postman Koleksiyonu

Ortam değişkenli koleksiyon oluşturabilirsiniz.

️

Otomatik Test

pm.test ile yanıt doğrulaması yazabilirsiniz.

🔍

Veri Odaklı Test

CSV/JSON ile çoklu senaryo çalıştırabilirsiniz.

🛠

Newman

Koleksiyonu CI içinde çalıştırabilirsiniz.

️

Kimlik Doğrulama

JWT ve OAuth2 isteklerini yönetebilirsiniz.

🧪

Dokümantasyon

Koleksiyondan API dokümanı üretebilirsiniz.

Kimler İçin Uygundur?

REST API kullanan veya test eden geliştiriciler
test mühendisleri
API'ye yeni başlayanlar için uygundur

Sıkça Sorulan Sorular

Bu eğitim kimler için uygundur?

REST API kullanan veya test eden geliştiriciler, test mühendisleri ve API'ye yeni başlayanlar için uygundur.

Java bilmem gerekir mi?

Hayır; eğitimde örnek bir servis hazır sağlanır, odak API tasarımı ve testtir.

PUT ile PATCH farkı nedir?

PUT kaynağı tam, PATCH kısmen günceller; eğitimde örneklerle gösterilir.

Newman nedir?

Postman koleksiyonlarını komut satırında çalıştıran araçtır; CI entegrasyonu için kullanılır.

Eğitim sonunda sertifika verilir mi?

Katılım ve değerlendirme sonrasında 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

REST API WITH JAVA: REST APIS WITH POSTMAN & CRUD EĞİTİMİ