Modern web uygulamalar\u0131 geli\u015ftirirken h\u0131z, performans ve s\u00fcrd\u00fcr\u00fclebilirlik temel beklentilerdir. Python ekosisteminin parlayan y\u0131ld\u0131zlar\u0131ndan FastAPI, bu beklentileri fazlas\u0131yla kar\u015f\u0131layan, y\u00fcksek performansl\u0131, kullan\u0131m\u0131 kolay ve kendi kendini belgeleyen bir web framework’\u00fcd\u00fcr. Bu makale, FastAPI’nin temel mimari prensiplerini, temiz kod yazma yakla\u015f\u0131mlar\u0131n\u0131, \u00f6l\u00e7eklenebilirlik stratejilerini ve otomatik dok\u00fcmantasyon yeteneklerini detayl\u0131 bir \u015fekilde inceleyerek, geli\u015ftiricilere sa\u011flam ve s\u00fcrd\u00fcr\u00fclebilir API’ler in\u015fa etme konusunda rehberlik etmeyi ama\u00e7lamaktad\u0131r.<\/p>\n
FastAPI, modern Python tip ipu\u00e7lar\u0131n\u0131 kullanarak API’ler olu\u015fturmak i\u00e7in geli\u015ftirilmi\u015f, y\u00fcksek performansl\u0131 bir web framework’\u00fcd\u00fcr. Starlette ve Pydantic \u00fczerine in\u015fa edilmi\u015f olmas\u0131, ona e\u015fsiz bir h\u0131z ve veri do\u011frulama yetene\u011fi kazand\u0131r\u0131r.<\/p>\n
G\u00fcn\u00fcm\u00fcz\u00fcn web uygulamalar\u0131, h\u0131zl\u0131 yan\u0131t s\u00fcreleri, y\u00fcksek e\u015fzamanl\u0131l\u0131k ve kolay bak\u0131m gibi \u00f6zelliklere ihtiya\u00e7 duyar. RESTful API’ler, mikroservis mimarileri ve ger\u00e7ek zamanl\u0131 uygulamalar, geleneksel senkron framework’lerin s\u0131n\u0131rlar\u0131n\u0131 zorlamaktad\u0131r. FastAPI, bu modern ihtiya\u00e7lara asenkron yetenekleri ve g\u00fc\u00e7l\u00fc veri do\u011frulama mekanizmalar\u0131yla cevap verir.<\/p>\n
FastAPI, ASGI (Asynchronous Server Gateway Interface) standard\u0131n\u0131 temel al\u0131r. Bu sayede, ayn\u0131 anda birden fazla iste\u011fi i\u015fleyebilir ve I\/O yo\u011fun i\u015flemler (veritaban\u0131 sorgular\u0131, a\u011f istekleri vb.) s\u0131ras\u0131nda di\u011fer i\u015flemleri bloke etmeden \u00e7al\u0131\u015fabilir. Bu asenkron yap\u0131, \u00f6zellikle y\u00fcksek trafikli uygulamalar i\u00e7in kritik bir performans avantaj\u0131 sa\u011flar.<\/p>\n
\nfrom fastapi import FastAPI\n\napp = FastAPI()\n\n@app.get(\"\/\")\nasync def read_root():\n return {\"message\": \"Merhaba D\u00fcnya!\"}\n<\/pre>\n<\/code><\/p>\n
Pydantic ile Veri Do\u011frulama ve Serile\u015ftirme<\/h4>\n
Pydantic, Python tip ipu\u00e7lar\u0131n\u0131 kullanarak veri do\u011frulama, serile\u015ftirme ve belgeleme sa\u011flayan bir k\u00fct\u00fcphanedir. FastAPI, Pydantic'i do\u011frudan entegre ederek gelen istek verilerinin (request body, query parameters, path parameters) otomatik olarak do\u011frulanmas\u0131n\u0131 ve giden yan\u0131tlar\u0131n (response body) otomatik olarak serile\u015ftirilmesini sa\u011flar. Bu, hata ay\u0131klama s\u00fcresini azalt\u0131r ve API'nin g\u00fcvenilirli\u011fini art\u0131r\u0131r.<\/p>\n
\nfrom pydantic import BaseModel\n\nclass Item(BaseModel):\n name: str\n description: str | None = None\n price: float\n tax: float | None = None\n\n@app.post(\"\/items\/\")\nasync def create_item(item: Item):\n return item\n<\/pre>\n<\/code><\/p>\n
Geli\u015ftirici Deneyimi ve H\u0131zl\u0131 Geli\u015ftirme<\/h4>\n
FastAPI, geli\u015ftirici dostu bir framework't\u00fcr. Otomatik dok\u00fcmantasyon, g\u00fc\u00e7l\u00fc tip kontrol\u00fc ve basit API tasar\u0131m\u0131, geli\u015ftirme s\u00fcrecini h\u0131zland\u0131r\u0131r ve hatalar\u0131 azalt\u0131r. Tip ipu\u00e7lar\u0131 sayesinde IDE'ler, otomatik tamamlama ve hata kontrol\u00fc gibi \u00f6zelliklerle geli\u015ftiricilere b\u00fcy\u00fck kolayl\u0131k sa\u011flar.<\/p>\n
Temiz Mimari Prensipleri ve FastAPI<\/h3>\n
Temiz mimari (Clean Architecture), yaz\u0131l\u0131m\u0131n i\u015f mant\u0131\u011f\u0131n\u0131 d\u0131\u015f katmanlardan (UI, veritaban\u0131, framework'ler) ba\u011f\u0131ms\u0131z tutmay\u0131 hedefleyen bir tasar\u0131m felsefesidir. FastAPI, bu prensipleri uygulamak i\u00e7in m\u00fckemmel bir zemin sunar.<\/p>\n
Katmanl\u0131 Mimari Yakla\u015f\u0131m\u0131<\/h4>\n
FastAPI uygulamalar\u0131 genellikle katmanl\u0131 bir yap\u0131da tasarlan\u0131r:<\/p>\n
\n- Sunum Katman\u0131 (Presentation Layer):<\/b> FastAPI endpoint'leri, gelen istekleri i\u015fler ve yan\u0131tlar\u0131 d\u00f6nd\u00fcr\u00fcr.<\/li>\n
- Uygulama Katman\u0131 (Application Layer):<\/b> \u0130\u015f ak\u0131\u015flar\u0131n\u0131 ve kullan\u0131m senaryolar\u0131n\u0131 y\u00f6netir. Genellikle servisler (services) bu katmanda yer al\u0131r.<\/li>\n
- \u0130\u015f Mant\u0131\u011f\u0131 Katman\u0131 (Domain Layer):<\/b> Uygulaman\u0131n \u00e7ekirdek i\u015f kurallar\u0131n\u0131 ve varl\u0131klar\u0131n\u0131 (entities) i\u00e7erir. Framework'ten ba\u011f\u0131ms\u0131zd\u0131r.<\/li>\n
- Altyap\u0131 Katman\u0131 (Infrastructure Layer):<\/b> Veritaban\u0131 eri\u015fimi, harici API \u00e7a\u011fr\u0131lar\u0131, dosya sistemi i\u015flemleri gibi teknik detaylar\u0131 i\u00e7erir.<\/li>\n<\/ul>\n
Sorumluluklar\u0131n Ayr\u0131\u015ft\u0131r\u0131lmas\u0131 (Separation of Concerns)<\/h4>\n
Her katman\u0131n ve mod\u00fcl\u00fcn belirli bir sorumlulu\u011fu olmas\u0131, kodun daha okunabilir, test edilebilir ve s\u00fcrd\u00fcr\u00fclebilir olmas\u0131n\u0131 sa\u011flar. FastAPI'nin ba\u011f\u0131ml\u0131l\u0131k enjeksiyonu sistemi, bu ayr\u0131m\u0131 kolayca yapmam\u0131za olanak tan\u0131r. \u00d6rne\u011fin, bir API endpoint'i sadece HTTP isteklerini i\u015flemekten sorumlu olmal\u0131, i\u015f mant\u0131\u011f\u0131 ise ayr\u0131 bir servis katman\u0131nda ele al\u0131nmal\u0131d\u0131r.<\/p>\n
\u0130\u015f Mant\u0131\u011f\u0131 ve Veri Eri\u015fim Katmanlar\u0131<\/h4>\n
FastAPI uygulaman\u0131zda, i\u015f mant\u0131\u011f\u0131n\u0131z\u0131 (business logic) do\u011frudan endpoint fonksiyonlar\u0131n\u0131n i\u00e7ine yazmak yerine, ayr\u0131 servis mod\u00fcllerine ta\u015f\u0131y\u0131n. Veritaban\u0131 i\u015flemleri gibi altyap\u0131 detaylar\u0131n\u0131 ise repository (veri eri\u015fim katman\u0131) mod\u00fcllerinde soyutlay\u0131n. Bu sayede, i\u015f mant\u0131\u011f\u0131n\u0131z veritaban\u0131 teknolojisinden veya framework detaylar\u0131ndan ba\u011f\u0131ms\u0131z kal\u0131r.<\/p>\n
\n# app\/services\/item_service.py\nfrom app.models.item import Item\nfrom app.repositories.item_repository import ItemRepository\n\nclass ItemService:\n def __init__(self, item_repo: ItemRepository):\n self.item_repo = item_repo\n\n def create_item(self, item: Item) -> Item:\n # \u0130\u015f mant\u0131\u011f\u0131 burada yer al\u0131r\n return self.item_repo.save(item)\n\n# app\/repositories\/item_repository.py\nclass ItemRepository:\n def save(self, item: Item) -> Item:\n # Veritaban\u0131 kaydetme mant\u0131\u011f\u0131 burada\n print(f\"Item saved to DB: {item.name}\")\n return item\n<\/pre>\n<\/code><\/p>\n
Domain Driven Design (DDD) ile Entegrasyon<\/h4>\n
DDD prensipleri, karma\u015f\u0131k i\u015f alanlar\u0131nda yaz\u0131l\u0131m geli\u015ftirmeyi kolayla\u015ft\u0131rmak i\u00e7in bir dizi kal\u0131p ve yakla\u015f\u0131m sunar. FastAPI ile DDD uygulamak, Pydantic modellerini domain varl\u0131klar\u0131 olarak kullanmak, servisleri domain servisleri olarak tasarlamak ve repository'leri veri eri\u015fimini soyutlamak i\u00e7in kullanmak anlam\u0131na gelir. Bu, uygulaman\u0131n i\u015f alan\u0131na daha yak\u0131n ve anla\u015f\u0131l\u0131r bir yap\u0131ya sahip olmas\u0131n\u0131 sa\u011flar.<\/p>\n
\u00d6l\u00e7eklenebilirlik i\u00e7in Tasar\u0131m Yakla\u015f\u0131mlar\u0131<\/h3>\n
\u00d6l\u00e7eklenebilirlik, uygulaman\u0131z\u0131n artan y\u00fck\u00fc kald\u0131rabilme yetene\u011fidir. FastAPI, do\u011fas\u0131 gere\u011fi y\u00fcksek performansl\u0131 olsa da, \u00f6l\u00e7eklenebilir bir mimari tasarlamak i\u00e7in ek stratejiler gereklidir.<\/p>\n
Asenkron Programlama ve Concurrency<\/h4>\n
FastAPI'nin asenkron yap\u0131s\u0131, y\u00fcksek e\u015fzamanl\u0131l\u0131k i\u00e7in temel bir avantajd\u0131r. async<\/code> ve await<\/code> anahtar kelimelerini do\u011fru kullanarak I\/O bound i\u015flemleri verimli bir \u015fekilde y\u00f6netmek, uygulaman\u0131z\u0131n binlerce e\u015fzamanl\u0131 iste\u011fi bile sorunsuz bir \u015fekilde i\u015flemesini sa\u011flar. CPU bound i\u015flemler i\u00e7in ise run_in_threadpool<\/code> gibi \u00e7\u00f6z\u00fcmler veya ayr\u0131 worker'lar kullanmak faydal\u0131d\u0131r.<\/p>\nVeritaban\u0131 ve \u00d6nbellekleme Stratejileri<\/h4>\n
Veritaban\u0131, \u00e7o\u011fu uygulaman\u0131n darbo\u011faz\u0131d\u0131r. \u00d6l\u00e7eklenebilirlik i\u00e7in \u015funlar \u00f6nemlidir:<\/p>\n
\n- Veritaban\u0131 Se\u00e7imi:<\/b> Projenin ihtiya\u00e7lar\u0131na uygun (SQL, NoSQL) bir veritaban\u0131 se\u00e7imi.<\/li>\n
- Ba\u011flant\u0131 Havuzlama:<\/b> Veritaban\u0131 ba\u011flant\u0131lar\u0131n\u0131n yeniden kullan\u0131lmas\u0131n\u0131 sa\u011flayarak performans art\u0131\u015f\u0131.<\/li>\n
- \u00d6nbellekleme (Caching):<\/b> S\u0131k eri\u015filen verileri Redis veya Memcached gibi \u00f6nbellek sistemlerinde tutarak veritaban\u0131 y\u00fck\u00fcn\u00fc azaltma.<\/li>\n
- Veritaban\u0131 Replikasyonu\/Sharding:<\/b> Y\u00fcksek okuma y\u00fck\u00fc i\u00e7in replikasyon, \u00e7ok b\u00fcy\u00fck veri k\u00fcmeleri i\u00e7in sharding.<\/li>\n<\/ul>\n
Mikroservis Mimarisine Ge\u00e7i\u015f<\/h4>\n
Monolitik bir FastAPI uygulamas\u0131n\u0131 zamanla mikroservislere ay\u0131rmak, her bir servisin ba\u011f\u0131ms\u0131z olarak geli\u015ftirilmesine, da\u011f\u0131t\u0131lmas\u0131na ve \u00f6l\u00e7eklenmesine olanak tan\u0131r. FastAPI, h\u0131zl\u0131 geli\u015ftirme ve hafif yap\u0131s\u0131yla mikroservisler i\u00e7in ideal bir se\u00e7imdir. Her mikroservis kendi sorumlulu\u011funa odaklan\u0131r ve belirli bir i\u015f alan\u0131n\u0131 y\u00f6netir.<\/p>\n
Mesaj Kuyruklar\u0131 ve Arka Plan G\u00f6revleri<\/h4>\n
Uzun s\u00fcren veya zaman alan i\u015flemleri (e-posta g\u00f6nderme, resim i\u015fleme, rapor olu\u015fturma) do\u011frudan API iste\u011fi i\u00e7inde yapmak yerine, bunlar\u0131 Celery veya RabbitMQ gibi mesaj kuyruklar\u0131 arac\u0131l\u0131\u011f\u0131yla arka plan g\u00f6revlerine devretmek, API yan\u0131t s\u00fcrelerini k\u0131salt\u0131r ve kullan\u0131c\u0131 deneyimini iyile\u015ftirir.<\/p>\n
Kendi Kendini Belgeleme ve Otomatik API Dok\u00fcmantasyonu<\/h3>\n
FastAPI'nin en g\u00fc\u00e7l\u00fc \u00f6zelliklerinden biri, API'nizi otomatik olarak belgeleyebilmesidir. Bu, hem geli\u015ftiriciler hem de API t\u00fcketicileri i\u00e7in b\u00fcy\u00fck bir kolayl\u0131k sa\u011flar.<\/p>\n
OpenAPI (Swagger UI) ve ReDoc Entegrasyonu<\/h4>\n
FastAPI, OpenAPI (eski ad\u0131yla Swagger) standard\u0131n\u0131 destekler ve API'nizi otomatik olarak bu standarda uygun bir \u015fekilde tan\u0131mlar. Bu sayede, uygulaman\u0131z\u0131n \/docs<\/code> (Swagger UI) ve \/redoc<\/code> (ReDoc) URL'lerinde interaktif ve okunabilir API dok\u00fcmantasyonuna an\u0131nda sahip olursunuz. Bu dok\u00fcmantasyon, API endpoint'lerini, beklenen parametreleri, yan\u0131t yap\u0131lar\u0131n\u0131 ve HTTP durum kodlar\u0131n\u0131 detayl\u0131 bir \u015fekilde g\u00f6sterir.<\/p>\nTip \u0130pu\u00e7lar\u0131 ve Docstring'lerin G\u00fcc\u00fc<\/h4>\n
FastAPI, Pydantic modelleri ve Python'\u0131n tip ipu\u00e7lar\u0131n\u0131 kullanarak API \u015feman\u0131z\u0131 otomatik olarak olu\u015fturur. Endpoint fonksiyonlar\u0131n\u0131za ekledi\u011finiz docstring'ler ve Pydantic modellerinizdeki description<\/code> alanlar\u0131, dok\u00fcmantasyonda zengin a\u00e7\u0131klamalar olarak g\u00f6r\u00fcn\u00fcr.<\/p>\n\nfrom fastapi import FastAPI, Path\nfrom pydantic import BaseModel, Field\n\napp = FastAPI()\n\nclass Product(BaseModel):\n name: str = Field(..., example=\"Ak\u0131ll\u0131 Telefon\", description=\"\u00dcr\u00fcn\u00fcn ad\u0131\")\n price: float = Field(..., gt=0, example=999.99, description=\"\u00dcr\u00fcn\u00fcn fiyat\u0131, s\u0131f\u0131rdan b\u00fcy\u00fck olmal\u0131\")\n\n@app.get(\"\/products\/{product_id}\", response_model=Product, summary=\"Belirli bir \u00fcr\u00fcn\u00fc getirir\")\nasync def get_product(\n product_id: int = Path(..., title=\"\u00dcr\u00fcn ID\", description=\"Getirilecek \u00fcr\u00fcn\u00fcn benzersiz kimli\u011fi\", ge=1)\n):\n \"\"\"\n Belirtilen product_id<\/code> ile bir \u00fcr\u00fcn\u00fc veritaban\u0131ndan getirir.\n E\u011fer \u00fcr\u00fcn bulunamazsa 404 hatas\u0131 d\u00f6nd\u00fcr\u00fcr.\n \"\"\"\n # ... \u00fcr\u00fcn getirme mant\u0131\u011f\u0131\n return Product(name=\"\u00d6rnek \u00dcr\u00fcn\", price=123.45)\n<\/pre>\n<\/code><\/p>\n
Belgeleme Otomasyonunun Faydalar\u0131<\/h4>\n
Otomatik dok\u00fcmantasyonun faydalar\u0131 \u015funlard\u0131r:<\/p>\n
\n- G\u00fcncel Kal\u0131r:<\/b> Kod de\u011fi\u015ftik\u00e7e dok\u00fcmantasyon da otomatik olarak g\u00fcncellenir.<\/li>\n
- Geli\u015ftirici Verimlili\u011fi:<\/b> Manuel dok\u00fcmantasyon yazma ve g\u00fcncelleme ihtiyac\u0131n\u0131 ortadan kald\u0131r\u0131r.<\/li>\n
- API Ke\u015ffi:<\/b> API'yi kullanan di\u011fer geli\u015ftiricilerin (\u00f6n u\u00e7, mobil, di\u011fer servisler) API'yi kolayca anlamas\u0131n\u0131 ve kullanmas\u0131n\u0131 sa\u011flar.<\/li>\n
- Test Kolayl\u0131\u011f\u0131:<\/b> Swagger UI \u00fczerinden do\u011frudan API endpoint'lerini test etme imkan\u0131 sunar.<\/li>\n<\/ul>\n
\u00d6zel Belgeleme ve Geni\u015fletmeler<\/h4>\n
FastAPI, otomatik dok\u00fcmantasyonu \u00f6zelle\u015ftirmenize de olanak tan\u0131r. tags<\/code>, summary<\/code>, description<\/code>, response_model<\/code>, status_code<\/code> gibi parametrelerle endpoint'lerinizin dok\u00fcmantasyonunu zenginle\u015ftirebilirsiniz. Ayr\u0131ca, OpenAPI \u015femas\u0131n\u0131 d\u0131\u015fa aktararak veya \u00f6zel bir UI aray\u00fcz\u00fc entegre ederek dok\u00fcmantasyon deneyimini daha da geli\u015ftirebilirsiniz.<\/p>\nBa\u011f\u0131ml\u0131l\u0131k Enjeksiyonu (Dependency Injection) ve Mod\u00fclerlik<\/h3>\n
FastAPI'nin ba\u011f\u0131ml\u0131l\u0131k enjeksiyonu sistemi, uygulaman\u0131z\u0131n mod\u00fclerli\u011fini, test edilebilirli\u011fini ve bak\u0131m kolayl\u0131\u011f\u0131n\u0131 art\u0131ran temel bir \u00f6zelliktir.<\/p>\n
FastAPI'deki Ba\u011f\u0131ml\u0131l\u0131k Sistemi<\/h4>\n
FastAPI, bir endpoint fonksiyonunun veya ba\u015fka bir ba\u011f\u0131ml\u0131l\u0131\u011f\u0131n ihtiya\u00e7 duydu\u011fu bile\u015fenleri otomatik olarak sa\u011flayabilen g\u00fc\u00e7l\u00fc bir ba\u011f\u0131ml\u0131l\u0131k enjeksiyonu mekanizmas\u0131na sahiptir. Bu, veritaban\u0131 oturumlar\u0131, kimlik do\u011frulama bilgileri, servis \u00f6rnekleri gibi kaynaklar\u0131 kolayca y\u00f6netmenizi sa\u011flar.<\/p>\n
\nfrom fastapi import Depends, FastAPI, HTTPException, status\n\napp = FastAPI()\n\ndef get_db_session():\n # Ger\u00e7ek bir uygulamada veritaban\u0131 oturumu olu\u015fturma ve kapatma mant\u0131\u011f\u0131\n print(\"Veritaban\u0131 oturumu a\u00e7\u0131ld\u0131\")\n try:\n yield \"db_session_object\" # Oturum nesnesini d\u00f6nd\u00fcr\n finally:\n print(\"Veritaban\u0131 oturumu kapat\u0131ld\u0131\")\n\n@app.get(\"\/items_with_db\/\")\nasync def read_items_with_db(db: str = Depends(get_db_session)):\n return {\"message\": f\"Veritaban\u0131 oturumu kullan\u0131ld\u0131: {db}\"}\n<\/pre>\n<\/code><\/p>\n
Test Edilebilirli\u011fin Art\u0131r\u0131lmas\u0131<\/h4>\n
Ba\u011f\u0131ml\u0131l\u0131k enjeksiyonu, test edilebilirli\u011fi \u00f6nemli \u00f6l\u00e7\u00fcde art\u0131r\u0131r. Bir bile\u015feni test ederken, ger\u00e7ek ba\u011f\u0131ml\u0131l\u0131klar yerine mock (sahte) ba\u011f\u0131ml\u0131l\u0131klar enjekte edilebilir. Bu sayede, birim testleri daha izole ve h\u0131zl\u0131 \u00e7al\u0131\u015f\u0131r.<\/p>\n
Kod Tekrar\u0131n\u0131n \u00d6nlenmesi ve Bak\u0131m Kolayl\u0131\u011f\u0131<\/h4>\n
Ortak i\u015flevsellikleri (\u00f6rne\u011fin, kimlik do\u011frulama, yetkilendirme, veritaban\u0131 ba\u011flant\u0131s\u0131) ba\u011f\u0131ml\u0131l\u0131k olarak tan\u0131mlamak, kod tekrar\u0131n\u0131 \u00f6nler. Bu i\u015flevselliklerde bir de\u011fi\u015fiklik yap\u0131ld\u0131\u011f\u0131nda, sadece ba\u011f\u0131ml\u0131l\u0131k tan\u0131m\u0131n\u0131 g\u00fcncellemek yeterli olur, bu da bak\u0131m maliyetini d\u00fc\u015f\u00fcr\u00fcr.<\/p>\n
Ortak Kaynaklar\u0131n Y\u00f6netimi<\/h4>\n
Veritaban\u0131 ba\u011flant\u0131lar\u0131, harici API istemcileri, konfig\u00fcrasyon nesneleri gibi uygulama genelinde kullan\u0131lan kaynaklar, ba\u011f\u0131ml\u0131l\u0131k enjeksiyonu ile kolayca y\u00f6netilebilir. Bu kaynaklar\u0131n ya\u015fam d\u00f6ng\u00fcs\u00fc (olu\u015fturma, kapatma) ba\u011f\u0131ml\u0131l\u0131k fonksiyonlar\u0131 i\u00e7inde tan\u0131mlanabilir.<\/p>\n
Proje Yap\u0131land\u0131rmas\u0131 ve En \u0130yi Uygulamalar<\/h3>\n
Sa\u011flam ve \u00f6l\u00e7eklenebilir bir FastAPI uygulamas\u0131 in\u015fa etmek i\u00e7in iyi bir proje yap\u0131s\u0131 ve en iyi uygulamalar\u0131 takip etmek kritik \u00f6neme sahiptir.<\/p>\n
Dizin Yap\u0131s\u0131 \u00d6nerileri<\/h4>\n
Mod\u00fcler ve temiz bir yap\u0131 i\u00e7in a\u015fa\u011f\u0131daki gibi bir dizin yap\u0131s\u0131 \u00f6nerilir:<\/p>\n
\nmy_fastapi_app\/\n\u251c\u2500\u2500 app\/\n\u2502 \u251c\u2500\u2500 __init__.py\n\u2502 \u251c\u2500\u2500 main.py # Ana FastAPI uygulamas\u0131\n\u2502 \u251c\u2500\u2500 api\/ # Endpoint'ler ve router'lar\n\u2502 \u2502 \u251c\u2500\u2500 __init__.py\n\u2502 \u2502 \u251c\u2500\u2500 v1\/\n\u2502 \u2502 \u2502 \u251c\u2500\u2500 __init__.py\n\u2502 \u2502 \u2502 \u251c\u2500\u2500 endpoints\/\n\u2502 \u2502 \u2502 \u2502 \u251c\u2500\u2500 __init__.py\n\u2502 \u2502 \u2502 \u2502 \u251c\u2500\u2500 users.py\n\u2502 \u2502 \u2502 \u2502 \u2514\u2500\u2500 items.py\n\u2502 \u2502 \u2502 \u2514\u2500\u2500 routers.py # API router'lar\u0131n\u0131 birle\u015ftiren dosya\n\u2502 \u251c\u2500\u2500 core\/ # Temel konfig\u00fcrasyon, ayarlar, ba\u011f\u0131ml\u0131l\u0131klar\n\u2502 \u2502 \u251c\u2500\u2500 __init__.py\n\u2502 \u2502 \u251c\u2500\u2500 config.py\n\u2502 \u2502 \u2514\u2500\u2500 dependencies.py\n\u2502 \u251c\u2500\u2500 db\/ # Veritaban\u0131 ile ilgili mod\u00fcller\n\u2502 \u2502 \u251c\u2500\u2500 __init__.py\n\u2502 \u2502 \u251c\u2500\u2500 base.py # Base modeller\n\u2502 \u2502 \u2514\u2500\u2500 session.py # Oturum y\u00f6netimi\n\u2502 \u251c\u2500\u2500 models\/ # Pydantic modelleri\n\u2502 \u2502 \u251c\u2500\u2500 __init__.py\n\u2502 \u2502 \u251c\u2500\u2500 user.py\n\u2502 \u2502 \u2514\u2500\u2500 item.py\n\u2502 \u251c\u2500\u2500 schemas\/ # Girdi\/\u00e7\u0131kt\u0131 Pydantic modelleri (opsiyonel, models ile birle\u015febilir)\n\u2502 \u251c\u2500\u2500 services\/ # \u0130\u015f mant\u0131\u011f\u0131 servisleri\n\u2502 \u2502 \u251c\u2500\u2500 __init__.py\n\u2502 \u2502 \u251c\u2500\u2500 user_service.py\n\u2502 \u2502 \u2514\u2500\u2500 item_service.py\n\u2502 \u2514\u2500\u2500 repositories\/ # Veri eri\u015fim katman\u0131\n\u2502 \u251c\u2500\u2500 __init__.py\n\u2502 \u251c\u2500\u2500 user_repository.py\n\u2502 \u2514\u2500\u2500 item_repository.py\n\u251c\u2500\u2500 tests\/\n\u2502 \u251c\u2500\u2500 __init__.py\n\u2502 \u251c\u2500\u2500 test_api.py\n\u2502 \u2514\u2500\u2500 test_services.py\n\u251c\u2500\u2500 .env # Ortam de\u011fi\u015fkenleri\n\u251c\u2500\u2500 requirements.txt # Ba\u011f\u0131ml\u0131l\u0131klar\n\u251c\u2500\u2500 Dockerfile # Docker yap\u0131land\u0131rmas\u0131\n\u2514\u2500\u2500 README.md\n<\/pre>\n<\/code><\/p>\n
Ortam De\u011fi\u015fkenleri ve Konfig\u00fcrasyon Y\u00f6netimi<\/h4>\n
Hassas bilgileri (veritaban\u0131 \u015fifreleri, API anahtarlar\u0131) do\u011frudan koda yazmak yerine ortam de\u011fi\u015fkenleri (.env<\/code> dosyas\u0131) kullanarak y\u00f6netmek g\u00fcvenlik a\u00e7\u0131s\u0131ndan kritik \u00f6neme sahiptir. Pydantic'in BaseSettings<\/code> s\u0131n\u0131f\u0131, ortam de\u011fi\u015fkenlerini kolayca okuyup do\u011frulamak i\u00e7in harika bir ara\u00e7t\u0131r.<\/p>\n\nfrom pydantic_settings import BaseSettings, SettingsConfigDict\n\nclass Settings(BaseSettings):\n app_name: str = \"My Awesome FastAPI App\"\n database_url: str\n secret_key: str\n\n model_config = SettingsConfigDict(env_file=\".env\")\n\nsettings = Settings()\nprint(settings.app_name)\nprint(settings.database_url) # .env dosyas\u0131ndan okunur\n<\/pre>\n<\/code><\/p>\n
Test Stratejileri (Unit, Integration, End-to-End)<\/h4>\n
Uygulaman\u0131z\u0131n kalitesini ve s\u00fcrd\u00fcr\u00fclebilirli\u011fini sa\u011flamak i\u00e7in kapsaml\u0131 testler yazmak \u00f6nemlidir:<\/p>\n
\n- Birim Testleri (Unit Tests):<\/b> Her bir fonksiyonu veya s\u0131n\u0131f\u0131 izole bir \u015fekilde test eder.<\/li>\n
- Entegrasyon Testleri (Integration Tests):<\/b> Farkl\u0131 bile\u015fenlerin (\u00f6rne\u011fin, servis ve repository) birlikte do\u011fru \u00e7al\u0131\u015f\u0131p \u00e7al\u0131\u015fmad\u0131\u011f\u0131n\u0131 kontrol eder.<\/li>\n
- U\u00e7tan Uca Testler (End-to-End Tests):<\/b> API'nin tamam\u0131n\u0131 ger\u00e7ek bir kullan\u0131c\u0131 ak\u0131\u015f\u0131 gibi test eder.
httpx<\/code> k\u00fct\u00fcphanesi, FastAPI uygulamalar\u0131 i\u00e7in harika bir test arac\u0131d\u0131r.<\/li>\n<\/ul>\nG\u00fcvenlik Best Practices<\/h4>\n
API g\u00fcvenli\u011fi, uygulaman\u0131n ba\u015far\u0131s\u0131 i\u00e7in hayati \u00f6neme sahiptir:<\/p>\n
\n- Kimlik Do\u011frulama (Authentication):<\/b> JWT, OAuth2 gibi standartlar\u0131 kullanarak kullan\u0131c\u0131 kimli\u011fini do\u011frula. FastAPI'nin g\u00fcvenlik ba\u011f\u0131ml\u0131l\u0131klar\u0131 bu konuda yard\u0131mc\u0131 olur.<\/li>\n
- Yetkilendirme (Authorization):<\/b> Kullan\u0131c\u0131n\u0131n belirli bir kayna\u011fa eri\u015fim izni olup olmad\u0131\u011f\u0131n\u0131 kontrol et.<\/li>\n
- Giri\u015f Do\u011frulama (Input Validation):<\/b> Pydantic ile gelen t\u00fcm verileri s\u0131k\u0131 bir \u015fekilde do\u011frula.<\/li>\n
- Hata Y\u00f6netimi:<\/b> Hassas bilgileri hata mesajlar\u0131nda a\u00e7\u0131\u011fa \u00e7\u0131karma.<\/li>\n
- Rate Limiting:<\/b> DDoS sald\u0131r\u0131lar\u0131n\u0131 \u00f6nlemek ve k\u00f6t\u00fcye kullan\u0131m\u0131 engellemek i\u00e7in istek oranlar\u0131n\u0131 s\u0131n\u0131rlama.<\/li>\n
- CORS:<\/b> Cross-Origin Resource Sharing politikalar\u0131n\u0131 do\u011fru yap\u0131land\u0131rma.<\/li>\n<\/ul>\n
Sonu\u00e7<\/h3>\n
FastAPI, modern web geli\u015ftirmenin zorluklar\u0131na temiz, \u00f6l\u00e7eklenebilir ve kendi kendini belgeleyen bir mimariyle yan\u0131t veren g\u00fc\u00e7l\u00fc bir framework't\u00fcr. Asenkron yap\u0131s\u0131, Pydantic ile entegrasyonu, g\u00fc\u00e7l\u00fc ba\u011f\u0131ml\u0131l\u0131k enjeksiyonu ve otomatik OpenAPI dok\u00fcmantasyonu sayesinde geli\u015ftiricilere e\u015fsiz bir deneyim sunar. Bu makalede ele al\u0131nan prensipleri ve en iyi uygulamalar\u0131 takip ederek, hem bug\u00fcn\u00fcn hem de yar\u0131n\u0131n ihtiya\u00e7lar\u0131n\u0131 kar\u015f\u0131layacak sa\u011flam, performansl\u0131 ve bak\u0131m\u0131 kolay API'ler in\u015fa edebilirsiniz. FastAPI, Python ekosisteminde API geli\u015ftirmek i\u00e7in kesinlikle g\u00f6z \u00f6n\u00fcnde bulundurulmas\u0131 gereken bir teknolojidir.<\/p>\n
SSS (S\u0131k Sorulan Sorular)<\/h3>\nFastAPI neden bu kadar pop\u00fcler?<\/h4>\n
FastAPI, y\u00fcksek performansl\u0131 asenkron yap\u0131s\u0131, Pydantic ile otomatik veri do\u011frulama, kendi kendini belgeleyen API'ler (Swagger UI\/ReDoc), g\u00fc\u00e7l\u00fc ba\u011f\u0131ml\u0131l\u0131k enjeksiyonu ve geli\u015ftirici dostu olmas\u0131 nedeniyle pop\u00fclerlik kazanm\u0131\u015ft\u0131r. Python tip ipu\u00e7lar\u0131n\u0131 etkin bir \u015fekilde kullanmas\u0131, kod kalitesini ve geli\u015ftirme h\u0131z\u0131n\u0131 art\u0131r\u0131r.<\/p>\n
Temiz mimari FastAPI ile nas\u0131l uygulan\u0131r?<\/h4>\n
FastAPI'de temiz mimari, uygulaman\u0131z\u0131 katmanlara ay\u0131rarak (sunum, uygulama, i\u015f mant\u0131\u011f\u0131, altyap\u0131) sorumluluklar\u0131 ayr\u0131\u015ft\u0131rmakla ba\u015flar. \u0130\u015f mant\u0131\u011f\u0131n\u0131z\u0131 do\u011frudan endpoint'lere yazmak yerine servis katmanlar\u0131na ta\u015f\u0131mal\u0131, veritaban\u0131 eri\u015fimini ise repository katmanlar\u0131nda soyutlamal\u0131s\u0131n\u0131z. Ba\u011f\u0131ml\u0131l\u0131k enjeksiyonu, bu katmanlar aras\u0131 ba\u011flant\u0131y\u0131 y\u00f6netmek i\u00e7in idealdir.<\/p>\n
\u00d6l\u00e7eklenebilirlik i\u00e7in FastAPI'de nelere dikkat etmeliyim?<\/h4>\n
\u00d6l\u00e7eklenebilirlik i\u00e7in asenkron programlamay\u0131 etkin kullanmal\u0131, veritaban\u0131 ba\u011flant\u0131 havuzlama ve \u00f6nbellekleme stratejileri uygulamal\u0131s\u0131n\u0131z. Uzun s\u00fcren i\u015flemleri mesaj kuyruklar\u0131 ve arka plan g\u00f6revleriyle y\u00f6netmek, mikroservis mimarisine ge\u00e7i\u015fi d\u00fc\u015f\u00fcnmek ve yatay \u00f6l\u00e7eklendirme i\u00e7in uygulaman\u0131z\u0131 durumsuz (stateless) tasarlamak \u00f6nemlidir.<\/p>\n
FastAPI'nin otomatik dok\u00fcmantasyonu ne i\u015fe yarar?<\/h4>\n
FastAPI'nin otomatik dok\u00fcmantasyonu (Swagger UI ve ReDoc), API'nizin t\u00fcm endpoint'lerini, beklenen parametreleri, yan\u0131t modellerini ve HTTP durum kodlar\u0131n\u0131 interaktif ve g\u00fcncel bir \u015fekilde sunar. Bu, API'yi kullanan di\u011fer geli\u015ftiricilerin (\u00f6n u\u00e7, mobil vb.) API'yi kolayca anlamas\u0131n\u0131 ve entegre etmesini sa\u011flar, manuel dok\u00fcmantasyon y\u00fck\u00fcn\u00fc ortadan kald\u0131r\u0131r.<\/p>\n
Ba\u011f\u0131ml\u0131l\u0131k enjeksiyonu ne zaman kullan\u0131lmal\u0131?<\/h4>\n
Ba\u011f\u0131ml\u0131l\u0131k enjeksiyonu, bir bile\u015fenin (\u00f6rne\u011fin bir endpoint veya servis) ihtiya\u00e7 duydu\u011fu di\u011fer bile\u015fenleri (veritaban\u0131 oturumu, harici servis istemcisi, konfig\u00fcrasyon) do\u011frudan kendisinin olu\u015fturmas\u0131 yerine d\u0131\u015far\u0131dan almas\u0131n\u0131 sa\u011flad\u0131\u011f\u0131nda kullan\u0131lmal\u0131d\u0131r. Bu, kodun daha mod\u00fcler, test edilebilir ve yeniden kullan\u0131labilir olmas\u0131n\u0131 sa\u011flar. \u00d6zellikle veritaban\u0131 ba\u011flant\u0131lar\u0131, kimlik do\u011frulama, yetkilendirme ve i\u015f mant\u0131\u011f\u0131 servislerini enjekte etmek i\u00e7in yayg\u0131n olarak kullan\u0131l\u0131r.<\/p>\n","protected":false},"excerpt":{"rendered":"FastAPI Mimarisi: Temiz, \u00d6l\u00e7eklenebilir ve Kendi Kendini Belgeleyen Yap\u0131lar\nModern web uygulamalar\u0131 geli\u015ftirirken h\u0131z, performans ve s\u00fcrd\u00fcr\u00fclebilir…","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"csco_page_header_type":"","csco_page_load_nextpost":"","csco_page_subscribe_form":"","csco_page_contact_form":"","footnotes":""},"categories":[1],"tags":[],"class_list":{"0":"post-38151","1":"post","2":"type-post","3":"status-publish","4":"format-standard","6":"category-genel","7":"cs-entry","8":"cs-video-wrap"},"yoast_head":"\n
FastAPI Mimarisi: Temiz, \u00d6l\u00e7eklenebilir ve Kendi Kendini Belgeleyen Yap\u0131lar - Kodlar\u0131n Gizemli D\u00fcnyas\u0131<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/fatihsoysal.com\/blog\/fastapi-mimarisi-temiz-olceklenebilir-ve-kendi-kendini-belgeleyen-yapilar\/\" \/>\n<meta property=\"og:locale\" content=\"tr_TR\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"FastAPI Mimarisi: Temiz, \u00d6l\u00e7eklenebilir ve Kendi Kendini Belgeleyen Yap\u0131lar\" \/>\n<meta property=\"og:description\" content=\"FastAPI Mimarisi: Temiz, \u00d6l\u00e7eklenebilir ve Kendi Kendini Belgeleyen Yap\u0131lar Modern web uygulamalar\u0131 geli\u015ftirirken h\u0131z, performans ve s\u00fcrd\u00fcr\u00fclebilir...\" \/>\n<meta property=\"og:url\" content=\"https:\/\/fatihsoysal.com\/blog\/fastapi-mimarisi-temiz-olceklenebilir-ve-kendi-kendini-belgeleyen-yapilar\/\" \/>\n<meta property=\"og:site_name\" content=\"Kodlar\u0131n Gizemli D\u00fcnyas\u0131\" \/>\n<meta property=\"article:published_time\" content=\"2026-01-24T11:00:46+00:00\" \/>\n<meta name=\"author\" content=\"Fatih Soysal\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Yazan:\" \/>\n\t<meta name=\"twitter:data1\" content=\"Fatih Soysal\" \/>\n\t<meta name=\"twitter:label2\" content=\"Tahmini okuma s\u00fcresi\" \/>\n\t<meta name=\"twitter:data2\" content=\"15 dakika\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"Article\",\"@id\":\"https:\/\/fatihsoysal.com\/blog\/fastapi-mimarisi-temiz-olceklenebilir-ve-kendi-kendini-belgeleyen-yapilar\/#article\",\"isPartOf\":{\"@id\":\"https:\/\/fatihsoysal.com\/blog\/fastapi-mimarisi-temiz-olceklenebilir-ve-kendi-kendini-belgeleyen-yapilar\/\"},\"author\":{\"name\":\"Fatih Soysal\",\"@id\":\"https:\/\/fatihsoysal.com\/blog\/#\/schema\/person\/002a254750921dcfd568a99e48240dd1\"},\"headline\":\"FastAPI Mimarisi: Temiz, \u00d6l\u00e7eklenebilir ve Kendi Kendini Belgeleyen Yap\u0131lar\",\"datePublished\":\"2026-01-24T11:00:46+00:00\",\"mainEntityOfPage\":{\"@id\":\"https:\/\/fatihsoysal.com\/blog\/fastapi-mimarisi-temiz-olceklenebilir-ve-kendi-kendini-belgeleyen-yapilar\/\"},\"wordCount\":2479,\"commentCount\":0,\"publisher\":{\"@id\":\"https:\/\/fatihsoysal.com\/blog\/#\/schema\/person\/002a254750921dcfd568a99e48240dd1\"},\"inLanguage\":\"tr\",\"potentialAction\":[{\"@type\":\"CommentAction\",\"name\":\"Comment\",\"target\":[\"https:\/\/fatihsoysal.com\/blog\/fastapi-mimarisi-temiz-olceklenebilir-ve-kendi-kendini-belgeleyen-yapilar\/#respond\"]}],\"copyrightYear\":\"2026\",\"copyrightHolder\":{\"@id\":\"https:\/\/fatihsoysal.com\/blog\/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https:\/\/fatihsoysal.com\/blog\/fastapi-mimarisi-temiz-olceklenebilir-ve-kendi-kendini-belgeleyen-yapilar\/\",\"url\":\"https:\/\/fatihsoysal.com\/blog\/fastapi-mimarisi-temiz-olceklenebilir-ve-kendi-kendini-belgeleyen-yapilar\/\",\"name\":\"FastAPI Mimarisi: Temiz, \u00d6l\u00e7eklenebilir ve Kendi Kendini Belgeleyen Yap\u0131lar - Kodlar\u0131n Gizemli D\u00fcnyas\u0131\",\"isPartOf\":{\"@id\":\"https:\/\/fatihsoysal.com\/blog\/#website\"},\"datePublished\":\"2026-01-24T11:00:46+00:00\",\"breadcrumb\":{\"@id\":\"https:\/\/fatihsoysal.com\/blog\/fastapi-mimarisi-temiz-olceklenebilir-ve-kendi-kendini-belgeleyen-yapilar\/#breadcrumb\"},\"inLanguage\":\"tr\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/fatihsoysal.com\/blog\/fastapi-mimarisi-temiz-olceklenebilir-ve-kendi-kendini-belgeleyen-yapilar\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/fatihsoysal.com\/blog\/fastapi-mimarisi-temiz-olceklenebilir-ve-kendi-kendini-belgeleyen-yapilar\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Anasayfa\",\"item\":\"https:\/\/fatihsoysal.com\/blog\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"FastAPI Mimarisi: Temiz, \u00d6l\u00e7eklenebilir ve Kendi Kendini Belgeleyen Yap\u0131lar\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/fatihsoysal.com\/blog\/#website\",\"url\":\"https:\/\/fatihsoysal.com\/blog\/\",\"name\":\"Fatihsoysal.com\",\"description\":\"Blog - Yaz\u0131l\u0131m D\u00fcnyas\u0131 Tecr\u00fcbelerim\",\"publisher\":{\"@id\":\"https:\/\/fatihsoysal.com\/blog\/#\/schema\/person\/002a254750921dcfd568a99e48240dd1\"},\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/fatihsoysal.com\/blog\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"tr\"},{\"@type\":[\"Person\",\"Organization\"],\"@id\":\"https:\/\/fatihsoysal.com\/blog\/#\/schema\/person\/002a254750921dcfd568a99e48240dd1\",\"name\":\"Fatih Soysal\",\"image\":{\"@type\":\"ImageObject\",\"inLanguage\":\"tr\",\"@id\":\"https:\/\/fatihsoysal.com\/blog\/#\/schema\/person\/image\/\",\"url\":\"https:\/\/fatihsoysal.com\/blog\/wp-content\/uploads\/2024\/04\/cropped-replicate-prediction-3kgg1hgjn5rgp0cf0p5tr0jw7w-1.png\",\"contentUrl\":\"https:\/\/fatihsoysal.com\/blog\/wp-content\/uploads\/2024\/04\/cropped-replicate-prediction-3kgg1hgjn5rgp0cf0p5tr0jw7w-1.png\",\"width\":512,\"height\":512,\"caption\":\"Fatih Soysal\"},\"logo\":{\"@id\":\"https:\/\/fatihsoysal.com\/blog\/#\/schema\/person\/image\/\"},\"description\":\"Kullan\u0131m ve kodlama m\u00fckemmeliyetini odak alan uygulamalar olu\u015fturma deneyimine sahip, profesyonel olarak 15+ y\u0131l \u00fczeri deneyime sahip bir yaz\u0131l\u0131m m\u00fchendisi.\",\"url\":\"https:\/\/fatihsoysal.com\/blog\/author\/fatihsoysal\/\"}]}<\/script>\n<!-- \/ Yoast SEO Premium plugin. -->","yoast_head_json":{"title":"FastAPI Mimarisi: Temiz, \u00d6l\u00e7eklenebilir ve Kendi Kendini Belgeleyen Yap\u0131lar - Kodlar\u0131n Gizemli D\u00fcnyas\u0131","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/fatihsoysal.com\/blog\/fastapi-mimarisi-temiz-olceklenebilir-ve-kendi-kendini-belgeleyen-yapilar\/","og_locale":"tr_TR","og_type":"article","og_title":"FastAPI Mimarisi: Temiz, \u00d6l\u00e7eklenebilir ve Kendi Kendini Belgeleyen Yap\u0131lar","og_description":"FastAPI Mimarisi: Temiz, \u00d6l\u00e7eklenebilir ve Kendi Kendini Belgeleyen Yap\u0131lar Modern web uygulamalar\u0131 geli\u015ftirirken h\u0131z, performans ve s\u00fcrd\u00fcr\u00fclebilir...","og_url":"https:\/\/fatihsoysal.com\/blog\/fastapi-mimarisi-temiz-olceklenebilir-ve-kendi-kendini-belgeleyen-yapilar\/","og_site_name":"Kodlar\u0131n Gizemli D\u00fcnyas\u0131","article_published_time":"2026-01-24T11:00:46+00:00","author":"Fatih Soysal","twitter_card":"summary_large_image","twitter_misc":{"Yazan:":"Fatih Soysal","Tahmini okuma s\u00fcresi":"15 dakika"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"Article","@id":"https:\/\/fatihsoysal.com\/blog\/fastapi-mimarisi-temiz-olceklenebilir-ve-kendi-kendini-belgeleyen-yapilar\/#article","isPartOf":{"@id":"https:\/\/fatihsoysal.com\/blog\/fastapi-mimarisi-temiz-olceklenebilir-ve-kendi-kendini-belgeleyen-yapilar\/"},"author":{"name":"Fatih Soysal","@id":"https:\/\/fatihsoysal.com\/blog\/#\/schema\/person\/002a254750921dcfd568a99e48240dd1"},"headline":"FastAPI Mimarisi: Temiz, \u00d6l\u00e7eklenebilir ve Kendi Kendini Belgeleyen Yap\u0131lar","datePublished":"2026-01-24T11:00:46+00:00","mainEntityOfPage":{"@id":"https:\/\/fatihsoysal.com\/blog\/fastapi-mimarisi-temiz-olceklenebilir-ve-kendi-kendini-belgeleyen-yapilar\/"},"wordCount":2479,"commentCount":0,"publisher":{"@id":"https:\/\/fatihsoysal.com\/blog\/#\/schema\/person\/002a254750921dcfd568a99e48240dd1"},"inLanguage":"tr","potentialAction":[{"@type":"CommentAction","name":"Comment","target":["https:\/\/fatihsoysal.com\/blog\/fastapi-mimarisi-temiz-olceklenebilir-ve-kendi-kendini-belgeleyen-yapilar\/#respond"]}],"copyrightYear":"2026","copyrightHolder":{"@id":"https:\/\/fatihsoysal.com\/blog\/#organization"}},{"@type":"WebPage","@id":"https:\/\/fatihsoysal.com\/blog\/fastapi-mimarisi-temiz-olceklenebilir-ve-kendi-kendini-belgeleyen-yapilar\/","url":"https:\/\/fatihsoysal.com\/blog\/fastapi-mimarisi-temiz-olceklenebilir-ve-kendi-kendini-belgeleyen-yapilar\/","name":"FastAPI Mimarisi: Temiz, \u00d6l\u00e7eklenebilir ve Kendi Kendini Belgeleyen Yap\u0131lar - Kodlar\u0131n Gizemli D\u00fcnyas\u0131","isPartOf":{"@id":"https:\/\/fatihsoysal.com\/blog\/#website"},"datePublished":"2026-01-24T11:00:46+00:00","breadcrumb":{"@id":"https:\/\/fatihsoysal.com\/blog\/fastapi-mimarisi-temiz-olceklenebilir-ve-kendi-kendini-belgeleyen-yapilar\/#breadcrumb"},"inLanguage":"tr","potentialAction":[{"@type":"ReadAction","target":["https:\/\/fatihsoysal.com\/blog\/fastapi-mimarisi-temiz-olceklenebilir-ve-kendi-kendini-belgeleyen-yapilar\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/fatihsoysal.com\/blog\/fastapi-mimarisi-temiz-olceklenebilir-ve-kendi-kendini-belgeleyen-yapilar\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Anasayfa","item":"https:\/\/fatihsoysal.com\/blog\/"},{"@type":"ListItem","position":2,"name":"FastAPI Mimarisi: Temiz, \u00d6l\u00e7eklenebilir ve Kendi Kendini Belgeleyen Yap\u0131lar"}]},{"@type":"WebSite","@id":"https:\/\/fatihsoysal.com\/blog\/#website","url":"https:\/\/fatihsoysal.com\/blog\/","name":"Fatihsoysal.com","description":"Blog - Yaz\u0131l\u0131m D\u00fcnyas\u0131 Tecr\u00fcbelerim","publisher":{"@id":"https:\/\/fatihsoysal.com\/blog\/#\/schema\/person\/002a254750921dcfd568a99e48240dd1"},"potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/fatihsoysal.com\/blog\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"tr"},{"@type":["Person","Organization"],"@id":"https:\/\/fatihsoysal.com\/blog\/#\/schema\/person\/002a254750921dcfd568a99e48240dd1","name":"Fatih Soysal","image":{"@type":"ImageObject","inLanguage":"tr","@id":"https:\/\/fatihsoysal.com\/blog\/#\/schema\/person\/image\/","url":"https:\/\/fatihsoysal.com\/blog\/wp-content\/uploads\/2024\/04\/cropped-replicate-prediction-3kgg1hgjn5rgp0cf0p5tr0jw7w-1.png","contentUrl":"https:\/\/fatihsoysal.com\/blog\/wp-content\/uploads\/2024\/04\/cropped-replicate-prediction-3kgg1hgjn5rgp0cf0p5tr0jw7w-1.png","width":512,"height":512,"caption":"Fatih Soysal"},"logo":{"@id":"https:\/\/fatihsoysal.com\/blog\/#\/schema\/person\/image\/"},"description":"Kullan\u0131m ve kodlama m\u00fckemmeliyetini odak alan uygulamalar olu\u015fturma deneyimine sahip, profesyonel olarak 15+ y\u0131l \u00fczeri deneyime sahip bir yaz\u0131l\u0131m m\u00fchendisi.","url":"https:\/\/fatihsoysal.com\/blog\/author\/fatihsoysal\/"}]}},"yoast_meta":{"yoast_wpseo_title":"","yoast_wpseo_metadesc":"","yoast_wpseo_canonical":""},"amp_enabled":true,"_links":{"self":[{"href":"https:\/\/fatihsoysal.com\/blog\/wp-json\/wp\/v2\/posts\/38151","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/fatihsoysal.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/fatihsoysal.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/fatihsoysal.com\/blog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/fatihsoysal.com\/blog\/wp-json\/wp\/v2\/comments?post=38151"}],"version-history":[{"count":0,"href":"https:\/\/fatihsoysal.com\/blog\/wp-json\/wp\/v2\/posts\/38151\/revisions"}],"wp:attachment":[{"href":"https:\/\/fatihsoysal.com\/blog\/wp-json\/wp\/v2\/media?parent=38151"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/fatihsoysal.com\/blog\/wp-json\/wp\/v2\/categories?post=38151"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/fatihsoysal.com\/blog\/wp-json\/wp\/v2\/tags?post=38151"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}