Understanding APIs

Eğitim Hakkında

API temelleri: HTTP, REST, JSON, durum kodları ve Postman ile ilk istekler

Bu başlangıç eğitimi, API kavramını hiç bilmeyenler için tasarlanmıştır. API'nin ne olduğu, web servislerinin tarihçesi, SOAP ve REST farkı, HTTP istek/yanıt yapısı, URL anatomisi, JSON ve XML formatları, GET/POST/PUT/DELETE metotları, 2xx-5xx durum kodları işlenir. Katılımcılar herkese açık API'lere curl ve Postman ile istek atar, yanıtları yorumlar, hata ayıklar ve koleksiyon oluşturur. Test düşüncesinin temelleri bu çerçevede tanıtılır.

Süre ve Format

2 Gün. Her gün dört modül; katılımcılar API Kavramı ve HTTP → Metotlar, Hatalar ve İlk Testler sırasıyla ilerler.

Seviye

Başlangıç Seviye — API temelleri: HTTP, REST, JSON, durum kodları ve Postman ile ilk istekler.

Öğrenme Metodu

Katılımcılar açık API'lere gerçek istekler göndererek Postman ve curl ile adım adım ilerler; kod yazmak zorunlu değildir.

Neden Bu Eğitim?

🌱Sıfırdan Başlangıç

Ön bilgi gerektirmeden API'nin temel mantığını kavrarsınız.

📨Gerçek İstekler

Açık API'lere kendi isteklerinizi gönderip yanıtları okursunuz.

🧭Test Bakışı

API'yi test etmeye başlamak için gereken temel soruları öğrenirsiniz.

Anahtar Konular

API nedirAPI temelleriHTTP öğrenREST API başlangıçPostman başlangıçAPI test başlangıçJSON nedirHTTP durum kodlarıcurl kullanımıweb servisleri

“API'yi anlamak, yazılımların birbirine nasıl konuştuğunu duymaktır.”

Ö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 Accept/Content-Type ile içerik pazarlığı yapar ve JSON ile XML serileştirmesini karşılaştı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

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

Günün hedefiKatılımcı GET, POST, PUT, PATCH ve DELETE metotlarını güvenlik ve idempotency açısından ayırır, HTTP durum kodlarını seçer ve RFC 7807 Problem Details ile hata yanıtı tasarlar, Tarayıcı geliştirici araçları, curl, Fiddler ve mitmproxy ile API trafiğini inceler ve Postman koleksiyonu, ortam değişkeni ve kimlik doğrulama ayarlarını yapılandı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

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

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

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

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.

🔐

İçerik Formatları

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

📈

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.

🚀

API Hata Ayıklama

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

🔎

Postman Koleksiyon

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

Kimler İçin Uygundur?

Manuel test uzmanları
iş analistleri
yeni mezunlar
API'lerle ilk kez karşılaşacak teknik ve yarı teknik çalışanlar için uygundur

Sıkça Sorulan Sorular

Bu eğitim kimler için uygundur?

Manuel test uzmanları, iş analistleri, yeni mezunlar ve API'lerle ilk kez karşılaşacak teknik ve yarı teknik çalışanlar için uygundur.

Hiç yazılım bilmiyorum, katılabilir miyim?

Evet, eğitim sıfırdan başlar; ileri bir programlama bilgisi gerekmez.

Hangi araçlar kullanılacak?

Postman, curl ve tarayıcı geliştirici araçları kullanılacak, kurulum eğitimde yapılır.

Sonrasında hangi eğitime geçilebilir?

REST API testi, Postman otomasyonu ve REST Assured eğitimleri doğal devam yoludur.

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: UNDERSTANDING APIS EĞİTİMİ