API Development: Tools Eğitimi

Eğitim Hakkında

API geliştirme sürecinde kullanılan araçlar

Eğitim API geliştirme sürecinin farklı aşamalarındaki araçları tanıtır. curl, HTTPie, jq ve Postman ile istek yönetimi, değişken ve ortamlar, SoapUI ile SOAP ve REST testi, Swagger Editor, Spectral ve openapi-generator ile tasarım, JMeter ile yük testine giriş, Burp Suite ve ZAP ile güvenlik testi ve mock sunucuların kullanımı uygulamalı işlenir.

Süre ve Format

2 Gün. Her gün dört modül; 1. gün API Araçları ve Postman; 2. gün Tasarım, Yük ve Güvenlik Araçları.

Seviye

Temel Seviye — API geliştirme sürecinde kullanılan araçlar

Öğrenme Metodu

Her konu, gerçek bir API üzerinde istek göndererek ve tasarım kararlarını tartışarak işlenir; katılımcılar OpenAPI tanımı yazıp Postman ve curl ile sonuçlarını doğrular.

Neden Bu Eğitim?

📐Tasarım Kuralları

HTTP semantiği, URI ve model kararlarını standartlara dayandırarak tutarlı API'ler tasarlarsınız.

🔍Canlı İnceleme

Gerçek istek ve yanıtları curl ve Postman ile inceleyerek teoriyi hemen pratiğe dökersiniz.

📄Sözleşme Odaklılık

OpenAPI ile yazılan sözleşme sayesinde ekipler arası uyumu ve dokümantasyonu otomatikleştirirsiniz.

Anahtar Konular

rest apirestful apiapi tasarımıopenapiswaggerhttp metotlarıjsonapi geliştirmeapi development: tools

“Doğru araç, yarım günü on dakikaya indirir.”

Ön Koşullar

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

1

Programlama Temeli

Herhangi bir dilde temel programlama bilgisi ve JSON okuyabilme becerisi yeterlidir.

2

Web Bilgisi

Tarayıcı, URL ve HTTP'nin kabaca nasıl çalıştığına dair temel fikir faydalıdır.

3

Araçlar

Postman, curl ve bir metin editörü (VS Code) kurulu bir bilgisayar gerekir.

4

Merak

Örnek API'ler üzerinde deneme yapmaya açık olmak yeterli ön koşuldur.

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ı gün sonunda API Geliştirme Araçları konusunu çalıştırır, Postman Arayüzü ve İlk İstekler ve Postman Değişkenleri ve Ortamlar ile ilerleyip SoapUI ile Servis Testine Giriş kararlarını gerekçelendirir.

Modül 1

API Geliştirme Araçları

curl ile GET, POST, başlık ekleme, -v çıktısı ve dosya yükleme
Postman ve Insomnia ile koleksiyon, ortam ve istek geçmişi yönetimi
HTTPie ve jq ile komut satırında JSON işleme
Swagger UI ve Redoc ile etkileşimli dokümantasyon
Fiddler, Charles veya mitmproxy ile trafik yakalama ve inceleme
Mock sunucular: json-server, WireMock ve Prism ile sahte API üretimi

Modül 2

Postman Arayüzü ve İlk İstekler

Workspace, collection, folder ve request hiyerarşisi
GET, POST, PUT, DELETE istekleri; params, headers, body (raw JSON, form-data, x-www-form-urlencoded)
Yanıt panelinde Body, Cookies, Headers, Test Results ve süre / boyut bilgisi
Authorization sekmesi: API Key, Bearer Token, Basic Auth, OAuth 2.0
Postman Console ile istek / yanıt ayrıntılarının hata ayıklaması
Collection'ı dışa aktarma, içe aktarma ve ekip workspace'inde paylaşma

Modül 3

Postman Değişkenleri ve Ortamlar

Değişken kapsamları: global, collection, environment, data, local ve öncelik sırası
{{değişken}} sözdizimi ve pm.variables, pm.environment, pm.collectionVariables API'leri
Dev, test ve prod için ayrı environment'lar ile baseUrl yönetimi
Login yanıtından token çıkarıp sonraki isteklere otomatik taşıma
Initial value ile current value farkı ve gizli (secret) değişkenlerin korunması
Dinamik değişkenler: {{$guid}}, {{$timestamp}}, {{$randomInt}}

Modül 4

SoapUI ile Servis Testine Giriş

WSDL ve OpenAPI içe aktarma, otomatik istek şablonu üretimi
Test suite, test case ve test step hiyerarşisi
SOAP request, REST request, Properties ve Delay test adımları
Property Transfer ile adımlar arası veri aktarımı
Çevre (endpoint) yönetimi ve çoklu ortam testi
SoapUI açık kaynak ile ReadyAPI özelliklerinin karşılaştırılması

