Working with RESTful APIs

Eğitim Hakkında

RESTful API ile çalışma: CRUD akışları, Postman testleri, kimlik doğrulama ve otomasyon

Bu eğitim, RESTful API'leri tüketirken ve test ederken ihtiyaç duyulan pratik becerileri verir. GET/POST/PUT/PATCH/DELETE ile CRUD akışı, idempotency, Location başlığı, Postman koleksiyonu ve ortam değişkenleri, pm.test ile durum kodu ve JSON alan doğrulaması, istekler arası veri aktarımı, Bearer token ve OAuth 2.0, OpenAPI ile Swagger UI keşfi, Newman ile komut satırından ve CI hattında çalıştırma uygulanır. Negatif senaryolar ve veri güdümlü testler de yazılır.

Süre ve Format

2 Gün. Her gün dört modül; katılımcılar RESTful API Kullanımı ve Test Başlangıcı → Hata Ayıklama, Güvenlik ve Otomasyon sırasıyla ilerler.

Seviye

Temel Seviye — RESTful API ile çalışma: CRUD akışları, Postman testleri, kimlik doğrulama ve otomasyon.

Öğrenme Metodu

Katılımcılar örnek bir REST API üzerinde Postman koleksiyonu ve test betikleri yazar, ardından Newman ile otomatik çalıştırıp rapor üretir.

Neden Bu Eğitim?

🧪Otomatik Doğrulama

Elle yapılan kontrolleri tekrar çalıştırılabilir testlere dönüştürürsünüz.

🔁CRUD Akışları

Oluştur-oku-güncelle-sil zincirini bağımsız testlerle doğrularsınız.

⚙️CI Entegrasyonu

Newman ile testleri derleme hattının parçası yaparsınız.

Anahtar Konular

RESTful API testPostman testpm.testNewmanAPI test otomasyonuOpenAPI SwaggerCRUD testBearer tokenveri güdümlü testAPI test eğitimi

“Bir kez elle denenen API, bir kez bozulmayı bekler; otomatik test eder.”

Ö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ı GET, POST, PUT, PATCH ve DELETE metotlarını güvenlik ve idempotency açısından ayırır, Basit bir kaynak üzerinde CRUD uç noktalarını uygulayıp curl ile doğrular, Postman koleksiyonu, ortam değişkeni ve kimlik doğrulama ayarlarını yapılandırır ve pm.test ve pm.expect ile otomatik doğrulama yazar, koleksiyonu veri dosyasıyla çalıştırır.

Modül 1

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 2

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 3

Postman Koleksiyonları ve Ortam Yönetimi

Çalışma alanı, koleksiyon, klasör ve istek hiyerarşisi ile adlandırma düzeni
Ortam (environment), global ve koleksiyon değişkenleri: {{baseUrl}} ve kapsam öncelik sırası
Authorization sekmesi: Bearer, OAuth 2.0 token alma akışı ve koleksiyon düzeyinde kalıtım
Pre-request script ile dinamik değişken, zaman damgası ve HMAC imzası üretme
OpenAPI dosyasından koleksiyon içe aktarma ve Postman API Network kullanımı
Koleksiyon dokümantasyonu yayınlama ve takım çalışma alanında sürüm/çatallama (fork) akışı

Modül 4

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ı

Günün hedefiKatılımcı Tarayıcı geliştirici araçları, curl, Fiddler ve mitmproxy ile API trafiğini inceler, API kimlik doğrulama yöntemlerini, JWT yapısını ve OWASP API Top 10 risklerini ele alır, OpenAPI 3 tanımı yazar, Swagger UI ve kod üreticilerle sözleşme öncelikli çalışır ve Newman ile koleksiyonları CI hattında çalıştırır, mock server ve monitör kurar.

Modül 1

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 2

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

Modül 3

OpenAPI ile Sözleşme Öncelikli Tasarım

OpenAPI 3.0 belge yapısı: info, servers, paths, components, schemas ve securitySchemes
JSON Schema ile nesne modelleme: required, enum, oneOf, allOf ve $ref ile yeniden kullanım
Swagger Editor ve Swagger UI ile etkileşimli dokümantasyon yayınlama
openapi-generator ile istemci SDK ve sunucu iskeleti üretimi
Spectral ile OpenAPI lint kuralları ve CI hattında sözleşme doğrulama
Örnek (example) ve yanıt şeması ile mock sunucu (Prism) üzerinden tüketici ekiple paralel çalışma

Modül 4

Newman, CI/CD ve Mock Server

Newman kurulumu ve newman run komutu: -e, -d, --iteration-count, --bail seçenekleri
htmlextra ve JUnit raporlayıcıları ile test sonuçlarının üretilmesi
GitHub Actions veya Jenkins hattına Newman adımı ekleme ve başarısız testte derlemeyi durdurma
Postman Mock Server ile örnek yanıtlardan sahte servis oluşturma
Postman Monitors ile zamanlanmış kontrol ve uyarı yapılandırması
Gizli bilgilerin (API anahtarı) CI ortam değişkeni veya vault ile koleksiyona verilmesi

Eğitim Kazanımları

Program sonunda katılımcılar:

✅

HTTP Metotları

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

🧩

CRUD API

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

🛠️

Postman Koleksiyon

Koleksiyon, klasör ve ortam değişkenleriyle düzenli bir Postman çalışma alanı kurabilirsiniz.

🔐

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.

🧪

API Güvenliği

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

🚀

OpenAPI

OpenAPI 3 tanımı yazıp Swagger UI ve kod üretimiyle sözleşme öncelikli geliştirebilirsiniz.

🔎

Newman ve CI

Newman ile Postman testlerini CI hattında raporlu şekilde çalıştırabilirsiniz.

Kimler İçin Uygundur?

Test mühendisleri
QA uzmanları
entegrasyon geliştiricileri
API test otomasyonuna başlamak isteyen yazılımcılar için uygundur

Sıkça Sorulan Sorular

Bu eğitim kimler için uygundur?

Test mühendisleri, QA uzmanları, entegrasyon geliştiricileri ve API test otomasyonuna başlamak isteyen yazılımcılar için uygundur.

Postman bilgisi şart mı?

Hayır, Postman kullanımı eğitimde sıfırdan anlatılır.

JavaScript bilmem gerekiyor mu?

pm.test betikleri için temel JavaScript örneklerle öğretilir; derin bilgi gerekmez.

Hangi API kullanılacak?

Eğitim için hazırlanmış bir demo REST API ve herkese açık test API'leri kullanılı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

INTRODUCING API FUNDAMENTALS & TESTING: WORKING WITH RESTFUL APIS EĞİTİMİ