Modern web geli\u015ftirme d\u00fcnyas\u0131nda, API’ler yaz\u0131l\u0131m uygulamalar\u0131n\u0131n bel kemi\u011fini olu\u015fturur. Ancak, bir API’yi s\u0131f\u0131rdan olu\u015fturmak, zaman al\u0131c\u0131 ve tekrarlay\u0131c\u0131 g\u00f6revlerle dolu bir s\u00fcre\u00e7 olabilir. FastAPI \u015fablonlar\u0131, bu s\u00fcreci h\u0131zland\u0131rarak, geli\u015ftiricilerin yenilik\u00e7i fikirlerine odaklanmas\u0131n\u0131 sa\u011flar. Peki, h\u0131zl\u0131 ve \u00f6l\u00e7eklenebilir bir FastAPI projesi ba\u015flatmak i\u00e7in neden bir \u015fablona ihtiya\u00e7 duyar\u0131z ve bu \u015fablonlar bize hangi avantajlar\u0131 sunar?<\/p>\n
G\u00fcn\u00fcm\u00fcz\u00fcn dijital d\u00fcnyas\u0131nda, uygulamalar\u0131n birbirleriyle verimli bir \u015fekilde ileti\u015fim kurmas\u0131 hayati \u00f6nem ta\u015f\u0131r. \u0130\u015fte tam da bu noktada API’ler (Uygulama Programlama Aray\u00fczleri) devreye girer. Python ekosisteminde API geli\u015ftirmek i\u00e7in bir\u00e7ok se\u00e7enek bulunurken, son y\u0131llarda FastAPI, y\u00fcksek performans\u0131, kullan\u0131m kolayl\u0131\u011f\u0131 ve modern \u00f6zellikleriyle \u00f6ne \u00e7\u0131kmay\u0131 ba\u015farm\u0131\u015ft\u0131r. Peki, FastAPI’yi bu kadar \u00f6zel k\u0131lan nedir ve neden bu kadar k\u0131sa s\u00fcrede geli\u015ftiricilerin favorisi haline geldi?<\/p>\n
FastAPI, Python 3.7+ tabanl\u0131, modern, h\u0131zl\u0131 (y\u00fcksek performansl\u0131) bir web \u00e7at\u0131s\u0131d\u0131r. Anahtar \u00f6zelliklerinden biri, Starlette ve Pydantic k\u00fct\u00fcphanelerini temel almas\u0131d\u0131r. Starlette, y\u00fcksek performansl\u0131 asenkron web uygulamalar\u0131 i\u00e7in bir ara\u00e7 tak\u0131m\u0131 sunarken, Pydantic ise veri tan\u0131mlama ve do\u011frulama konusunda benzersiz yetenekler sa\u011flar. Bu iki g\u00fc\u00e7l\u00fc k\u00fct\u00fcphanenin birle\u015fimi sayesinde FastAPI, hem geli\u015ftirici deneyimini hem de uygulaman\u0131n \u00e7al\u0131\u015fma zaman\u0131 performans\u0131n\u0131 \u00f6nemli \u00f6l\u00e7\u00fcde art\u0131r\u0131r.<\/p>\n
FastAPI’nin en dikkat \u00e7ekici \u00f6zelliklerinden biri, asenkron programlama<\/strong> (async\/await) deste\u011fidir. Bu sayede, ayn\u0131 anda birden fazla iste\u011fi i\u015fleyebilir, G\/\u00c7 (giri\u015f\/\u00e7\u0131k\u0131\u015f) yo\u011fun i\u015flemlerde (veritaban\u0131 sorgular\u0131, harici API \u00e7a\u011fr\u0131lar\u0131) uygulaman\u0131n yan\u0131t verme s\u00fcresini \u00f6nemli \u00f6l\u00e7\u00fcde k\u0131saltabilir. Bu, mikroservis mimarileri ve y\u00fcksek trafikli uygulamalar i\u00e7in kritik bir avantajd\u0131r. Ayr\u0131ca, Pydantic entegrasyonu sayesinde, request body (istek g\u00f6vdesi) ve query parametreleri (sorgu parametreleri) i\u00e7in otomatik veri do\u011frulama ve serile\u015ftirme elde edersiniz. Bu, hem kod yaz\u0131m\u0131n\u0131 basitle\u015ftirir hem de hatalar\u0131 azalt\u0131r.<\/p>\n Bir di\u011fer \u00f6nemli \u00f6zelli\u011fi ise otomatik API dok\u00fcmantasyonudur. FastAPI, OpenAPI (\u00f6nceki ad\u0131yla Swagger) standard\u0131n\u0131 kullanarak, yazd\u0131\u011f\u0131n\u0131z kodu analiz eder ve otomatik olarak etkile\u015fimli API dok\u00fcmantasyon aray\u00fczleri (Swagger UI ve ReDoc) olu\u015fturur. Bu, API’lerinizi di\u011fer geli\u015ftiricilerin veya ekip \u00fcyelerinin anlamas\u0131 ve kullanmas\u0131 i\u00e7in m\u00fcthi\u015f bir kolayl\u0131k sa\u011flar. Art\u0131k manuel dok\u00fcmantasyon olu\u015fturmak i\u00e7in saatler harcaman\u0131za gerek kalmaz; kodunuz g\u00fcncellendi\u011finde dok\u00fcmantasyonunuz da otomatik olarak g\u00fcncellenir. Bu \u00f6zellik, \u00f6zellikle b\u00fcy\u00fck ve karma\u015f\u0131k projelerde zaman ve emek tasarrufu a\u00e7\u0131s\u0131ndan paha bi\u00e7ilmezdir.<\/p>\n FastAPI, g\u00fcvenlik, ba\u011f\u0131ml\u0131l\u0131k enjeksiyonu ve test edilebilirlik gibi modern API geli\u015ftirme ihtiya\u00e7lar\u0131n\u0131 da ba\u015far\u0131yla kar\u015f\u0131lar. Ba\u011f\u0131ml\u0131l\u0131k enjeksiyonu sistemi, kodunuzu daha mod\u00fcler, test edilebilir ve yeniden kullan\u0131labilir hale getirir. Bu kadar \u00e7ok avantaja sahip bir \u00e7er\u00e7eve varken, projeleri h\u0131zl\u0131 ve standartlara uygun bir \u015fekilde ba\u015flatmak i\u00e7in neden bir \u015fablona ihtiyac\u0131m\u0131z oldu\u011funu d\u00fc\u015f\u00fcnebilirsiniz. Cevap basit: FastAPI, harika bir temel sunar, ancak her projenin kendine \u00f6zg\u00fc yap\u0131land\u0131rmalar\u0131, ara\u00e7lar\u0131 ve en iyi uygulamalar\u0131 vard\u0131r. \u0130\u015fte \u015fablonlar bu noktada devreye girer.<\/p>\n Bir FastAPI projesine s\u0131f\u0131rdan ba\u015flamak heyecan verici olabilir, ancak \u00e7o\u011fu zaman kendini tekrar eden bir dizi g\u00f6revi de beraberinde getirir. Veritaban\u0131 ba\u011flant\u0131lar\u0131n\u0131 yap\u0131land\u0131rmak, kimlik do\u011frulama mekanizmalar\u0131n\u0131 entegre etmek, loglama sistemlerini kurmak, test ortamlar\u0131n\u0131 ayarlamak ve da\u011f\u0131t\u0131m i\u00e7in gerekli dosyalar\u0131 (\u00f6rne\u011fin, Dockerfile) haz\u0131rlamak gibi ad\u0131mlar, her yeni projede ba\u015ftan sona yap\u0131lmak zorunda olan “boilerplate” (tekrar eden, kal\u0131p) kodlar\u0131 ve yap\u0131land\u0131rmalar\u0131 i\u00e7erir. Bu durum, geli\u015ftirme s\u00fcrecini yava\u015flatabilir, tutars\u0131zl\u0131klara yol a\u00e7abilir ve \u00f6zellikle k\u00fc\u00e7\u00fck ekiplerde veya bireysel geli\u015ftiricilerde motivasyon kayb\u0131na neden olabilir. \u0130\u015fte FastAPI \u015fablonlar\u0131 tam olarak bu sorunu \u00e7\u00f6zmek i\u00e7in tasarlanm\u0131\u015ft\u0131r.<\/p>\n Bir FastAPI \u015fablonu, temel proje yap\u0131s\u0131n\u0131, \u00f6nceden yap\u0131land\u0131r\u0131lm\u0131\u015f ayarlar\u0131 ve yayg\u0131n olarak kullan\u0131lan entegrasyonlar\u0131 i\u00e7eren bir ba\u015flang\u0131\u00e7 noktas\u0131d\u0131r. Ba\u015fka bir deyi\u015fle, bir evin temelini at\u0131p duvarlar\u0131n\u0131 \u00f6rd\u00fc\u011f\u00fcn\u00fcz, ancak i\u00e7ini zevkinize g\u00f6re d\u00f6\u015femenize izin veren bir yap\u0131 iskelesi gibidir. Bu \u015fablonlar, bir projenin “\u00e7ekirde\u011fini” olu\u015fturarak, geli\u015ftiricilerin do\u011frudan i\u015f mant\u0131\u011f\u0131n\u0131 yazmaya odaklanmas\u0131n\u0131 sa\u011flar. B\u00f6ylece, altyap\u0131sal endi\u015felerle bo\u011fu\u015fmak yerine, API’nin sundu\u011fu benzersiz de\u011fer \u00fczerine yo\u011funla\u015fabilirsiniz. Bu durum, geli\u015ftirme h\u0131z\u0131n\u0131 radikal bir \u015fekilde art\u0131r\u0131r ve projenin pazara \u00e7\u0131k\u0131\u015f s\u00fcresini (Time-to-Market) \u00f6nemli \u00f6l\u00e7\u00fcde k\u0131salt\u0131r.<\/p>\n \u015eablonlar\u0131n sundu\u011fu faydalar olduk\u00e7a \u00e7e\u015fitlidir:<\/p>\n Kapsaml\u0131 bir FastAPI \u015fablonunun i\u00e7inde genellikle a\u015fa\u011f\u0131daki bile\u015fenler bulunur:<\/p>\n Dolay\u0131s\u0131yla, bir FastAPI \u015fablonu kullanmak, sadece zaman kazanmakla kalmaz, ayn\u0131 zamanda projenizi sa\u011flam, g\u00fcvenli ve s\u00fcrd\u00fcr\u00fclebilir bir temel \u00fczerine in\u015fa etmenizi sa\u011flar. Bu, geli\u015ftiriciler i\u00e7in daha az stres, y\u00f6neticiler i\u00e7in daha az risk ve son kullan\u0131c\u0131lar i\u00e7in daha iyi bir \u00fcr\u00fcn anlam\u0131na gelir.<\/p>\n Kapsaml\u0131 bir FastAPI \u015fablonu olu\u015fturmak veya mevcut bir \u015fablonu anlamak, projenizin uzun vadeli ba\u015far\u0131s\u0131 i\u00e7in kritik \u00f6neme sahiptir. Bu b\u00f6l\u00fcm, temelden ileri d\u00fczeye kadar bir \u015fablonun tipik bile\u015fenlerini ve bunlar\u0131n nas\u0131l yap\u0131land\u0131r\u0131ld\u0131\u011f\u0131n\u0131 ad\u0131m ad\u0131m a\u00e7\u0131klayacakt\u0131r. Amac\u0131m\u0131z, sadece kod yazmak de\u011fil, ayn\u0131 zamanda bak\u0131m\u0131 kolay, \u00f6l\u00e7eklenebilir ve g\u00fcvenli bir yap\u0131 olu\u015fturmakt\u0131r. Haydi ba\u015flayal\u0131m!<\/p>\n \u0130yi bir proje yap\u0131s\u0131, kodun okunabilirli\u011fini ve bak\u0131m\u0131n\u0131 art\u0131r\u0131r. Mod\u00fcler bir yakla\u015f\u0131m, farkl\u0131 sorumluluklar\u0131 ayr\u0131 dizinlerde tutmam\u0131z\u0131 sa\u011flar. \u0130\u015fte yayg\u0131n olarak kullan\u0131lan bir FastAPI proje yap\u0131s\u0131:<\/p>\n <\/code><\/p>\n Bu yap\u0131, uygulaman\u0131n farkl\u0131 katmanlar\u0131n\u0131 net bir \u015fekilde ay\u0131rarak, her bir bile\u015fenin kendi sorumlulu\u011funu yerine getirmesini sa\u011flar. Bu sayede, \u00f6rne\u011fin bir API u\u00e7 noktas\u0131n\u0131 de\u011fi\u015ftirmek istedi\u011finizde, veritaban\u0131 modeline veya i\u015f mant\u0131\u011f\u0131na do\u011frudan m\u00fcdahale etmek zorunda kalmazs\u0131n\u0131z.<\/p>\n Python projelerinde ba\u011f\u0131ml\u0131l\u0131k y\u00f6netimi hayati \u00f6neme sahiptir. Projenizin t\u00fcm ba\u011f\u0131ml\u0131l\u0131klar\u0131n\u0131 izole bir ortamda tutmak i\u00e7in sanal ortamlar kullan\u0131l\u0131r. \u0130ki ana yakla\u015f\u0131m vard\u0131r:<\/p>\n <\/code><\/p>\n Sanal ortam olu\u015fturma ve ba\u011f\u0131ml\u0131l\u0131k y\u00fckleme:<\/p>\n <\/code>\n <\/li>\n Uygulama ayarlar\u0131 (veritaban\u0131 ba\u011flant\u0131 dizgeleri, API anahtarlar\u0131 vb.) asla do\u011frudan koda g\u00f6m\u00fclmemelidir. Bunun yerine, ortam de\u011fi\u015fkenleri veya \u00f6zel bir ayar dosyas\u0131 arac\u0131l\u0131\u011f\u0131yla y\u00f6netilmelidir. FastAPI, Pydantic'in <\/code><\/p>\n <\/code><\/p>\n Bu yap\u0131land\u0131rma, hem yerel geli\u015ftirme hem de \u00fcretim ortamlar\u0131 aras\u0131nda ayarlar\u0131n kolayca ge\u00e7i\u015f yapmas\u0131n\u0131 sa\u011flar.<\/p>\n \u00c7o\u011fu web uygulamas\u0131 bir veritaban\u0131na ihtiya\u00e7 duyar. Python ekosisteminde SQLAlchemy, en pop\u00fcler ORM (Nesne \u0130li\u015fkisel E\u015fleyici) k\u00fct\u00fcphanesidir. Asenkron veritaban\u0131 s\u00fcr\u00fcc\u00fcleri ( <\/code><\/p>\n Yukar\u0131daki kod, asenkron veritaban\u0131 motorunu ve oturum y\u00f6netimini tan\u0131mlar. API g\u00fcvenli\u011fi, herhangi bir modern uygulaman\u0131n temelidir. FastAPI \u015fablonlar\u0131 genellikle JWT (JSON Web Token) tabanl\u0131 kimlik do\u011frulama veya OAuth2 gibi standartlar\u0131 entegre eder. Bu, kullan\u0131c\u0131lar\u0131n kimliklerini do\u011frulamas\u0131n\u0131 ve belirli kaynaklara eri\u015fim yetkilerini kontrol etmesini sa\u011flar.<\/p>\n <\/code><\/p>\n Bu b\u00f6l\u00fcm, kullan\u0131c\u0131 \u015fifrelerinin hash'lenmesi, JWT tokenlar\u0131n\u0131n olu\u015fturulmas\u0131 ve do\u011frulanmas\u0131 gibi g\u00fcvenlik i\u015flemlerini i\u00e7erir. FastAPI'nin Bu temel yap\u0131land\u0131rmalar, bir FastAPI \u015fablonunun omurgas\u0131n\u0131 olu\u015fturur. Her bir bile\u015fen, uygulaman\u0131z\u0131n daha sa\u011flam, d\u00fczenli ve y\u00f6netilebilir olmas\u0131n\u0131 sa\u011flar. Bu sayede, geli\u015ftirme ekibi daha verimli \u00e7al\u0131\u015fabilir ve son \u00fcr\u00fcn daha y\u00fcksek kalitede olur.<\/p>\n Teorik bilgilerden sonra, ger\u00e7ek bir senaryo \u00fczerinden FastAPI \u015fablonunun somut faydalar\u0131n\u0131 inceleyelim. Diyelim ki, b\u00fcy\u00fck bir e-ticaret platformu i\u00e7in kullan\u0131c\u0131 y\u00f6netimi, sipari\u015f y\u00f6netimi, \u00fcr\u00fcn katalogu gibi farkl\u0131 i\u015flevlere sahip mikroservisler geli\u015ftiriyoruz. \"Kullan\u0131c\u0131 Y\u00f6netimi Mikroservisi\" olu\u015fturmak, bu vaka analizi i\u00e7in m\u00fckemmel bir ba\u015flang\u0131\u00e7 noktas\u0131d\u0131r. Bu mikroservis, kullan\u0131c\u0131 kay\u0131tlar\u0131n\u0131, profil bilgilerini ve kimlik do\u011frulama s\u00fcre\u00e7lerini y\u00f6netecek.<\/p>\n Bu senaryoda, bir FastAPI \u015fablonu kullanman\u0131n bize sa\u011flayaca\u011f\u0131 avantajlar \u015funlar olacakt\u0131r:<\/p>\n Bu mikroservis i\u00e7in \u015fablonun sundu\u011fu temel bile\u015fenler \u015funlar olabilir:<\/p>\n \u015eablonun temel <\/code><\/p>\n Kullan\u0131c\u0131 API u\u00e7 noktalar\u0131ndan biri ( <\/code><\/p>\n Bu API'ler, \u015fablonun sa\u011flad\u0131\u011f\u0131 \u015eablonun i\u00e7erdi\u011fi <\/code><\/p>\n Bu \u015eablon, <\/code><\/p>\n G\u00f6r\u00fcld\u00fc\u011f\u00fc gibi, \u015fablon sayesinde mikroservisimiz h\u0131zl\u0131ca hayata ge\u00e7irilebiliyor, standartlara uygun olarak geli\u015ftirilebiliyor ve da\u011f\u0131t\u0131m ile test s\u00fcre\u00e7leri ba\u015ftan sona d\u00fc\u015f\u00fcn\u00fclm\u00fc\u015f oluyor. Bu, \u00f6zellikle s\u00fcrekli teslimat ve h\u0131zl\u0131 yineleme gerektiren modern yaz\u0131l\u0131m geli\u015ftirme yakla\u015f\u0131mlar\u0131nda paha bi\u00e7ilmez bir avantaj sunar.<\/p>\n Bir FastAPI \u015fablonunun temelini att\u0131ktan sonra, performans\u0131 art\u0131rmak, g\u00fcvenli\u011fi sa\u011flamla\u015ft\u0131rmak ve genel olarak daha sa\u011flam bir uygulama olu\u015fturmak i\u00e7in ileri d\u00fczey optimizasyonlara ve en iyi uygulamalara ge\u00e7mek \u00f6nemlidir. Bu ad\u0131mlar, projenizin olgunlu\u011funu ve profesyonelli\u011fini g\u00f6sterir.<\/p>\n FastAPI zaten olduk\u00e7a h\u0131zl\u0131d\u0131r, ancak baz\u0131 ek ad\u0131mlarla performans\u0131n\u0131 daha da optimize edebilirsiniz:<\/p>\n G\u00fcvenlik her zaman \u00f6ncelikli olmal\u0131d\u0131r:<\/p>\n <\/code>\n <\/li>\n S\u00fcrekli Entegrasyon\/S\u00fcrekli Da\u011f\u0131t\u0131m (CI\/CD), modern geli\u015ftirmenin vazge\u00e7ilmezidir. \u015eablonunuzda CI\/CD yap\u0131land\u0131rmalar\u0131 bulundurmak, geli\u015ftirme s\u00fcrecini h\u0131zland\u0131r\u0131r ve hatalar\u0131 azalt\u0131r:<\/p>\n <\/code><\/p>\n Uygulaman\u0131z\u0131n \u00fcretim ortam\u0131nda nas\u0131l davrand\u0131\u011f\u0131n\u0131 anlamak i\u00e7in izleme ve loglama kritik \u00f6neme sahiptir:<\/p>\n FastAPI do\u011frudan HTML \u00fcretmese de, API'nizin mobil uygulamalar veya duyarl\u0131 web aray\u00fczleri taraf\u0131ndan kolayca t\u00fcketilmesini sa\u011flayacak baz\u0131 prensipler vard\u0131r. Bir \u015fablon, bu prensipleri uygulaman\u0131za yard\u0131mc\u0131 olabilir:<\/p>\n API tasar\u0131m\u0131, do\u011frudan CSS media query'lerini i\u00e7ermese de, bir \u015fablonun sundu\u011fu yap\u0131land\u0131rma ve en iyi uygulamalar, mobil uygulamalar\u0131n ihtiya\u00e7 duydu\u011fu performans\u0131 ve esnekli\u011fi sa\u011flamada kritik rol oynar. \u00d6rne\u011fin, bir API iste\u011fiyle d\u00f6nen verinin, farkl\u0131 ekran boyutlar\u0131na sahip istemciler taraf\u0131ndan nas\u0131l i\u015flenece\u011fine dair mant\u0131k, istemci taraf\u0131nda yer al\u0131r. Ancak API, bu istemcilerin kolayca t\u00fcketebilece\u011fi bi\u00e7imde tasarlanmal\u0131d\u0131r. E\u011fer bir frontend projesinde mobil uyumlu HTML\/CSS kullanmak istenseydi, \u00f6rnek bir medya sorgusu \u015f\u00f6yle g\u00f6r\u00fcnebilirdi:<\/p>\nFastAPI \u015eablonlar\u0131 Ne \u0130\u015fe Yarar?<\/h2>\n
\n
\n
requirements.txt<\/code>, pyproject.toml<\/code> (Poetry) gibi dosyalar.<\/li>\n.env<\/code> dosyalar\u0131 ve Pydantic’in BaseSettings<\/code> kullan\u0131m\u0131.<\/li>\npytest<\/code> ile birim ve entegrasyon testleri.<\/li>\nDockerfile<\/code>, docker-compose.yml<\/code>.<\/li>\nKapsaml\u0131 Bir FastAPI \u015eablonu Nas\u0131l Yap\u0131land\u0131r\u0131l\u0131r?<\/h2>\n
Proje Yap\u0131s\u0131 Olu\u015fturma<\/h3>\n
\nmy_fastapi_project\/\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 core\/ # Temel ayarlar, ba\u011f\u0131ml\u0131l\u0131klar, g\u00fcvenlik\n\u2502 \u2502 \u251c\u2500\u2500 __init__.py\n\u2502 \u2502 \u251c\u2500\u2500 config.py # Ortam de\u011fi\u015fkenleri ve ayarlar\n\u2502 \u2502 \u251c\u2500\u2500 security.py # Kimlik do\u011frulama fonksiyonlar\u0131\n\u2502 \u2502 \u2514\u2500\u2500 dependencies.py # Ba\u011f\u0131ml\u0131l\u0131k enjeksiyonlar\u0131\n\u2502 \u251c\u2500\u2500 db\/ # Veritaban\u0131 ile ilgili her \u015fey\n\u2502 \u2502 \u251c\u2500\u2500 __init__.py\n\u2502 \u2502 \u251c\u2500\u2500 base.py # Ortak veritaban\u0131 modeli\n\u2502 \u2502 \u251c\u2500\u2500 session.py # Veritaban\u0131 oturum y\u00f6netimi\n\u2502 \u2502 \u2514\u2500\u2500 models.py # Veritaban\u0131 modelleri (SQLAlchemy)\n\u2502 \u251c\u2500\u2500 api\/ # API u\u00e7 noktalar\u0131\n\u2502 \u2502 \u251c\u2500\u2500 __init__.py\n\u2502 \u2502 \u251c\u2500\u2500 v1\/ # API versiyonu (iste\u011fe ba\u011fl\u0131)\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 # Kullan\u0131c\u0131 ile ilgili API'ler\n\u2502 \u2502 \u2502 \u2502 \u2514\u2500\u2500 items.py # \u00d6\u011fe ile ilgili API'ler\n\u2502 \u2502 \u2502 \u2514\u2500\u2500 schemas\/ # Pydantic modelleri\n\u2502 \u2502 \u2502 \u251c\u2500\u2500 __init__.py\n\u2502 \u2502 \u2502 \u251c\u2500\u2500 user.py\n\u2502 \u2502 \u2502 \u2514\u2500\u2500 item.py\n\u2502 \u251c\u2500\u2500 crud\/ # Create, Read, Update, Delete operasyonlar\u0131\n\u2502 \u2502 \u251c\u2500\u2500 __init__.py\n\u2502 \u2502 \u251c\u2500\u2500 crud_user.py\n\u2502 \u2502 \u2514\u2500\u2500 crud_item.py\n\u2502 \u2514\u2500\u2500 services\/ # \u0130\u015f mant\u0131\u011f\u0131 servisleri\n\u2502 \u2514\u2500\u2500 __init__.py\n\u251c\u2500\u2500 tests\/ # Testler\n\u2502 \u251c\u2500\u2500 __init__.py\n\u2502 \u251c\u2500\u2500 conftest.py\n\u2502 \u2514\u2500\u2500 test_api.py\n\u251c\u2500\u2500 scripts\/ # Yard\u0131mc\u0131 betikler (veritaban\u0131 migrasyonlar\u0131 vb.)\n\u251c\u2500\u2500 .env.example # Ortam de\u011fi\u015fkenleri \u00f6rne\u011fi\n\u251c\u2500\u2500 .gitignore\n\u251c\u2500\u2500 Dockerfile # Docker yap\u0131land\u0131rmas\u0131\n\u251c\u2500\u2500 docker-compose.yml # Docker Compose yap\u0131land\u0131rmas\u0131\n\u251c\u2500\u2500 pyproject.toml # Poetry ba\u011f\u0131ml\u0131l\u0131k y\u00f6netimi (veya requirements.txt)\n\u2514\u2500\u2500 README.md\n <\/pre>\nBa\u011f\u0131ml\u0131l\u0131k Y\u00f6netimi ve Sanal Ortamlar<\/h3>\n
\n
requirements.txt<\/code> dosyas\u0131na yazars\u0131n\u0131z.\n\nFastAPI==0.111.0\nuvicorn[standard]==0.29.0\nSQLAlchemy==2.0.29\npsycopg2-binary==2.9.9\npython-dotenv==1.0.1\nPydantic-Settings==2.2.1\n <\/pre>\n\npython -m venv venv\nsource venv\/bin\/activate # Windows: venv\\Scripts\\activate\npip install -r requirements.txt\n <\/pre>\npyproject.toml<\/code> dosyas\u0131nda tan\u0131mlar ve kilit dosyalar\u0131 (poetry.lock<\/code>) ile ba\u011f\u0131ml\u0131l\u0131k versiyonlar\u0131n\u0131 kesin olarak belirler. Poetry, sanal ortamlar\u0131 sizin i\u00e7in otomatik olarak y\u00f6netir.<\/li>\n<\/ul>\nAyarlar ve Ortam De\u011fi\u015fkenleri<\/h3>\n
BaseSettings<\/code> s\u0131n\u0131f\u0131n\u0131 kullanarak bu konuda harika bir \u00e7\u00f6z\u00fcm sunar. .env<\/code> dosyalar\u0131 arac\u0131l\u0131\u011f\u0131yla ortam de\u011fi\u015fkenlerini kolayca y\u00fckleyebilirsiniz.<\/p>\n\n# app\/core\/config.py\nfrom pydantic_settings import BaseSettings, SettingsConfigDict\n\nclass Settings(BaseSettings):\n PROJECT_NAME: str = \"FastAPI Project Template\"\n API_V1_STR: str = \"\/api\/v1\"\n DATABASE_URL: str\n SECRET_KEY: str\n ALGORITHM: str = \"HS256\"\n ACCESS_TOKEN_EXPIRE_MINUTES: int = 30\n\n model_config = SettingsConfigDict(env_file=\".env\", extra=\"ignore\")\n\nsettings = Settings()\n <\/pre>\n\n# .env.example\nDATABASE_URL=\"postgresql+asyncpg:\/\/user:password@db:5432\/fastapi_db\"\nSECRET_KEY=\"supersecretkeyforencryption\"\n <\/pre>\nVeritaban\u0131 Entegrasyonu<\/h3>\n
asyncpg<\/code> gibi) ile birlikte SQLAlchemy 2.0, FastAPI ile sorunsuz bir \u015fekilde \u00e7al\u0131\u015f\u0131r. Alembic ise veritaban\u0131 \u015fema migrasyonlar\u0131 i\u00e7in kullan\u0131l\u0131r.<\/p>\n\n# app\/db\/session.py\nfrom sqlalchemy.ext.asyncio import create_async_engine, AsyncSession\nfrom sqlalchemy.orm import sessionmaker\nfrom app.core.config import settings\n\nengine = create_async_engine(settings.DATABASE_URL, echo=True)\nAsyncSessionLocal = sessionmaker(\n autocommit=False,\n autoflush=False,\n bind=engine,\n class_=AsyncSession,\n expire_on_commit=False,\n)\n\nasync def get_db():\n async with AsyncSessionLocal() as session:\n yield session\n <\/pre>\nget_db<\/code> fonksiyonu, FastAPI'nin ba\u011f\u0131ml\u0131l\u0131k enjeksiyon sistemiyle veritaban\u0131 oturumlar\u0131n\u0131 API u\u00e7 noktalar\u0131na sa\u011flamak i\u00e7in kullan\u0131lacakt\u0131r.<\/p>\nKimlik Do\u011frulama ve Yetkilendirme<\/h3>\n
\n# app\/core\/security.py\nfrom datetime import datetime, timedelta\nfrom jose import jwt, JWTError\nfrom app.core.config import settings\n\ndef create_access_token(data: dict):\n to_encode = data.copy()\n expire = datetime.utcnow() + timedelta(minutes=settings.ACCESS_TOKEN_EXPIRE_MINUTES)\n to_encode.update({\"exp\": expire})\n encoded_jwt = jwt.encode(to_encode, settings.SECRET_KEY, algorithm=settings.ALGORITHM)\n return encoded_jwt\n\n# Token'\u0131 do\u011frulamak i\u00e7in bir fonksiyon da burada yer al\u0131r.\n <\/pre>\nSecurity<\/code> ve Depends<\/code> mekanizmalar\u0131 ile bu g\u00fcvenlik kontrollerini API u\u00e7 noktalar\u0131na kolayca entegre edebilirsiniz.<\/p>\nUygulamal\u0131 Vaka Analizi: Mikroservis \u0130\u00e7in FastAPI \u015eablonu<\/h2>\n
\n
Dockerfile<\/code> ve docker-compose.yml<\/code> i\u00e7erdi\u011fi i\u00e7in, mikroservisi yerel ortamda \u00e7al\u0131\u015ft\u0131rmak veya \u00fcretim ortam\u0131na da\u011f\u0131tmak \u00e7ok daha kolayd\u0131r.<\/li>\npytest<\/code> entegrasyonu sayesinde, kullan\u0131c\u0131 API'leri i\u00e7in birim ve entegrasyon testlerini kolayca yazabiliriz.<\/li>\n<\/ol>\nKullan\u0131c\u0131 Y\u00f6netimi Mikroservisi Mimari Bile\u015fenleri<\/h3>\n
\n
app\/main.py<\/code>:<\/strong> Ana FastAPI uygulamas\u0131, router'lar\u0131 i\u00e7erir.<\/li>\napp\/api\/v1\/endpoints\/users.py<\/code>:<\/strong> Kullan\u0131c\u0131 kayd\u0131, giri\u015fi, profil g\u00f6r\u00fcnt\u00fcleme ve g\u00fcncelleme API u\u00e7 noktalar\u0131.<\/li>\napp\/api\/v1\/schemas\/user.py<\/code>:<\/strong> Kullan\u0131c\u0131 veri modeli (Pydantic), \u00f6rne\u011fin UserCreate<\/code>, UserRead<\/code>, UserUpdate<\/code>.<\/li>\napp\/crud\/crud_user.py<\/code>:<\/strong> Kullan\u0131c\u0131 veritaban\u0131 i\u015flemleri (olu\u015fturma, okuma, g\u00fcncelleme, silme).<\/li>\napp\/db\/models.py<\/code>:<\/strong> SQLAlchemy kullan\u0131c\u0131 modeli.<\/li>\napp\/core\/security.py<\/code>:<\/strong> \u015eifre hash'leme, JWT token olu\u015fturma\/do\u011frulama.<\/li>\nDockerfile<\/code>:<\/strong> Uygulamay\u0131 Docker konteyneri olarak paketlemek i\u00e7in.<\/li>\ntests\/test_users.py<\/code>:<\/strong> Kullan\u0131c\u0131 API'leri i\u00e7in testler.<\/li>\n<\/ul>\nKod \u00d6rnekleri ile Uygulama<\/h3>\n
main.py<\/code> dosyas\u0131 \u015fu \u015fekilde g\u00f6r\u00fcnebilir:<\/p>\n\n# app\/main.py\nfrom fastapi import FastAPI\nfrom app.api.v1.endpoints import users, items # Di\u011fer mikroservislerin API'leri\n\napp = FastAPI(title=\"Kullan\u0131c\u0131 Y\u00f6netimi Mikroservisi\")\n\napp.include_router(users.router, prefix=\"\/api\/v1\/users\", tags=[\"users\"])\n# app.include_router(items.router, prefix=\"\/api\/v1\/items\", tags=[\"items\"]) # Di\u011fer mikroservis API'leri\n <\/pre>\napp\/api\/v1\/endpoints\/users.py<\/code>):<\/p>\n\n# app\/api\/v1\/endpoints\/users.py\nfrom fastapi import APIRouter, Depends, HTTPException, status\nfrom sqlalchemy.ext.asyncio import AsyncSession\nfrom app.db.session import get_db\nfrom app.api.v1.schemas.user import UserCreate, UserRead, UserLogin\nfrom app.crud.crud_user import crud_user\nfrom app.core.security import create_access_token, verify_password, get_password_hash\n\nrouter = APIRouter()\n\n@router.post(\"\/register\", response_model=UserRead, status_code=status.HTTP_201_CREATED)\nasync def register_user(user_in: UserCreate, db: AsyncSession = Depends(get_db)):\n existing_user = await crud_user.get_by_email(db, email=user_in.email)\n if existing_user:\n raise HTTPException(status_code=400, detail=\"E-posta zaten kay\u0131tl\u0131.\")\n \n user_in.password = get_password_hash(user_in.password)\n user = await crud_user.create(db, obj_in=user_in)\n return user\n\n@router.post(\"\/login\")\nasync def login_for_access_token(form_data: UserLogin, db: AsyncSession = Depends(get_db)):\n user = await crud_user.get_by_email(db, email=form_data.email)\n if not user or not verify_password(form_data.password, user.hashed_password):\n raise HTTPException(\n status_code=status.HTTP_401_UNAUTHORIZED,\n detail=\"Yanl\u0131\u015f e-posta veya \u015fifre\",\n headers={\"WWW-Authenticate\": \"Bearer\"},\n )\n access_token = create_access_token(data={\"sub\": user.email})\n return {\"access_token\": access_token, \"token_type\": \"bearer\"}\n <\/pre>\nget_db<\/code> ba\u011f\u0131ml\u0131l\u0131\u011f\u0131n\u0131 kullanarak veritaban\u0131na eri\u015fir ve crud_user<\/code> ile kullan\u0131c\u0131ya \u00f6zel i\u015flemleri ger\u00e7ekle\u015ftirir. \u015eifre hash'leme ve JWT token olu\u015fturma ise app\/core\/security.py<\/code>'den gelir. Bu sayede, her \u015fey d\u00fczenli ve ayr\u0131lm\u0131\u015f katmanlar halinde kal\u0131r.<\/p>\nDocker Entegrasyonu<\/h3>\n
Dockerfile<\/code> sayesinde, uygulamay\u0131 bir konteyner i\u00e7inde izole bir \u015fekilde \u00e7al\u0131\u015ft\u0131rabiliriz:<\/p>\n\n# Dockerfile\nFROM python:3.10-slim-buster\n\nWORKDIR \/app\n\nCOPY .\/requirements.txt \/app\/requirements.txt\n\nRUN pip install --no-cache-dir -r \/app\/requirements.txt\n\nCOPY .\/app \/app\/app\n\nEXPOSE 8000\n\nCMD [\"uvicorn\", \"app.main:app\", \"--host\", \"0.0.0.0\", \"--port\", \"8000\"]\n <\/pre>\nDockerfile<\/code>, mikroservisimizi bir Docker imaj\u0131na d\u00f6n\u00fc\u015ft\u00fcrmek i\u00e7in gereken ad\u0131mlar\u0131 i\u00e7erir. Bu, geli\u015ftirme, test ve \u00fcretim ortamlar\u0131 aras\u0131nda tutarl\u0131 bir \u00e7al\u0131\u015fma ortam\u0131 sa\u011flar.<\/p>\nTest Mekanizmas\u0131<\/h3>\n
pytest<\/code> ile entegre test altyap\u0131s\u0131 sunar. Bir kullan\u0131c\u0131 kay\u0131t test \u00f6rne\u011fi:<\/p>\n\n# tests\/test_users.py\nfrom httpx import AsyncClient\nimport pytest\n\n@pytest.mark.asyncio\nasync def test_create_user(client: AsyncClient):\n response = await client.post(\n \"\/api\/v1\/users\/register\",\n json={\"email\": \"test@example.com\", \"password\": \"securepassword\"}\n )\n assert response.status_code == 201\n assert response.json()[\"email\"] == \"test@example.com\"\n assert \"hashed_password\" not in response.json() # G\u00fcvenlik kontrol\u00fc\n\n@pytest.mark.asyncio\nasync def test_login_user(client: AsyncClient):\n # \u00d6nce kullan\u0131c\u0131 olu\u015ftur\n await client.post(\n \"\/api\/v1\/users\/register\",\n json={\"email\": \"login@example.com\", \"password\": \"securepassword\"}\n )\n # Sonra giri\u015f yap\n response = await client.post(\n \"\/api\/v1\/users\/login\",\n json={\"email\": \"login@example.com\", \"password\": \"securepassword\"}\n )\n assert response.status_code == 200\n assert \"access_token\" in response.json()\n assert response.json()[\"token_type\"] == \"bearer\"\n <\/pre>\n\u0130leri D\u00fczey Optimizasyonlar ve En \u0130yi Uygulamalar<\/h2>\n
Performans \u0130pu\u00e7lar\u0131<\/h3>\n
\n
gunicorn -w 4 -k uvicorn.workers.UvicornWorker app.main:app<\/code><\/li>\nasyncpg<\/code>) do\u011fru kullan\u0131ld\u0131\u011f\u0131ndan emin olun.<\/li>\nG\u00fcvenlik Katmanlar\u0131<\/h3>\n
\n
\n# app\/main.py\nfrom fastapi.middleware.cors import CORSMiddleware\n\napp.add_middleware(\n CORSMiddleware,\n allow_origins=[\"http:\/\/localhost:3000\", \"https:\/\/yourfrontend.com\"], # \u0130zin verilen kaynaklar\n allow_credentials=True,\n allow_methods=[\"*\"],\n allow_headers=[\"*\"],\n)\n <\/pre>\nfastapi-limiter<\/code> gibi k\u00fct\u00fcphanelerle).<\/li>\n.env<\/code> dosyalar\u0131 arac\u0131l\u0131\u011f\u0131yla g\u00fcvenli bir \u015fekilde y\u00f6netin.<\/li>\n<\/ul>\nOtomasyon ve CI\/CD Entegrasyonu<\/h3>\n
\n
Black<\/code>, Flake8<\/code>, isort<\/code> gibi ara\u00e7larla kodunuzun tutarl\u0131 kalmas\u0131n\u0131 sa\u011flay\u0131n. pre-commit<\/code> kancalar\u0131 (hooks) ile bu kontrolleri otomatikle\u015ftirin.<\/li>\n\n# .github\/workflows\/ci.yml (\u00d6rnek GitHub Actions yap\u0131land\u0131rmas\u0131)\nname: FastAPI CI\n\non:\n push:\n branches: [ main, develop ]\n pull_request:\n branches: [ main, develop ]\n\njobs:\n build:\n runs-on: ubuntu-latest\n steps:\n - uses: actions\/checkout@v4\n - name: Set up Python 3.10\n uses: actions\/setup-python@v5\n with:\n python-version: \"3.10\"\n - name: Install dependencies\n run: |\n python -m pip install --upgrade pip\n pip install -r requirements.txt\n - name: Run tests\n run: |\n pytest\n - name: Build and push Docker image (iste\u011fe ba\u011fl\u0131)\n if: github.ref == 'refs\/heads\/main'\n run: |\n echo \"Building and pushing Docker image...\"\n # Docker login, build ve push komutlar\u0131 burada yer al\u0131r.\n <\/pre>\n\u0130zleme ve Loglama<\/h3>\n
\n
Mobil Uyumlu API Tasar\u0131m\u0131<\/h3>\n
\n
\/v1\/<\/code>, \/v2\/<\/code> gibi yollarla s\u00fcr\u00fcmleyerek, eski mobil uygulamalar\u0131n yeni API de\u011fi\u015fikliklerinden etkilenmemesini sa\u011flay\u0131n.<\/li>\n\n