Python ile API ve API Tasarımı

Eğitim Hakkında

API tasarım ilkeleri ve Python ile uygulama

Eğitim, RESTful API tasarımını Python uygulamasıyla birleştirir. HTTP semantiği, kaynak adlandırma, durum kodları, sürümleme, hata standardı, OpenAPI sözleşmesi ve FastAPI ile Flask uygulamaları işlenir. JWT ve OAuth 2.0 kimlik doğrulama, Pydantic doğrulaması, SQLAlchemy veri katmanı ve pytest ile API testi uygulamalı çalışılır.

Süre ve Format

2 Gün. Her gün dört modül; 1. gün REST Tasarımı ve Temel API; 2. gün Güvenlik, Entegrasyon ve Test. Her modül uygulamalı alıştırmalarla pekiştirilir.

Seviye

Orta Seviye — RESTful API tasarım ilkeleri ile Flask ve FastAPI uygulamasını, kimlik doğrulama ve testi birlikte kapsar.

Öğrenme Metodu

Her gün küçük bir ürün API'sinin tasarım dokümanından çalışan koda geçişi canlı kodlama ve Swagger UI üzerinde denemelerle yapılır.

Neden Bu Eğitim?

🎯Tutarlı API sözleşmesi

URL, durum kodu ve hata biçimini standartlaştırarak istemci ekiplerin işini kolaylaştırırsınız.

🛠️Hızlı geliştirme

FastAPI ve Pydantic ile doğrulama ve dokümantasyonu otomatiğe bağlarsınız.

📈Güvenli yayına hazırlık

JWT, OAuth 2.0 ve OWASP API riskleri konusunda güvenlik açıklarını önceden kapatırsınız.

Anahtar Konular

python apiapi tasarımırest api pythonfastapi eğitimiflask apiopenapijwt kimlik doğrulamapydanticapi güvenliğipython backend

“İyi API, kullanılması kolay olan sözleşmedir.”

Ön Koşullar

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

1

Python bilgisi

Fonksiyon, sınıf ve modül kavramlarını içeren orta düzey Python bilgisi beklenir.

2

Web temelleri

HTML'in ne olduğuna ve tarayıcının sunucudan sayfa istediğine dair genel bilgi faydalıdır.

3

Geliştirme ortamı

Python 3.10+, pip, venv ve VS Code yüklü bir bilgisayar ile modern bir tarayıcı gereklidir.

4

Komut satırı

Terminal komutları (cd, ls/dir, pip) ve temel Git kullanımı konusunda rahatlık önerilir.

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ı REST ilkelerine uygun kaynaklar tasarlar ve FastAPI ile çalışan uç noktalar yazar.

Modül 1

HTTP ve REST Temelleri

HTTP istek/yanıt yapısı: metot, başlık, gövde, durum kodu
GET, POST, PUT, PATCH, DELETE ve idempotentlik
REST kısıtları: kaynak (resource) odaklı URL tasarımı
Durum kodu seçimi: 200, 201, 204, 400, 401, 403, 404, 409, 422, 500
İçerik müzakeresi: Accept ve Content-Type başlıkları
curl ve HTTPie ile elle istek atma

Modül 2

API Tasarım İlkeleri

Kaynak adlandırma, çoğul isimler ve iç içe kaynaklar
Sürümleme stratejileri: URL, başlık ve içerik tabanlı
Hata yanıtı standardı ve RFC 7807 problem details
HATEOAS, ETag ve koşullu istekler (If-None-Match)
Hız sınırlama (rate limiting) ve idempotency key
OpenAPI 3 sözleşmesi ile tasarım-önce (design-first) yaklaşım

Modül 3

FastAPI ile API Geliştirme

FastAPI uygulaması, path/query parametreleri ve tip ipuçları
Pydantic modelleriyle istek/yanıt doğrulama
Bağımlılık enjeksiyonu (Depends) ve güvenlik şemaları
async def uç noktaları ve ne zaman fayda sağladığı
Otomatik OpenAPI / Swagger UI dokümantasyonu
uvicorn ile çalıştırma ve APIRouter ile yapılandırma

Modül 4

Veri Katmanı: SQLAlchemy ve Doğrulama

SQLAlchemy ORM modelleri, session ve sorgu API'si
CRUD uç noktaları ve transaction sınırı
Alembic ile şema göçleri (migration)
Pydantic / marshmallow ile serileştirme ve doğrulama
İlişkiler (one-to-many, many-to-many) ve N+1 sorgu sorunu
Sayfalama, filtreleme ve sıralama parametreleri