Günün hedefiKatılımcı OpenAPI ile Sözleşme ve Dokümantasyon ve API Öncelikli Tasarım Süreci konularını uygulayarak JMeter Mimarisi ve Test Planı ile API Sızma Testi Uygulaması adımlarını aynı örnek üzerinde birleştirir.

Modül 1

OpenAPI ile Sözleşme ve Dokümantasyon

OpenAPI 3.x yapısı: paths, components, schemas, parameters, responses
$ref ile yeniden kullanım, allOf / oneOf ve discriminator
securitySchemes: apiKey, http bearer, oauth2 ve openIdConnect
Swagger Editor ve Stoplight ile tasarım, Spectral ile kural tabanlı lint
openapi-generator ile sunucu iskeleti ve istemci SDK'sı üretimi
Örnek (example) alanları ve Redoc ile geliştirici dokümanı yayınlama

Modül 2

API Öncelikli Tasarım Süreci

API-first ve code-first yaklaşımları: ekipler arası paralel çalışma avantajı
Kullanıcı yolculuğundan (user journey) kaynak ve işlem listesinin çıkarılması
Sözleşmeyi önce yazıp mock sunucudan istemci geliştirmeyi başlatma
Tasarım gözden geçirme (API review) oturumu ve stil rehberi oluşturma
Spectral kuralları ve CI içinde sözleşme lint'i
Breaking change tespiti için openapi-diff ve sözleşme sürüm kontrolü

Modül 3

JMeter Mimarisi ve Test Planı

JMeter bileşenleri: Test Plan, Thread Group, Sampler, Listener, Config Element, Timer
HTTP Request sampler, HTTP Header Manager ve HTTP Cookie Manager
Thread Group parametreleri: thread sayısı, ramp-up, loop count, scheduler
HTTP(S) Test Script Recorder ile kayıt ve temizleme
View Results Tree, Summary Report ve Aggregate Report yorumlama
Kullanıcı Tanımlı Değişkenler ve JMeter özelliklerinin (properties) kullanımı

Modül 4

API Sızma Testi Uygulaması

Burp Suite ve OWASP ZAP ile API trafiğini proxy üzerinden yakalama
OpenAPI veya Postman koleksiyonundan otomatik tarama
Intruder / fuzzing ile parametre ve kimlik numarası denemeleri
Enjeksiyon testleri: SQL, NoSQL ve komut enjeksiyonu
Rate limit, CORS ve başlık yapılandırması kontrolü
Bulguların CVSS ile derecelendirilip düzeltme önerisiyle raporlanması

Eğitim Kazanımları

Program sonunda katılımcılar:

✅

API Araç Seti

Geliştirme sırasında curl, Postman, jq ve proxy araçlarını verimli biçimde kullanabilirsiniz.

🧩

Postman Kullanımı

Postman'da koleksiyon oluşturup farklı kimlik doğrulama yöntemleriyle istek gönderebilirsiniz.

🔧

Değişken Yönetimi

Değişken kapsamlarını ve ortam yapılarını kullanarak yeniden kullanılabilir Postman koleksiyonları kurabilirsiniz.

📐

SoapUI Temelleri

SoapUI'da WSDL ve OpenAPI'den test suite oluşturup çalıştırabilirsiniz.

🛡️

OpenAPI Sözleşmesi

OpenAPI ile makine okunur API sözleşmesi yazıp kod ve doküman üretebilirsiniz.

🧪

API-First Çalışma

Sözleşmeyi koddan önce tasarlayan bir API-first iş akışını ekibinize uygulayabilirsiniz.

🚀

JMeter Test Planı

JMeter'da Thread Group ve HTTP sampler'lardan oluşan bir test planı kurabilirsiniz.

📊

Sızma Testi

Burp Suite ve ZAP ile API uçlarında güvenlik testi yapıp bulguları raporlayabilirsiniz.

Kimler İçin Uygundur?

API ile çalışmaya yeni başlayan geliştiriciler
test mühendisleri
teknik analistler içindir

Sıkça Sorulan Sorular

Bu eğitim kimler için uygundur?

API ile çalışmaya yeni başlayan geliştiriciler, test mühendisleri ve teknik analistler içindir.

Hangi dil ve çatı kullanılıyor?

Tasarım ilkeleri dilden bağımsızdır; uygulama örnekleri OpenAPI, Postman ve seçilen bir sunucu çatısı üzerinden gösterilir.

Hazır API mi kullanılacak, yoksa kendimiz mi yazacağız?

Her ikisi de; hazır genel API'lerle başlanır, ardından kendi örnek API'nizi tasarlayıp sözleşmesini yazarsınız.

Eğitim sonunda ne öğrenmiş olacağım?

Tutarlı bir REST API tasarlayıp OpenAPI ile belgeleyebilir, hata, sürümleme ve güvenlik konularında karar verebilirsiniz.

Sertifika veriliyor mu?

Evet, tamamlayan katılımcılara 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

API DEVELOPMENT: TOOLS EĞİTİMİ