Günün hedefiKatılımcı API'yi JWT ile korur, istemci kodu yazar ve pytest ile test eder.

Modül 1

Kimlik Doğrulama ve Yetkilendirme

Basic auth, API anahtarı ve Bearer token farkı
OAuth 2.0 yetki kodu ve client credentials akışları
JWT yapısı: header, payload, imza ve süre (exp)
PyJWT ile token üretme ve doğrulama
Parola saklama: bcrypt / passlib ile hash
Secret yönetimi: ortam değişkeni, .env ve kodda anahtar tutmama

Modül 2

requests ile API İstemcisi

requests.get/post, params, json= ve headers kullanımı
Session nesnesi, bağlantı havuzu ve çerez yönetimi
timeout, raise_for_status() ve hata sınıfları
Yeniden deneme: urllib3 Retry ve HTTPAdapter
Sayfalama (pagination) ve hız sınırı (429, Retry-After) yönetimi
httpx ile eşzamansız (async) istemci

Modül 3

API Test, Güvenlik ve Yayın

pytest + Flask test client / FastAPI TestClient ile uç nokta testleri
Postman / Newman ile koleksiyon otomasyonu
OWASP API Top 10: BOLA, aşırı veri ifşası, mass assignment
Girdi doğrulama, SQL enjeksiyonu ve güvenli başlıklar
Docker imajı ve docker-compose ile servis paketleme
Loglama, izleme ve sağlık (health) uç noktaları

Modül 4

İstemci ve Sunucu Entegrasyonu

Sunucu uç noktasını gerçek istemci kodu ile uçtan uca çağırma
WebSocket ve Server-Sent Events ile anlık veri akışı
Webhook alma, imza doğrulama ve yeniden deneme
Arka plan görevleri: Celery / BackgroundTasks
Üçüncü parti API için SDK sarmalayıcı sınıf yazma
Sözleşme testi ve mock sunucu (responses, respx)

Eğitim Kazanımları

Program sonunda katılımcılar:

✅

HTTP ve REST

HTTP semantiği ve REST kısıtlarına uygun uç noktaları tasarlayabilirsiniz

🔧

API Tasarımı

Sürümleme, hata standardı ve OpenAPI sözleşmesiyle API tasarlayabilirsiniz

📊

FastAPI

FastAPI ve Pydantic ile doğrulamalı, otomatik dokümante API yazabilirsiniz

🧩

API Veri Katmanı

SQLAlchemy ve Alembic ile kalıcı CRUD API'leri oluşturabilirsiniz

🚀

API Güvenliği

API anahtarı, OAuth 2.0 ve JWT ile kimlik doğrulama akışlarını uygulayabilirsiniz

🔍

requests İstemcisi

Zaman aşımı, yeniden deneme ve sayfalama ile dayanıklı API istemcisi yazabilirsiniz

🛡️

API Test ve Yayın

API'yi pytest ile test edip güvenlik kontrolleri yaparak Docker ile yayınlayabilirsiniz

📌

İstemci-Sunucu Entegrasyonu

Webhook, WebSocket ve arka plan görevleriyle uçtan uca entegrasyon kurabilirsiniz

Kimler İçin Uygundur?

Backend geliştiriciler
API tüketen ve üreten yazılımcılar
mikroservis mimarisine geçen ekipler

Sıkça Sorulan Sorular

Bu eğitim kimler için uygundur?

Backend geliştiriciler, API tüketen ve üreten yazılımcılar, mikroservis mimarisine geçen ekipler.

Eğitim sonunda sertifika verilir mi?

Eğitimi tamamlayan katılımcılar Digital Vizyon Akademi Katılım ve Başarı Sertifikası almaya hak kazanır; sertifika DVA'nın kendi katılım ve başarı belgesidir.

Eğitim için hangi yazılımlar gereklidir?

Python 3.10 veya üzeri, bir kod editörü (VS Code ya da PyCharm) ve eğitimin konusuna göre listelenen paketler yeterlidir; kurulum adımları ilk oturumda birlikte kontrol edilir.

FastAPI mi Flask mı öğretiliyor?

Her ikisi de işlenir; FastAPI ana uygulamadır, Flask ile karşılaştırma ve Blueprint yapısı gösterilir.

OpenAPI/Swagger dokümantasyonu üretilecek mi?

Evet, FastAPI'nin otomatik OpenAPI çıktısı ve tasarım-önce (design-first) yaklaşım ikinci modülde uygulanır.

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 AND API DESIGN WITH PYTHON EĞİTİMİ