# Gelişmiş Kullanıcı Rehberi { #advanced-user-guide }
## Ek Özellikler
## Ek Özellikler { #additional-features }
[Tutorial - User Guide](../tutorial/index.md){.internal-link target=_blank} sayfası **FastAPI**'ın tüm ana özelliklerini tanıtmaya yetecektir.
Ana [Tutorial - User Guide](../tutorial/index.md){.internal-link target=_blank} sayfası,**FastAPI**'ın tüm ana özellikleri arasında bir tur atmanız için yeterli olmalıdır.
İlerleyen bölümlerde diğer seçenekler, konfigürasyonlar ve ek özellikleri göreceğiz.
İlerleyen bölümlerde diğer seçenekler, konfigürasyonlar ve ek özellikleri göreceksiniz.
/// tip | İpucu
/// tip | İpucu
Sonraki bölümler **mutlaka "gelişmiş" olmak zorunda değildir**.
Sonraki bölümler **mutlaka "gelişmiş" olmak zorunda değildir**.
Kullanım şeklinize bağlı olarak, çözümünüz bu bölümlerden birinde olabilir.
Ve kullanım senaryonuza bağlı olarak, çözüm bu bölümlerden birinde olabilir.
///
///
## Önce Öğreticiyi Okuyun
## Önce Öğreticiyi Okuyun { #read-the-tutorial-first }
[Tutorial - User Guide](../tutorial/index.md){.internal-link target=_blank} sayfasındaki bilgilerle **FastAPI**'nın çoğu özelliğini kullanabilirsiniz.
Ana [Tutorial - User Guide](../tutorial/index.md){.internal-link target=_blank} sayfasındaki bilgilerle **FastAPI**'ın çoğu özelliğini yine de kullanabilirsiniz.
Sonraki bölümler bu sayfayı okuduğunuzu ve bu ana fikirleri bildiğinizi varsayarak hazırlanmıştır.
Ve sonraki bölümler, onu zaten okuduğunuzu ve o ana fikirleri bildiğinizi varsayar.
## Diğer Kurslar
[Tutorial - User Guide](../tutorial/index.md){.internal-link target=_blank} sayfası ve bu **Gelişmiş Kullanıcı Rehberi**, öğretici bir kılavuz (bir kitap gibi) şeklinde yazılmıştır ve **FastAPI'ı öğrenmek** için yeterli olsa da, ek kurslarla desteklemek isteyebilirsiniz.
Belki de öğrenme tarzınıza daha iyi uyduğu için başka kursları tercih edebilirsiniz.
Bazı kurs sağlayıcıları ✨ [**FastAPI destekçileridir**](../help-fastapi.md#sponsor-the-author){.internal-link target=_blank} ✨, bu FastAPI ve **ekosisteminin** sürekli ve sağlıklı bir şekilde **gelişmesini** sağlar.
Ayrıca, size **iyi bir öğrenme deneyimi** sağlamakla kalmayıp, **iyi ve sağlıklı bir framework** olan FastAPI'a ve ve **topluluğuna** (yani size) olan gerçek bağlılıklarını gösterir.
[Tutorial - User Guide: Security](../../tutorial/security/index.md){.internal-link target=_blank} sayfasında ele alınanların dışında güvenlikle ilgili bazı ek özellikler vardır.
[Tutorial - User Guide: Security](../../tutorial/security/index.md){.internal-link target=_blank} sayfasında ele alınanların dışında güvenlikle ilgili bazı ek özellikler vardır.
@ -8,12 +8,12 @@
Sonraki bölümler **mutlaka "gelişmiş" olmak zorunda değildir**.
Sonraki bölümler **mutlaka "gelişmiş" olmak zorunda değildir**.
Kullanım şeklinize bağlı olarak, çözümünüz bu bölümlerden birinde olabilir.
Ve kullanım durumunuz için çözümün bunlardan birinde olması mümkündür.
///
///
## Önce Öğreticiyi Okuyun
## Önce Öğreticiyi Okuyun { #read-the-tutorial-first }
Sonraki bölümler [Tutorial - User Guide: Security](../../tutorial/security/index.md){.internal-link target=_blank} sayfasını okuduğunuzu varsayarak hazırlanmıştır.
Sonraki bölümler, ana [Tutorial - User Guide: Security](../../tutorial/security/index.md){.internal-link target=_blank} sayfasını zaten okuduğunuzu varsayar.
Bu bölümler aynı kavramlara dayanır, ancak bazı ek işlevsellikler sağlar.
Hepsi aynı kavramlara dayanır, ancak bazı ek işlevler sağlar.
Daha fazla detay için Starlette'in <ahref="https://www.starlette.dev/staticfiles/"class="external-link"target="_blank">Websockets'i Test Etmek</a> dokümantasyonunu inceleyin.
Daha fazla detay için Starlette'in <ahref="https://www.starlette.dev/testclient/#testing-websocket-sessions"class="external-link"target="_blank">WebSockets'i test etme</a> dokümantasyonunu inceleyin.
Artık `/v1/`yolunun altındaki her istek Flask uygulaması tarafından işlenecektir.
Artık `/v1/`path'inin altındaki her request Flask uygulaması tarafından işlenecektir.
Geri kalanı ise **FastAPI** tarafından işlenecektir.
Geri kalanı ise **FastAPI** tarafından işlenecektir.
Eğer uygulamanızı çalıştırıp <ahref="http://localhost:8000/v1/"class="external-link"target="_blank">http://localhost:8000/v1/</a> adresine giderseniz, Flask'tan gelen yanıtı göreceksiniz:
Eğer bunu çalıştırıp <ahref="http://localhost:8000/v1/"class="external-link"target="_blank">http://localhost:8000/v1/</a> adresine giderseniz, Flask'tan gelen response'u göreceksiniz:
```txt
```txt
Hello, World from Flask!
Hello, World from Flask!
```
```
Eğer <ahref="http://localhost:8000/v2/"class="external-link"target="_blank">http://localhost:8000/v2/</a> adresine giderseniz, FastAPI'dan gelen yanıtı göreceksiniz:
Ve eğer <ahref="http://localhost:8000/v2"class="external-link"target="_blank">http://localhost:8000/v2</a> adresine giderseniz, FastAPI'dan gelen response'u göreceksiniz:
Bağımsız TechEmpower kıyaslamaları gösteriyor ki<ahref="https://www.techempower.com/benchmarks/#section=test&runid=7464e520-0dc2-473d-bd34-dbdfd7e85911&hw=ph&test=query&l=zijzen-7"class="external-link"target="_blank">en hızlı Python frameworklerinden birisi</a> olan Uvicorn ile çalıştırılan **FastAPI** uygulamaları, sadece Starlette ve Uvicorn'dan daha düşük sıralamada (FastAPI bu frameworklerin üzerine kurulu) yer alıyor. (*)
Bağımsız TechEmpower kıyaslamaları, Uvicorn altında çalışan **FastAPI** uygulamalarının<ahref="https://www.techempower.com/benchmarks/#section=test&runid=7464e520-0dc2-473d-bd34-dbdfd7e85911&hw=ph&test=query&l=zijzen-7"class="external-link"target="_blank">mevcut en hızlı Python frameworklerinden biri</a> olduğunu, sadece Starlette ve Uvicorn'un kendisinin (FastAPI tarafından dahili olarak kullanılır) altında yer aldığını gösteriyor. (*)
Fakat kıyaslamaları ve karşılaştırmaları incelerken şunları aklınızda bulundurmalısınız.
Fakat kıyaslamaları ve karşılaştırmaları incelerken şunları aklınızda bulundurmalısınız.
## Kıyaslamalar ve Hız
## Kıyaslamalar ve Hız { #benchmarks-and-speed }
Kıyaslamaları incelediğinizde, farklı özelliklere sahip araçların eşdeğer olarak karşılaştırıldığını yaygın bir şekilde görebilirsiniz.
Kıyaslamaları incelediğinizde, farklı türlerdeki çeşitli araçların eşdeğer olarak karşılaştırıldığını görmek yaygındır.
Özellikle, (diğer birçok araç arasında) Uvicorn, Starlette ve FastAPI'ın birlikte karşılaştırıldığını görebilirsiniz.
Özellikle, (diğer birçok aracın arasında) Uvicorn, Starlette ve FastAPI'ın birlikte karşılaştırıldığını görmek.
Aracın çözdüğü problem ne kadar basitse, performansı o kadar iyi olacaktır. Ancak kıyaslamaların çoğu, aracın sağladığı ek özellikleri test etmez.
Aracın çözdüğü problem ne kadar basitse, performansı o kadar iyi olacaktır. Ve kıyaslamaların çoğu, aracın sağladığı ek özellikleri test etmez.
Hiyerarşi şöyledir:
Hiyerarşi şöyledir:
* **Uvicorn**: bir ASGI sunucusu
* **Uvicorn**: bir ASGI sunucusu
* **Starlette**: (Uvicorn'u kullanır) bir web mikroframeworkü
* **Starlette**: (Uvicorn'u kullanır) bir web microframework'ü
* **FastAPI**: (Starlette'i kullanır) veri doğrulama vb. çeşitli ek özelliklere sahip, API oluşturmak için kullanılan bir API mikroframeworkü
* **FastAPI**: (Starlette'i kullanır) veri doğrulama vb. ile, API'lar oluşturmak için çeşitli ek özelliklere sahip bir API microframework'ü
* **Uvicorn**:
* **Uvicorn**:
* Sunucunun kendisi dışında ekstra bir kod içermediği için en iyi performansa sahip olacaktır.
* Sunucunun kendisi dışında çok fazla ekstra kodu olmadığı için en iyi performansa sahip olacaktır.
* Doğrudan Uvicorn ile bir uygulama yazmazsınız. Bu, yazdığınız kodun en azından Starlette tarafından sağlanan tüm kodu (veya **FastAPI**) az çok içermesi gerektiği anlamına gelir. Eğer bunu yaptıysanız, son uygulamanız bir framework kullanmak ve uygulama kodlarını ve hataları en aza indirmekle aynı ek yüke sahip olacaktır.
* Uvicorn'da doğrudan bir uygulama yazmazsınız. Bu, kodunuzun en azından Starlette'in (veya **FastAPI**'ın) sağladığı tüm kodu az çok içermesi gerektiği anlamına gelir. Ve eğer bunu yaptıysanız, nihai uygulamanız bir framework kullanmanın ve uygulama kodunuzu ve bug'ları en aza indirmenin aynı ek yüküne sahip olacaktır.
* Eğer Uvicorn'u karşılaştırıyorsanız, Daphne, Hypercorn, uWSGI, vb. uygulama sunucuları ile karşılaştırın.
* Uvicorn'u karşılaştırıyorsanız, onu Daphne, Hypercorn, uWSGI, vb. application server'lara karşı karşılaştırın.
* **Starlette**:
* **Starlette**:
* Uvicorn'dan sonraki en iyi performansa sahip olacaktır. İşin aslı, Starlette çalışmak için Uvicorn'u kullanıyor. Dolayısıyla, daha fazla kod çalıştırmaası gerektiğinden muhtemelen Uvicorn'dan sadece "daha yavaş" olabilir.
* Uvicorn'dan sonra bir sonraki en iyi performansa sahip olacaktır. Aslında, Starlette çalışmak için Uvicorn'u kullanır. Dolayısıyla, daha fazla kod çalıştırmak zorunda olduğundan muhtemelen Uvicorn'dan yalnızca "daha yavaş" olabilir.
* Ancak yol bazlı yönlendirme vb. basit web uygulamaları oluşturmak için araçlar sağlar.
* Ancak path'lere dayalı routing, vb. ile basit web uygulamaları oluşturmanız için size araçlar sağlar.
* Eğer Starlette'i karşılaştırıyorsanız, Sanic, Flask, Django, vb. frameworkler (veya mikroframeworkler) ile karşılaştırın.
* Starlette'i karşılaştırıyorsanız, Sanic, Flask, Django, vb. web frameworkleri (veya microframeworkler) ile karşılaştırın.
* **FastAPI**:
* **FastAPI**:
* Starlette'in Uvicorn'u kullandığı ve ondan daha hızlı olamayacağı gibi, **FastAPI**'da Starlette'i kullanır, dolayısıyla ondan daha hızlı olamaz.
* Starlette'in Uvicorn'u kullanıp ondan daha hızlı olamamasıyla aynı şekilde, **FastAPI** Starlette'i kullanır, dolayısıyla ondan daha hızlı olamaz.
* FastAPI, Starlette'e ek olarak daha fazla özellik sunar. Bunlar veri doğrulama ve <abbrtitle="Dönüşüm: serialization, parsing, marshalling olarak da biliniyor">dönüşümü</abbr> gibi API'lar oluştururken neredeyse ve her zaman ihtiyaç duyduğunuz özelliklerdir. Ve bunu kullanarak, ücretsiz olarak otomatik dokümantasyon elde edersiniz (otomatik dokümantasyon çalışan uygulamalara ek yük getirmez, başlangıçta oluşturulur).
* FastAPI, Starlette'in üzerine daha fazla özellik sağlar. Veri doğrulama ve serialization gibi, API'lar oluştururken neredeyse her zaman ihtiyaç duyduğunuz özellikler. Ve bunu kullanarak, ücretsiz olarak otomatik dokümantasyon elde edersiniz (otomatik dokümantasyon çalışan uygulamalara ek yük bile getirmez, başlangıçta üretilir).
* FastAPI'ı kullanmadıysanız ve Starlette'i doğrudan kullandıysanız (veya başka bir araç, Sanic, Flask, Responder, vb.) tüm veri doğrulama ve dönüştürme araçlarını kendiniz geliştirmeniz gerekir. Dolayısıyla, son uygulamanız FastAPI kullanılarak oluşturulmuş gibi hâlâ aynı ek yüke sahip olacaktır. Çoğu durumda, uygulamalarda yazılan kodun büyük bir kısmını veri doğrulama ve dönüştürme kodları oluşturur.
* FastAPI'ı kullanmadıysanız ve Starlette'i doğrudan kullandıysanız (veya Sanic, Flask, Responder, vb. gibi başka bir araç) tüm veri doğrulama ve serialization'ı kendiniz uygulamak zorunda kalırdınız. Dolayısıyla, nihai uygulamanız FastAPI kullanılarak oluşturulmuş gibi hâlâ aynı ek yüke sahip olacaktır. Ve birçok durumda, bu veri doğrulama ve serialization, uygulamalarda yazılan kodun en büyük kısmıdır.
* Dolayısıyla, FastAPI'ı kullanarak geliştirme süresinden, hatalardan, kod satırlarından tasarruf edersiniz ve kullanmadığınız durumda (birçok özelliği geliştirmek zorunda kalmakla birlikte) muhtemelen aynı performansı (veya daha iyisini) elde ederdiniz.
* Dolayısıyla, FastAPI'ı kullanarak geliştirme süresinden, bug'lardan, kod satırlarından tasarruf edersiniz ve muhtemelen onu kullanmadığınız durumda elde edeceğiniz performansın aynısını (veya daha iyisini) elde edersiniz (çünkü her şeyi kodunuzda uygulamak zorunda kalırdınız).
* Eğer FastAPI'ı karşılaştırıyorsanız, Flask-apispec, NestJS, Molten, vb. gibi veri doğrulama, dönüştürme ve dokümantasyon sağlayan bir web uygulaması frameworkü ile (veya araç setiyle) karşılaştırın.
* FastAPI'ı karşılaştırıyorsanız, veri doğrulama, serialization ve dokümantasyon sağlayan bir web uygulaması framework'ü (veya araç seti) ile, Flask-apispec, NestJS, Molten, vb. gibi, entegre otomatik veri doğrulama, serialization ve dokümantasyona sahip frameworklerle karşılaştırın.
# FastAPI Uygulamasını Bulut Sağlayıcılar Üzerinde Yayınlama
# Bulut Sağlayıcılarda FastAPI Deploy Etme { #deploy-fastapi-on-cloud-providers }
FastAPI uygulamasını yayınlamak için hemen hemen**herhangi bir bulut sağlayıcıyı** kullanabilirsiniz.
FastAPI uygulamanızı deploy etmek için neredeyse**herhangi bir bulut sağlayıcıyı** kullanabilirsiniz.
Büyük bulut sağlayıcıların çoğu FastAPI uygulamasını yayınlamak için kılavuzlara sahiptir.
Çoğu durumda, başlıca bulut sağlayıcılar FastAPI'yi onlarla deploy etmek için kılavuzlara sahiptir.
## Bulut Sağlayıcılar - Sponsorlar
## FastAPI Cloud { #fastapi-cloud }
Bazı bulut sağlayıcılar ✨ [**FastAPI destekçileridir**](../help-fastapi.md#sponsor-the-author){.internal-link target=_blank} ✨, bu FastAPI ve **ekosisteminin** sürekli ve sağlıklı bir şekilde **gelişmesini** sağlar.
**<ahref="https://fastapicloud.com"class="external-link"target="_blank">FastAPI Cloud</a>**, **FastAPI**'nin arkasındaki aynı yazar ve ekip tarafından geliştirilmiştir.
Ayrıca, size **iyi servisler** sağlamakla kalmayıp, **iyi ve sağlıklı bir framework** olan FastAPI'a bağlılıklarını gösterir.
Bir API'yi minimum eforla **oluşturma**, **deploy etme** ve **erişme** sürecini kolaylaştırır.
Bu hizmetleri denemek ve kılavuzlarını incelemek isteyebilirsiniz.
FastAPI ile uygulama oluşturmanın aynı **developer experience**'ını, onları buluta **deploy etmeye** de taşır. 🎉
FastAPI Cloud, *FastAPI and friends* açık kaynak projelerinin birincil sponsoru ve finansman sağlayıcısıdır. ✨
**FastAPI** uygulamasını deploy etmek oldukça kolaydır.
**FastAPI** uygulamasını deploy etmek nispeten kolaydır.
## Deployment Ne Anlama Gelir?
## Deployment Ne Anlama Gelir { #what-does-deployment-mean }
Bir uygulamayı **deploy** etmek (yayınlamak), uygulamayı **kullanıcılara erişilebilir hale getirmek** için gerekli adımları gerçekleştirmek anlamına gelir.
Bir uygulamayı **deploy** etmek, uygulamayı **kullanıcıların erişimine sunmak** için gerekli adımları gerçekleştirmek anlamına gelir.
Bir **Web API** için bu süreç normalde uygulamayı **uzak bir makineye** yerleştirmeyi, iyi performans, kararlılık vb. özellikler sağlayan bir **sunucu programı** ile **kullanıcılarınızın** uygulamaya etkili ve kesintisiz bir şekilde **erişebilmesini** kapsar.
Bir **web API** için bu, normalde uygulamayı **uzak bir makineye** koymayı; iyi performans, kararlılık vb. sağlayan bir **sunucu programı** ile **kullanıcılarınızın** uygulamaya verimli bir şekilde ve kesinti ya da sorun yaşamadan **erişebilmesini** sağlamayı içerir.
Bu, kodu sürekli olarak değiştirdiğiniz, hata alıp hata giderdiğiniz, geliştirme sunucusunu durdurup yeniden başlattığınız vb. **geliştirme** aşamalarının tam tersidir.
Bu, kodu sürekli değiştirdiğiniz, bozup düzelttiğiniz, geliştirme sunucusunu durdurup yeniden başlattığınız vb. **geliştirme** aşamalarının tersidir.
Kullanım durumunuza ve kullandığınız araçlara bağlı olarak bir kaç farklı yol izleyebilirsiniz.
Kullanım senaryonuza ve kullandığınız araçlara bağlı olarak bunu yapmanın birkaç yolu vardır.
Bir dizi araç kombinasyonunu kullanarak kendiniz **bir sunucu yayınlayabilirsiniz**, yayınlama sürecinin bir kısmını sizin için gerçekleştiren bir **bulut hizmeti** veya diğer olası seçenekleri kullanabilirsiniz.
Bir dizi aracın kombinasyonunu kullanarak kendiniz **bir sunucu deploy edebilirsiniz**, işin bir kısmını sizin için yapan bir **bulut hizmeti** kullanabilirsiniz veya başka olası seçenekler de vardır.
**FastAPI** uygulamasını yayınlarken aklınızda bulundurmanız gereken ana kavramlardan bazılarını size göstereceğim (ancak bunların çoğu diğer web uygulamaları için de geçerlidir).
Örneğin, FastAPI'nin arkasındaki ekip olarak, FastAPI ile çalışmanın aynı geliştirici deneyimiyle, FastAPI uygulamalarını buluta deploy etmeyi mümkün olduğunca kolaylaştırmak için <ahref="https://fastapicloud.com"class="external-link"target="_blank">**FastAPI Cloud**</a>'u geliştirdik.
Sonraki bölümlerde akılda tutulması gereken diğer ayrıntıları ve yayınlama tekniklerinden bazılarını göreceksiniz. ✨
**FastAPI** uygulamasını deploy ederken muhtemelen aklınızda tutmanız gereken ana kavramlardan bazılarını size göstereceğim (bunların çoğu diğer herhangi bir web uygulaması türü için de geçerlidir).
Sonraki bölümlerde, akılda tutulması gereken daha fazla ayrıntı ve bunu yapmak için bazı teknikler göreceksiniz. ✨
# Genel - Nasıl Yapılır - Tarifler { #general-how-to-recipes }
Bu sayfada genel ve sıkça sorulan sorular için dokümantasyonun diğer sayfalarına yönlendirmeler bulunmaktadır.
Bu sayfada genel veya sıkça sorulan sorular için dokümantasyonun diğer yerlerine yönlendirmeler bulunmaktadır.
## Veri Filtreleme - Güvenlik
## Veri Filtreleme - Güvenlik { #filter-data-security }
Döndürmeniz gereken veriden fazlasını döndürmediğinizden emin olmak için, [Tutorial - Response Model - Return Type](../tutorial/response-model.md){.internal-link target=_blank} sayfasını okuyun.
Döndürmeniz gereken veriden fazlasını döndürmediğinizden emin olmak için, [Tutorial - Response Model - Return Type](../tutorial/response-model.md){.internal-link target=_blank} dokümantasyonunu okuyun.
*Yol operasyonlarınıza* etiketler ekleyerek dokümantasyon arayüzünde gruplar halinde görünmesini sağlamak için, [Tutorial - Path Operation Configurations - Tags](../tutorial/path-operation-configuration.md#tags){.internal-link target=_blank} sayfasını okuyun.
*path operation*'larınıza etiketler eklemek ve dokümantasyon arayüzünde gruplar halinde görünmesini sağlamak için, [Tutorial - Path Operation Configurations - Tags](../tutorial/path-operation-configuration.md#tags){.internal-link target=_blank} dokümantasyonunu okuyun.
## Dokümantasyon Özeti ve Açıklaması - OpenAPI
## Dokümantasyon Özeti ve Açıklaması - OpenAPI { #documentation-summary-and-description-openapi }
*Yol operasyonlarınıza* özet ve açıklama ekleyip dokümantasyon arayüzünde görünmesini sağlamak için, [Tutorial - Path Operation Configurations - Summary and Description](../tutorial/path-operation-configuration.md#summary-and-description){.internal-link target=_blank} sayfasını okuyun.
*path operation*'larınıza özet ve açıklama eklemek ve bunları dokümantasyon arayüzünde göstermek için, [Tutorial - Path Operation Configurations - Summary and Description](../tutorial/path-operation-configuration.md#summary-and-description){.internal-link target=_blank} dokümantasyonunu okuyun.
Bir *yol işlemi*ni kullanımdan kaldırmak ve bunu dokümantasyon arayüzünde göstermek için, [Tutorial - Path Operation Configurations - Deprecation](../tutorial/path-operation-configuration.md#deprecate-a-path-operation){.internal-link target=_blank} sayfasını okuyun.
Bir *path operation*'ı kullanımdan kaldırmak ve bunu dokümantasyon arayüzünde göstermek için, [Tutorial - Path Operation Configurations - Deprecation](../tutorial/path-operation-configuration.md#deprecate-a-path-operation){.internal-link target=_blank} dokümantasyonunu okuyun.
## Herhangi Bir Veriyi JSON Uyumlu Hale Getirme
## Herhangi Bir Veriyi JSON Uyumlu Hale Getirme { #convert-any-data-to-json-compatible }
Herhangi bir veriyi JSON uyumlu hale getirmek için, [Tutorial - JSON Compatible Encoder](../tutorial/encoder.md){.internal-link target=_blank} sayfasını okuyun.
Herhangi bir veriyi JSON uyumlu hale getirmek için, [Tutorial - JSON Compatible Encoder](../tutorial/encoder.md){.internal-link target=_blank} dokümantasyonunu okuyun.
## OpenAPI Meta Verileri - Dokümantasyon
## OpenAPI Meta Verileri - Dokümantasyon { #openapi-metadata-docs }
OpenAPI şemanıza lisans, sürüm, iletişim vb. meta veriler eklemek için, [Tutorial - Metadata and Docs URLs](../tutorial/metadata.md){.internal-link target=_blank} sayfasını okuyun.
OpenAPI şemanıza lisans, sürüm, iletişim vb. meta veriler dahil eklemek için, [Tutorial - Metadata and Docs URLs](../tutorial/metadata.md){.internal-link target=_blank} dokümantasyonunu okuyun.
## OpenAPI Bağlantı Özelleştirme
## OpenAPI Özel URL { #openapi-custom-url }
OpenAPI bağlantısını özelleştirmek (veya kaldırmak) için, [Tutorial - Metadata and Docs URLs](../tutorial/metadata.md#openapi-url){.internal-link target=_blank} sayfasını okuyun.
OpenAPI URL'sini özelleştirmek (veya kaldırmak) için, [Tutorial - Metadata and Docs URLs](../tutorial/metadata.md#openapi-url){.internal-link target=_blank} dokümantasyonunu okuyun.
Dokümantasyonu arayüzünde kullanılan bağlantıları güncellemek için, [Tutorial - Metadata and Docs URLs](../tutorial/metadata.md#docs-urls){.internal-link target=_blank} sayfasını okuyun.
Otomatik oluşturulan dokümantasyon kullanıcı arayüzleri için kullanılan URL'leri güncellemek için, [Tutorial - Metadata and Docs URLs](../tutorial/metadata.md#docs-urls){.internal-link target=_blank} dokümantasyonunu okuyun.
Burada çeşitli konular hakkında farklı tarifler veya "nasıl yapılır" kılavuzları yer alıyor.
Burada **çeşitli konular** hakkında farklı tarifler veya "nasıl yapılır" kılavuzları göreceksiniz.
Bu fikirlerin büyük bir kısmı aşağı yukarı **bağımsız** olacaktır, çoğu durumda bunları sadece **projenize** hitap ediyorsa incelemelisiniz.
Bu fikirlerin büyük bir kısmı aşağı yukarı **bağımsız** olacaktır, çoğu durumda bunları sadece doğrudan **projenize** uyuyorsa incelemeniz gerekir.
Projeniz için ilginç ve yararlı görünen bir şey varsa devam edin ve inceleyin, aksi halde bunları atlayabilirsiniz.
Projeniz için ilginç ve yararlı görünen bir şey varsa devam edin ve inceleyin, aksi halde muhtemelen bunları atlayabilirsiniz.
/// tip | İpucu
/// tip | İpucu
**FastAPI**'ı düzgün (ve önerilen) şekilde öğrenmek istiyorsanız [Öğretici - Kullanıcı Rehberi](../tutorial/index.md){.internal-link target=_blank}'ni bölüm bölüm okuyun.
**FastAPI**'ı yapılandırılmış bir şekilde (önerilen) **öğrenmek** istiyorsanız bunun yerine [Öğretici - Kullanıcı Rehberi](../tutorial/index.md){.internal-link target=_blank}'ni bölüm bölüm okuyun.
FastAPI, Python 'nin standart <abbrtitle="Tip Belirteçleri: Type Hints">tip belirteçleri</abbr>ne dayalı, modern ve hızlı (yüksek performanslı) API'lar oluşturmak için kullanılabilecek web framework'tür.
FastAPI, standart Python<abbrtitle="Tip Belirteçleri: Type Hints">tip belirteçleri</abbr>ne dayalı, Python ile API'lar oluşturmak için modern ve hızlı (yüksek performanslı) bir web framework'üdür.
Temel özellikleri şunlardır:
Temel özellikleri şunlardır:
* **Hızlı**: Çok yüksek performanslı, **NodeJS** ve **Go** ile eşit düzeyde (Starlette ve Pydantic sayesinde). [En hızlı Python framework'lerinden bir tanesidir](#performans).
* **Hızlı**: Çok yüksek performanslı, **NodeJS** ve **Go** ile eşit düzeyde (Starlette ve Pydantic sayesinde). [Mevcut en hızlı Python framework'lerinden biri](#performance).
* **Kodlaması Hızlı**: Geliştirme hızını yaklaşık %200 ile %300 aralığında arttırır. *
* **Kodlaması hızlı**: Özellik geliştirme hızını yaklaşık %200 ile %300 aralığında artırır. *
* **Daha az hata**: İnsan (geliştirici) kaynaklı hataları yaklaşık %40 azaltır. *
* **Daha az hata**: İnsan (geliştirici) kaynaklı hataları yaklaşık %40 azaltır. *
* **Sezgisel**: Muhteşem bir editör desteği. Her yerde <abbrtitle="Otomatik Tamamlama: auto-complete, autocompletion, IntelliSense">otomatik tamamlama</abbr>. Hata ayıklama ile daha az zaman harcayacaksınız.
* **Sezgisel**: Muhteşem bir editör desteği. Her yerde <abbrtitle="otomatik tamamlama, autocompletion, IntelliSense olarak da bilinir">Completion</abbr>. Daha az debug zamanı.
* **Kolay**: Öğrenmesi ve kullanması kolay olacak şekilde tasarlandı. Doküman okuma ile daha az zaman harcayacaksınız.
* **Kolay**: Kullanması ve öğrenmesi kolay olacak şekilde tasarlandı. Doküman okuma ile daha az zaman.
* **Kısa**: Kod tekrarı minimize edildi. Her parametre tanımlamasında birden fazla özellik ve daha az hatayla karşılaşacaksınız.
* **Kısa**: Kod tekrarını minimize eder. Her parametre tanımından birden çok özellik. Daha az hata.
* **Güçlü**: Otomatik ve etkileşimli dokümantasyon ile birlikte, kullanıma hazır kod elde edebilirsiniz.
* **Güçlü**: Production'a hazır kod elde edersiniz. Otomatik etkileşimli dokümantasyonla birlikte.
* **Standard öncelikli**: API'lar için açık standartlara dayalı (ve tamamen uyumlu);<ahref="https://github.com/OAI/OpenAPI-Specification"class="external-link"target="_blank">OpenAPI</a> (eski adıyla Swagger) ve <ahref="https://json-schema.org/"class="external-link"target="_blank">JSON Schema</a>.
* **Standardlara dayalı**: API'lar için açık standartlara dayanır (ve tamamen uyumludur):<ahref="https://github.com/OAI/OpenAPI-Specification"class="external-link"target="_blank">OpenAPI</a> (eski adıyla Swagger) ve <ahref="https://json-schema.org/"class="external-link"target="_blank">JSON Schema</a>.
<small>* ilgili kanılar, dahili geliştirme ekibinin geliştirdikleri ürünlere yaptıkları testlere dayanmaktadır.</small>
<small>* production uygulamaları geliştiren dahili bir geliştirme ekibinin yaptığı testlere dayalı tahmin.</small>
"_[...] Bugünlerde **FastAPI**'ı çok fazla kullanıyorum. [...] Aslında bunu ekibimin **Microsoft'taki Machine Learning servislerinin** tamamında kullanmayı planlıyorum. Bunlardan bazıları **Windows**'un ana ürünlerine ve**Office** ürünlerine entegre ediliyor._"
"_[...] Bugünlerde **FastAPI**'ı çok fazla kullanıyorum. [...] Aslında ekibimin **Microsoft'taki ML servislerinin** tamamı için kullanmayı planlıyorum. Bunlardan bazıları ana **Windows** ürününe ve bazı**Office** ürünlerine entegre ediliyor._"
"_**FastAPI**'ı **tahminlerimiz**'i sorgulanabilir hale getirecek bir **REST** sunucu oluşturmak için benimsedik/kullanmaya başladık._"
"_**FastAPI** kütüphanesini, **tahminler** elde etmek için sorgulanabilen bir **REST** sunucusu oluşturmak üzere benimsedik. [Ludwig için]_"
<divstyle="text-align: right; margin-right: 10%;">Piero Molino, Yaroslav Dudin, and Sai Sumanth Miryala - <strong>Uber</strong><ahref="https://eng.uber.com/ludwig-v0-2/"target="_blank"><small>(ref)</small></a></div>
<divstyle="text-align: right; margin-right: 10%;">Piero Molino, Yaroslav Dudin, and Sai Sumanth Miryala - <strong>Uber</strong><ahref="https://eng.uber.com/ludwig-v0-2/"target="_blank"><small>(ref)</small></a></div>
---
---
"_**Netflix**, **kriz yönetiminde** orkestrasyon yapabilmek için geliştirdiği yeni framework'ü **Dispatch**'in, açık kaynak sürümünü paylaşmaktan gurur duyuyor. [**FastAPI** ile yapıldı.]_"
"_**Netflix**, **kriz yönetimi** orkestrasyon framework'ümüzün açık kaynak sürümünü duyurmaktan mutluluk duyar: **Dispatch**! [**FastAPI** ile geliştirildi]_"
"_Dürüst olmak gerekirse, inşa ettiğiniz şey gerçekten sağlam ve profesyonel görünüyor. Birçok açıdan **Hug**'ın olmasını istediğim şey tam da bu - böyle bir şeyi inşa eden birini görmek gerçekten ilham verici._"
"_Dürüst olmak gerekirse, inşa ettiğiniz şey gerçekten çok sağlam ve cilalı görünüyor. Birçok açıdan, **Hug**'ın olmasını istediğim şey buydu - birinin bunu inşa ettiğini görmek gerçekten ilham verici._"
"_Eğer REST API geliştirmek için **modern bir framework** öğrenme arayışında isen, **FastAPI**'a bir göz at [...] Hızlı, kullanımı ve öğrenmesi kolay. [...]_"
"_REST API'lar oluşturmak için tek bir **modern framework** öğrenmek istiyorsanız, **FastAPI**'a göz atın [...] Hızlı, kullanımı kolay ve öğrenmesi kolay [...]_"
"_**API** servislerimizi **FastAPI**'a taşıdık [...] Sizin de beğeneceğinizi düşünüyoruz. [...]_"
"_**API**'larımız için **FastAPI**'a geçtik [...] Bence hoşunuza gidecek [...]_"
"_Python ile kullanıma hazır bir API oluşturmak isteyen herhangi biri için, **FastAPI**'ı şiddetle tavsiye ederim. **Harika tasarlanmış**, **kullanımı kolay** ve **yüksek ölçeklenebilir**, API odaklı geliştirme stratejimizin **ana bileşeni** haline geldi ve Virtual TAC Engineer gibi birçok otomasyon ve servisi yönetiyor._"
"_Production bir Python API oluşturmak isteyen herkese **FastAPI**'ı kesinlikle tavsiye ederim. **Güzel tasarlanmış**, **kullanımı basit** ve **yüksek ölçeklenebilir**; API-first geliştirme stratejimizin **kilit bir bileşeni** haline geldi ve Virtual TAC Engineer gibi birçok otomasyon ve servisi çalıştırıyor._"
2025'in sonunda yayınlanan bir <ahref="https://www.youtube.com/watch?v=mpR8ngthqiE"class="external-link"target="_blank">FastAPI mini belgeseli</a> var, çevrimiçi izleyebilirsiniz:
Eğer API yerine, terminalde kullanılmak üzere bir <abbrtitle="Komut Satırı: Command Line Interface">komut satırı uygulaması</abbr> geliştiriyorsanız <ahref="https://typer.tiangolo.com/"class="external-link"target="_blank">**Typer**</a>'a göz atabilirsiniz.
<ahref="https://www.youtube.com/watch?v=mpR8ngthqiE"target="_blank"><imgsrc="https://fastapi.tiangolo.com/img/fastapi-documentary.jpg"alt="FastAPI Mini Documentary"></a>
**Typer** kısaca FastAPI'ın küçük kardeşi. Ve hedefi komut satırı uygulamalarının **FastAPI'ı** olmak. ⌨️ 🚀
Bir web API yerine terminalde kullanılacak bir <abbrtitle="Command Line Interface">CLI</abbr> uygulaması geliştiriyorsanız, <ahref="https://typer.tiangolo.com/"class="external-link"target="_blank">**Typer**</a>'a göz atın.
* Web tarafı için <ahref="https://www.starlette.dev/"class="external-link"target="_blank">Starlette</a>.
**Typer**, FastAPI'ın küçük kardeşidir. Ve hedefi **CLI'ların FastAPI'ı** olmaktır. ⌨️ 🚀
* Data tarafı için <ahref="https://docs.pydantic.dev/"class="external-link"target="_blank">Pydantic</a>.
## Kurulum
## Gereksinimler { #requirements }
<divclass="termy">
FastAPI iki devin omuzları üstünde duruyor:
```console
$ pip install fastapi
---> 100%
* Web kısımları için <ahref="https://www.starlette.dev/"class="external-link"target="_blank">Starlette</a>.
```
* Data kısımları için <ahref="https://docs.pydantic.dev/"class="external-link"target="_blank">Pydantic</a>.
</div>
## Kurulum { #installation }
Uygulamamızı kullanılabilir hale getirmek için<ahref="http://www.uvicorn.dev"class="external-link"target="_blank">Uvicorn</a> ya da <ahref="https://github.com/pgjones/hypercorn"class="external-link"target="_blank">Hypercorn</a>gibi bir ASGI sunucusuna ihtiyacımız olacak.
Bir<ahref="https://fastapi.tiangolo.com/tr/virtual-environments/"class="external-link"target="_blank">virtual environment</a>oluşturup aktive edin ve sonra FastAPI'ı kurun:
<divclass="termy">
<divclass="termy">
```console
```console
$ pip install "uvicorn[standard]"
$ pip install "fastapi[standard]"
---> 100%
---> 100%
```
```
</div>
</div>
## Örnek
**Not**: Tüm terminallerde çalıştığından emin olmak için `"fastapi[standard]"` ifadesini tırnak içinde kullandığınızdan emin olun.
### Kodu Oluşturalım
## Örnek { #example }
* `main.py` adında bir dosya oluşturup içine şu kodu yapıştıralım:
Eğer bu konu hakkında bilginiz yoksa<ahref="https://fastapi.tiangolo.com/tr/async/#in-a-hurry"target="_blank">`async` ve `await`</a>dokümantasyonundaki _"Aceleniz mi var?"_ kısmını kontrol edebilirsiniz.
Bilmiyorsanız, dokümanlardaki<ahref="https://fastapi.tiangolo.com/tr/async/#in-a-hurry"target="_blank">`async` ve `await`</a>hakkında _"Aceleniz mi var?"_ bölümüne bakın.
</details>
</details>
### Kodu Çalıştıralım
### Çalıştıralım { #run-it }
Sunucuyu aşağıdaki komutla çalıştıralım:
Sunucuyu şu komutla çalıştırın:
<divclass="termy">
<divclass="termy">
```console
```console
$ uvicorn main:app --reload
$ fastapi dev main.py
╭────────── FastAPI CLI - Development mode ───────────╮
│ │
│ Serving at: http://127.0.0.1:8000 │
│ │
│ API docs: http://127.0.0.1:8000/docs │
│ │
│ Running in development mode, for production use: │
<summary><code>fastapi dev main.py</code> komutu hakkında...</summary>
`uvicorn main:app` komutunu şu şekilde açıklayabiliriz:
`fastapi dev` komutu `main.py` dosyanızı okur, içindeki **FastAPI** uygulamasını tespit eder ve <ahref="https://www.uvicorn.dev"class="external-link"target="_blank">Uvicorn</a> kullanarak bir sunucu başlatır.
* `main`: dosya olan `main.py` (yani Python "modülü").
Varsayılan olarak `fastapi dev`, local geliştirme için auto-reload etkin şekilde başlar.
* `app`: ise `main.py` dosyasının içerisinde `app = FastAPI()` satırında oluşturduğumuz `FastAPI` nesnesi.
* `--reload`: kod değişikliklerinin ardından sunucuyu otomatik olarak yeniden başlatır. Bu parameteyi sadece geliştirme aşamasında kullanmalıyız.
Daha fazlasını <ahref="https://fastapi.tiangolo.com/tr/fastapi-cli/"target="_blank">FastAPI CLI dokümanlarında</a> okuyabilirsiniz.
</details>
</details>
### Şimdi de Kontrol Edelim
### Kontrol Edelim { #check-it }
Tarayıcımızda şu bağlantıyı açalım<ahref="http://127.0.0.1:8000/items/5?q=somequery"class="external-link"target="_blank">http://127.0.0.1:8000/items/5?q=somequery</a>.
Tarayıcınızda şu adresi açın:<ahref="http://127.0.0.1:8000/items/5?q=somequery"class="external-link"target="_blank">http://127.0.0.1:8000/items/5?q=somequery</a>.
Aşağıdaki gibi bir JSON yanıtıyla karşılaşacağız:
Aşağıdaki gibi bir JSON response göreceksiniz:
```JSON
```JSON
{"item_id": 5, "q": "somequery"}
{"item_id": 5, "q": "somequery"}
```
```
Az önce oluşturduğumuz API:
Şöyle bir API oluşturmuş oldunuz:
* `/` ve `/items/{item_id}`<abbrtitle="Adres / Yol: Path ">_yollarına_</abbr> HTTP isteği alabilir.
* `/` ve `/items/{item_id}`_path_'lerinde HTTP request'leri alır.
* İki _yolda_`GET`<em>operasyonlarını</em> (HTTP _metodları_ olarak da bilinen) kabul ediyor.
* Her iki _path_ de`GET`<em>operasyonlarını</em> (HTTP _method_'ları olarak da bilinir) kabul eder.
* `/items/{item_id}`_yolu_`item_id` adında bir _yol parametresine_ sahip ve bu parametre `int` değer almak zorundadır.
* `/items/{item_id}`_path_'i `item_id` adında, `int` olması gereken bir _path parametresi_ne sahiptir.
* `/items/{item_id}`_yolu_`q` adında bir _yol parametresine_ sahip ve bu parametre opsiyonel olmakla birlikte, `str` değer almak zorundadır.
* `/items/{item_id}`_path_'i `q` adında opsiyonel bir `str` _query parametresi_ne sahiptir.
### Etkileşimli API Dokümantasyonu
### Etkileşimli API dokümanları { #interactive-api-docs }
Şimdi <ahref="http://127.0.0.1:8000/docs"class="external-link"target="_blank">http://127.0.0.1:8000/docs</a>bağlantısını açalım.
Şimdi <ahref="http://127.0.0.1:8000/docs"class="external-link"target="_blank">http://127.0.0.1:8000/docs</a>adresine gidin.
<ahref="https://github.com/swagger-api/swagger-ui"class="external-link"target="_blank">Swagger UI</a> tarafından sağlanan otomatik etkileşimli bir API dokümantasyonu göreceğiz:
Otomatik etkileşimli API dokümantasyonunu göreceksiniz (<ahref="https://github.com/swagger-api/swagger-ui"class="external-link"target="_blank">Swagger UI</a> tarafından sağlanır):
### Alternatif API dokümanları { #alternative-api-docs }
Şimdi <ahref="http://127.0.0.1:8000/redoc"class="external-link"target="_blank">http://127.0.0.1:8000/redoc</a>bağlantısını açalım.
Ve şimdi <ahref="http://127.0.0.1:8000/redoc"class="external-link"target="_blank">http://127.0.0.1:8000/redoc</a>adresine gidin.
<ahref="https://github.com/Rebilly/ReDoc"class="external-link"target="_blank">ReDoc</a> tarafından sağlanan otomatik dokümantasyonu göreceğiz:
Alternatif otomatik dokümantasyonu göreceksiniz (<ahref="https://github.com/Rebilly/ReDoc"class="external-link"target="_blank">ReDoc</a> tarafından sağlanır):
* Şimdi "Execute" butonuna tıklayalım, kullanıcı arayüzü API'ımız ile bağlantı kurup parametreleri gönderecek ve sonucu ekranımıza getirecek:
* Ardından "Execute" butonuna tıklayın; kullanıcı arayüzü API'ınız ile iletişim kuracak, parametreleri gönderecek, sonuçları alacak ve ekranda gösterecek:
Özetlemek gerekirse, parametrelerin, gövdenin, vb. veri tiplerini fonksiyon parametreleri olarak **bir kere** tanımlıyoruz.
Özetle, parametrelerin, body'nin, vb. tiplerini fonksiyon parametreleri olarak **bir kere** tanımlarsınız.
Bu işlemi standart modern Python tipleriyle yapıyoruz.
Bunu standart modern Python tipleriyle yaparsınız.
Yeni bir sözdizimi yapısını, bir kütüphane özel metod veya sınıfları öğrenmeye gerek yoktur.
Yeni bir sözdizimi, belirli bir kütüphanenin method'ları veya class'ları, vb. öğrenmek zorunda değilsiniz.
Hepsi sadece **Python** standartlarına dayalıdır.
Sadece standart **Python**.
Örnek olarak, `int` tanımlamak için:
Örneğin bir `int` için:
```Python
```Python
item_id: int
item_id: int
```
```
ya da daha kompleks herhangi bir python modelini tanımlayabiliriz, örneğin`Item` modeli için:
veya daha karmaşık bir`Item` modeli için:
```Python
```Python
item: Item
item: Item
```
```
...ve sadece kısa bir parametre tipi belirterek elde ettiklerimiz:
...ve bu tek tanımla şunları elde edersiniz:
* Editör desteğiyle birlikte:
* Editör desteği, şunlar dahil:
* Otomatik tamamlama.
* Completion.
* Tip kontrolü.
* Tip kontrolleri.
* Veri Doğrulama:
* Verinin doğrulanması:
* Veri geçerli değilse, otomatik olarak açıklayıcı hatalar gösterir.
* Data geçersiz olduğunda otomatik ve net hatalar.
* Çok <abbrtitle="Derin / İç içe: Nested">derin</abbr> JSON nesnelerinde bile doğrulama yapar.
* Çok derin iç içe JSON nesnelerinde bile doğrulama.
* Gelen verinin <abbrtitle="Dönüşüm: serialization, parsing, marshalling olarak da biliniyor">dönüşümünü</abbr> aşağıdaki veri tiplerini kullanarak gerçekleştirir:
* Girdi verisinin <abbrtitle="conversion - dönüşüm: serialization, parsing, marshalling olarak da bilinir">Conversion</abbr>'ı: network'ten gelen veriyi Python data ve tiplerine dönüştürme. Şuradan okuma:
* JSON.
* JSON.
* Yol parametreleri.
* Path parametreleri.
* Sorgu parametreleri.
* Query parametreleri.
* Çerezler.
* Cookie'ler.
* Headers.
* Header'lar.
* Formlar.
* Form'lar.
* Dosyalar.
* Dosyalar.
* Giden verinin <abbrtitle="Dönüşüm: serialization, parsing, marshalling olarak da biliniyor">dönüşümünü</abbr> aşağıdaki veri tiplerini kullanarak gerçekleştirir (JSON olarak):
* Çıktı verisinin <abbrtitle="conversion - dönüşüm: serialization, parsing, marshalling olarak da bilinir">Conversion</abbr>'ı: Python data ve tiplerinden network verisine dönüştürme (JSON olarak):
Daha fazal özellik içeren, daha eksiksiz bir örnek için <ahref="https://fastapi.tiangolo.com/tr/tutorial/">Öğretici - Kullanıcı Rehberi</a> sayfasını ziyaret edebilirsin.
Daha fazla özellik içeren daha eksiksiz bir örnek için <ahref="https://fastapi.tiangolo.com/tr/tutorial/">Öğretici - Kullanıcı Rehberi</a> sayfasına bakın.
* **Parameterlerin**, **headers**, **çerezler**, **form alanları** ve **dosyalar** olarak tanımlanması.
* **Parametrelerin**; **header**'lar, **cookie**'ler, **form alanları** ve **dosyalar** gibi farklı yerlerden tanımlanması.
* `maximum_length` ya da `regex` gibi **doğrulama kısıtlamalarının** nasıl yapılabileceği.
* `maximum_length`veya `regex` gibi **doğrulama kısıtlamalarını** nasıl ayarlayacağınız.
* Çok güçlü ve kullanımı kolay **<abbrtitle="Bağımlılık Enjeksiyonu: components, resources, providers, services, injectables olarak da biliniyor.">Bağımlılık Enjeksiyonu</abbr>** sistemi oluşturmayı.
* Çok güçlü ve kullanımı kolay bir **<abbrtitle="Dependency Injection - Bağımlılık Enjeksiyonu: components, resources, providers, services, injectables olarak da bilinir">Dependency Injection</abbr>** sistemi.
* Güvenlik ve kimlik doğrulama, **JWT tokenleri** ile **OAuth2** desteği, ve **HTTP Basic** doğrulaması.
* **JWT token**'ları ile **OAuth2** desteği ve **HTTP Basic**auth dahil güvenlik ve kimlik doğrulama.
* İleri seviye fakat bir o kadarda basit olan **çok derin JSON modelleri** (Pydantic sayesinde).
* **Çok derin iç içe JSON modelleri** tanımlamak için daha ileri (ama aynı derecede kolay) teknikler (Pydantic sayesinde).
* **GraphQL** entegrasyonu: <ahref="https://strawberry.rocks"class="external-link"target="_blank">Strawberry</a> ve diğer kütüphaneleri kullanarak.
* <ahref="https://strawberry.rocks"class="external-link"target="_blank">Strawberry</a> ve diğer kütüphanelerle **GraphQL** entegrasyonu.
* Diğer ekstra özellikler (Starlette sayesinde):
* Birçok ekstra özellik (Starlette sayesinde) olarak:
* **WebSocketler**
* **WebSocket**'ler
* HTTPX ve `pytest`sayesinde aşırı kolay testler.
* HTTPX ve `pytest`tabanlı son derece kolay testler
İsteğe bağlı olarak FastAPI uygulamanızı <ahref="https://fastapicloud.com"class="external-link"target="_blank">FastAPI Cloud</a>'a deploy edebilirsiniz; henüz katılmadıysanız gidip bekleme listesine katılın. 🚀
Zaten bir **FastAPI Cloud** hesabınız varsa (bekleme listesinden sizi davet ettik 😉), uygulamanızı tek bir komutla deploy edebilirsiniz.
Deploy etmeden önce giriş yaptığınızdan emin olun:
<divclass="termy">
```console
$ fastapi login
You are logged in to FastAPI Cloud 🚀
```
</div>
Ardından uygulamanızı deploy edin:
Bağımsız TechEmpower kıyaslamaları gösteriyor ki, Uvicorn ile çalıştırılan **FastAPI** uygulamaları <ahref="https://www.techempower.com/benchmarks/#section=test&runid=7464e520-0dc2-473d-bd34-dbdfd7e85911&hw=ph&test=query&l=zijzen-7"class="external-link"target="_blank">en hızlı Python framework'lerinden birisi</a>, sadece Starlette ve Uvicorn'dan yavaş, ki FastAPI bunların üzerine kurulu bir kütüphanedir.
<divclass="termy">
Daha fazla bilgi için, bu bölüme bir göz at <ahref="https://fastapi.tiangolo.com/tr/benchmarks/"class="internal-link"target="_blank">Kıyaslamalar</a>.
```console
$ fastapi deploy
## Opsiyonel Gereksinimler
Deploying to FastAPI Cloud...
Pydantic tarafında kullanılan:
✅ Deployment successful!
🐔 Ready the chicken! Your app is ready at https://myapp.fastapicloud.dev
```
</div>
Hepsi bu! Artık uygulamanıza bu URL'den erişebilirsiniz. ✨
#### FastAPI Cloud Hakkında { #about-fastapi-cloud }
**<ahref="https://fastapicloud.com"class="external-link"target="_blank">FastAPI Cloud</a>**, **FastAPI**'ın arkasındaki aynı yazar ve ekip tarafından geliştirildi.
Minimum eforla bir API'ı **geliştirme**, **deploy etme** ve **erişme** sürecini sadeleştirir.
FastAPI ile uygulama geliştirmenin aynı **developer experience**'ını, onları cloud'a **deploy etmeye** taşır. 🎉
FastAPI Cloud, *FastAPI and friends* açık kaynak projelerinin birincil sponsoru ve fon sağlayıcısıdır. ✨
#### Diğer cloud sağlayıcılarına deploy { #deploy-to-other-cloud-providers }
FastAPI açık kaynaklıdır ve standartlara dayanır. FastAPI uygulamalarını seçtiğiniz herhangi bir cloud sağlayıcısına deploy edebilirsiniz.
FastAPI uygulamalarını deploy etmek için cloud sağlayıcınızın rehberlerini takip edin. 🤓
## Performans { #performance }
Bağımsız TechEmpower kıyaslamaları, Uvicorn altında çalışan **FastAPI** uygulamalarını <ahref="https://www.techempower.com/benchmarks/#section=test&runid=7464e520-0dc2-473d-bd34-dbdfd7e85911&hw=ph&test=query&l=zijzen-7"class="external-link"target="_blank">mevcut en hızlı Python framework'lerinden biri</a> olarak gösteriyor; sadece Starlette ve Uvicorn'un (FastAPI tarafından dahili olarak kullanılan) altında. (*)
Daha iyi anlamak için <ahref="https://fastapi.tiangolo.com/tr/benchmarks/"class="internal-link"target="_blank">Kıyaslamalar</a> bölümüne bakın.
* <ahref="https://docs.pydantic.dev/latest/usage/pydantic_settings/"target="_blank"><code>pydantic-settings</code></a> - ayar yönetimi için.
* <ahref="https://docs.pydantic.dev/latest/usage/types/extra_types/extra_types/"target="_blank"><code>pydantic-extra-types</code></a> - Pydantic ile birlikte kullanılabilecek ek tipler için.
* <ahref="https://github.com/Kludex/python-multipart"target="_blank"><code>python-multipart</code></a> - `request.form()` ile form <abbrtitle="HTTP request'inden gelen string'i Python data'sına dönüştürme">"parsing"</abbr> desteği vermek istiyorsanız gereklidir.
FastAPI tarafından kullanılanlar:
* <ahref="https://www.python-httpx.org"target="_blank"><code>httpx</code></a> - Eğer `TestClient` yapısını kullanacaksanız gereklidir.
* <ahref="https://www.uvicorn.dev"target="_blank"><code>uvicorn</code></a> - uygulamanızı yükleyen ve servis eden sunucu için. Buna, yüksek performanslı servis için gereken bazı bağımlılıkları (ör. `uvloop`) içeren `uvicorn[standard]` da dahildir.
* <ahref="https://jinja.palletsprojects.com"target="_blank"><code>jinja2</code></a> - Eğer varsayılan template konfigürasyonunu kullanacaksanız gereklidir.
* `fastapi-cli[standard]` - `fastapi` komutunu sağlamak için.
* <ahref="https://github.com/Kludex/python-multipart"target="_blank"><code>python-multipart</code></a> - Eğer `request.form()` ile form <abbrtitle="HTTP isteği ile gelen string veriyi Python nesnesine çevirme.">dönüşümü</abbr> desteğini kullanacaksanız gereklidir.
* <ahref="https://pythonhosted.org/itsdangerous/"target="_blank"><code>itsdangerous</code></a> - `SessionMiddleware` desteği için gerekli.
* <ahref="https://pyyaml.org/wiki/PyYAMLDocumentation"target="_blank"><code>pyyaml</code></a> - `SchemaGenerator` desteği için gerekli (Muhtemelen FastAPI kullanırken ihtiyacınız olmaz).
Hem FastAPI hem de Starlette tarafından kullanılan:
### `standard` Bağımlılıkları Olmadan { #without-standard-dependencies }
`standard` opsiyonel bağımlılıkları dahil etmek istemiyorsanız, `pip install "fastapi[standard]"` yerine `pip install fastapi` ile kurabilirsiniz.
### `fastapi-cloud-cli` Olmadan { #without-fastapi-cloud-cli }
FastAPI'ı standard bağımlılıklarla ama `fastapi-cloud-cli` olmadan kurmak istiyorsanız, `pip install "fastapi[standard-no-fastapi-cloud-cli]"` ile kurabilirsiniz.
### Ek Opsiyonel Bağımlılıklar { #additional-optional-dependencies }
Kurmak isteyebileceğiniz bazı ek bağımlılıklar vardır.
Ek opsiyonel Pydantic bağımlılıkları:
* <ahref="https://docs.pydantic.dev/latest/usage/pydantic_settings/"target="_blank"><code>pydantic-settings</code></a> - ayar yönetimi için.
* <ahref="https://docs.pydantic.dev/latest/usage/types/extra_types/extra_types/"target="_blank"><code>pydantic-extra-types</code></a> - Pydantic ile kullanılacak ek tipler için.
* <ahref="https://www.uvicorn.dev"target="_blank"><code>uvicorn</code></a> - oluşturduğumuz uygulamayı servis edecek web sunucusu görevini üstlenir.
# Full Stack FastAPI Şablonu { #full-stack-fastapi-template }
Başlamak için bir proje oluşturucu kullanabilirsiniz, çünkü sizin için önceden yapılmış birçok başlangıç kurulumu, güvenlik, veritabanı ve temel API endpoinlerini içerir.
Şablonlar genellikle belirli bir kurulumla gelir; ancak esnek ve özelleştirilebilir olacak şekilde tasarlanır. Bu, onları projenizin gereksinimlerine göre değiştirip uyarlamanıza olanak tanır ve onları mükemmel bir başlangıç noktası yapar. 🏁
Bir proje oluşturucu, her zaman kendi ihtiyaçlarınıza göre güncellemeniz ve uyarlamanız gereken esnek bir kuruluma sahip olacaktır, ancak bu, projeniz için iyi bir başlangıç noktası olabilir.
Bu şablonu başlangıç için kullanabilirsiniz; çünkü ilk kurulumun büyük bir kısmını, güvenliği, veritabanını ve bazı API endpoint'lerini sizin için zaten hazır halde içerir.
- 🎨 frontend bileşenleri için [Tailwind CSS](https://tailwindcss.com) ve [shadcn/ui](https://ui.shadcn.com).
* **Hızlı**: **NodeJS** ve **Go** ile eşit, çok yüksek performans (Starlette ve Pydantic'e teşekkürler).
- 🤖 Otomatik oluşturulan bir frontend client.
* **Sezgisel**: Editor desteğı. <abbrtitle="auto-complete, IntelliSense gibi isimlerle de bilinir">Otomatik tamamlama</abbr>. Daha az debugging.
- 🧪 End-to-End test için [Playwright](https://playwright.dev).
* **Kolay**: Kolay öğrenip kolay kullanmak için tasarlandı. Daha az döküman okuma daha çok iş.
- 🦇 Dark mode desteği.
* **Kısa**: Minimum kod tekrarı. Her parametre bildiriminde birden çok özellik.
- 🐋 geliştirme ve production için [Docker Compose](https://www.docker.com).
* **Güçlü**: Production-ready. Otomatik interaktif dökümantasyon.
- 🔒 Varsayılan olarak güvenli parola hashing.
* **Standartlara dayalı**: API'ler için açık standartlara dayanır (ve tamamen uyumludur): <ahref="https://github.com/OAI/OpenAPI-Specification"class="external-link"target="_blank">OpenAPI</a> ve <ahref="https://json-schema.org/"class="external-link"target="_blank">JSON Şeması</a>.
- 🔑 JWT (JSON Web Token) authentication.
* <a href="https://fastapi.tiangolo.com/features/" class="external-link" target="_blank">**Birçok diger özelliği**</a> dahili otomatik doğrulama, serialization, interaktif dokümantasyon, OAuth2 JWT token ile authentication, vb.
- 📫 Email tabanlı parola kurtarma.
* **Güvenli şifreleme** .
- ✅ [Pytest](https://pytest.org) ile testler.
* **JWT token** kimlik doğrulama.
- 📞 reverse proxy / load balancer olarak [Traefik](https://traefik.io).
* **SQLAlchemy** models (Flask dan bağımsızdır. Celery worker'ları ile kullanılabilir).
- 🚢 Docker Compose kullanarak deployment talimatları; otomatik HTTPS sertifikalarını yönetmek için bir frontend Traefik proxy'sinin nasıl kurulacağı dahil.
* Kullanıcılar için temel başlangıç modeli (gerektiği gibi değiştirin ve kaldırın).
- 🏭 GitHub Actions tabanlı CI (continuous integration) ve CD (continuous deployment).
* **Alembic** migration.
* **CORS** (Cross Origin Resource Sharing).
* **Celery** worker'ları ile backend içerisinden seçilen işleri çalıştırabilirsiniz.
* **Pytest**'e dayalı, Docker ile entegre REST backend testleri ile veritabanından bağımsız olarak tam API etkileşimini test edebilirsiniz. Docker'da çalıştığı için her seferinde sıfırdan yeni bir veri deposu oluşturabilir (böylece ElasticSearch, MongoDB, CouchDB veya ne istersen kullanabilirsin ve sadece API'nin çalışıp çalışmadığını test edebilirsin).
* Atom Hydrogen veya Visual Studio Code Jupyter gibi uzantılarla uzaktan veya Docker içi geliştirme için **Jupyter Çekirdekleri** ile kolay Python entegrasyonu.
* **Vue** ile frontend:
* Vue CLI ile oluşturulmuş.
* Dahili **JWT kimlik doğrulama**.
* Dahili Login.
* Login sonrası, Kontrol paneli.
* Kullanıcı oluşturma ve düzenleme kontrol paneli
* Kendi kendine kullanıcı sürümü.
* **Vuex**.
* **Vue-router**.
* **Vuetify** güzel material design kompanentleri için.
* **TypeScript**.
* **Nginx** tabanlı Docker sunucusu (Vue-router için yapılandırılmış).
* Docker ile multi-stage yapı, böylece kodu derlemeniz, kaydetmeniz veya işlemeniz gerekmez.
* Derleme zamanında Frontend testi (devre dışı bırakılabilir).
* Mümkün olduğu kadar modüler yapılmıştır, bu nedenle kutudan çıktığı gibi çalışır, ancak Vue CLI ile yeniden oluşturabilir veya ihtiyaç duyduğunuz şekilde oluşturabilir ve istediğinizi yeniden kullanabilirsiniz.
* **PGAdmin** PostgreSQL database admin tool'u, PHPMyAdmin ve MySQL ile kolayca değiştirilebilir.
* **Flower** ile Celery job'larını monitörleme.
* **Traefik** ile backend ve frontend arasında yük dengeleme, böylece her ikisini de aynı domain altında, path ile ayrılmış, ancak farklı kapsayıcılar tarafından sunulabilirsiniz.
* Let's Encrypt **HTTPS** sertifikalarının otomatik oluşturulması dahil olmak üzere Traefik entegrasyonu.
* GitLab **CI** (sürekli entegrasyon), backend ve frontend testi dahil.
Sıfırdan bir projeye başlıyorsanız alternatiflerine bakın.
Örneğin, <ahref="https://github.com/tiangolo/full-stack-fastapi-postgresql"class="external-link"target="_blank">Full Stack FastAPI PostgreSQL</a> daha iyi bir alternatif olabilir, aktif olarak geliştiriliyor ve kullanılıyor. Ve yeni özellik ve ilerlemelere sahip.
İsterseniz Couchbase tabanlı generator'ı kullanmakta özgürsünüz, hala iyi çalışıyor olmalı ve onunla oluşturulmuş bir projeniz varsa bu da sorun değil (ve muhtemelen zaten ihtiyaçlarınıza göre güncellediniz).
Bununla ilgili daha fazla bilgiyi repo belgelerinde okuyabilirsiniz.
## Full Stack FastAPI MongoDB
... müsaitliğime ve diğer faktörlere bağlı olarak daha sonra gelebilir. 😅 🎉
Python isteğe bağlı olarak "tip belirteçlerini" destekler.
Python, isteğe bağlı "type hints" (diğer adıyla "type annotations") desteğine sahiptir.
**"Tip belirteçleri"** bir değişkenin <abbrtitle="örneğin: str, int, float, bool">tipinin</abbr> belirtilmesine olanak sağlayan özel bir sözdizimidir.
Bu **"type hints"** veya annotations, bir değişkenin <abbrtitle="for example: str, int, float, bool">type</abbr>'ını bildirmeye olanak sağlayan özel bir sözdizimidir.
Değişkenlerin tiplerini belirterek editör ve araçlardan daha fazla destek alabilirsiniz.
Değişkenleriniz için type bildirerek, editörler ve araçlar size daha iyi destek sağlayabilir.
Bu pythonda tip belirteçleri için **hızlı bir başlangıç / bilgi tazeleme** rehberidir . Bu rehber **FastAPI** kullanmak için gereken minimum konuyu kapsar ki bu da çok az bir miktardır.
Bu, Python type hints hakkında sadece **hızlı bir eğitim / bilgi tazeleme** yazısıdır. **FastAPI** ile kullanmak için gerekli olan minimum kısmı kapsar... ki bu aslında çok azdır.
**FastAPI' nin** tamamı bu tür tip belirteçleri ile donatılmıştır ve birçok avantaj sağlamaktadır.
**FastAPI** tamamen bu type hints'lere dayanır; bunlar ona pek çok avantaj ve fayda sağlar.
**FastAPI** kullanmayacak olsanız bile tür belirteçleri hakkında bilgi edinmenizde fayda var.
Ama **FastAPI**'yi hiç kullanmasanız bile, bunlar hakkında biraz öğrenmek size fayda sağlar.
/// note | Not
/// note | Not
Python uzmanıysanız ve tip belirteçleri ilgili her şeyi zaten biliyorsanız, sonraki bölüme geçin.
Python uzmanıysanız ve type hints ile ilgili her şeyi zaten biliyorsanız, sonraki bölüme geçin.
Ardından, programcıların en iyi arkadaşı olan otomatik tamamlama ile denediniz.
Sonra, programcının eski dostu editör otomatik tamamlama ile denersiniz.
'first_name', ardından bir nokta ('.') yazıp otomatik tamamlamayı tetiklemek için 'Ctrl+Space' tuşlarına bastınız.
Fonksiyonun ilk parametresi olan `first_name`'i yazarsınız, sonra bir nokta (`.`) koyarsınız ve ardından tamamlamayı tetiklemek için `Ctrl+Space`'e basarsınız.
Ancak, ne yazık ki, yararlı hiçbir şey elde edemediniz:
Ama maalesef, işe yarar hiçbir şey gelmez:
<imgsrc="/img/python-types/image01.png">
<imgsrc="/img/python-types/image01.png">
### Tipleri ekle
### Tipleri ekleyin { #add-types }
Önceki sürümden sadece bir satırı değiştirelim.
Önceki sürümden tek bir satırı değiştirelim.
Tam olarak bu parçayı, işlevin parametrelerini değiştireceğiz:
### Tip parametreleri ile Generic tipler { #generic-types-with-type-parameters }
`dict`, `list`, `set` ve `tuple` gibi, başka değerleri içerebilen bazı veri yapıları vardır. Ve iç değerlerin de kendi tipi olabilir.
### Tip parametreleri ile Generic tipler
İç tipleri olan bu tiplere "**generic**" tipler denir. Ve bunları, iç tipleriyle beraber bile bildirmek mümkündür.
"dict", "list", "set" ve "tuple" gibi diğer değerleri içerebilen bazı veri yapıları vardır. Ve dahili değerlerinin de tip belirtecleri olabilir.
Bu tipleri ve iç tipleri bildirmek için standart Python modülü `typing`'i kullanabilirsiniz. Bu modül özellikle bu type hints'leri desteklemek için vardır.
Bu tipleri ve dahili tpileri bildirmek için standart Python modülünü "typing" kullanabilirsiniz.
#### Python'un daha yeni sürümleri { #newer-versions-of-python }
Bu tür tip belirteçlerini desteklemek için özel olarak mevcuttur.
`typing` kullanarak yapılan sözdizimi, Python 3.6'dan en yeni sürümlere kadar (Python 3.9, Python 3.10, vb. dahil) tüm sürümlerle **uyumludur**.
#### `List`
Python geliştikçe, **daha yeni sürümler** bu type annotations için daha iyi destekle gelir ve çoğu durumda type annotations bildirmek için `typing` modülünü import edip kullanmanıza bile gerek kalmaz.
Örneğin `str` değerlerden oluşan bir `list` tanımlayalım.
Projeniz için Python'un daha yeni bir sürümünü seçebiliyorsanız, bu ek sadelikten faydalanabilirsiniz.
From `typing`, import `List` (büyük harf olan `L` ile):
Tüm dokümanlarda Python'un her sürümüyle uyumlu örnekler vardır (fark olduğunda).
Örneğin "**Python 3.6+**" Python 3.6 veya üstüyle (3.7, 3.8, 3.9, 3.10, vb. dahil) uyumlu demektir. Ve "**Python 3.9+**" Python 3.9 veya üstüyle (3.10, vb. dahil) uyumlu demektir.
Python'un **en son sürümlerini** kullanabiliyorsanız, en son sürüme ait örnekleri kullanın; bunlar **en iyi ve en basit sözdizimine** sahip olacaktır, örneğin "**Python 3.10+**".
Değişkenin tipini yine iki nokta üstüste (`:`) ile belirleyin.
#### List { #list }
tip olarak `List` kullanın.
Örneğin, `str` değerlerinden oluşan bir `list` olan bir değişken tanımlayalım.
Liste, bazı dahili tipleri içeren bir tür olduğundan, bunları köşeli parantez içine alırsınız:
Değişkeni, aynı iki nokta üst üste (`:`) sözdizimi ile bildirin.
* Bu `dict`'in key'leri `str` tipindedir (diyelim ki her item'ın adı).
* Bu `dict`'in value'ları `float` tipindedir (diyelim ki her item'ın fiyatı).
Bu şu anlama gelir:
#### Union { #union }
Bir değişkenin **birden fazla tipten** herhangi biri olabileceğini bildirebilirsiniz, örneğin bir `int` veya bir `str`.
Python 3.6 ve üstünde (Python 3.10 dahil) `typing`'den `Union` tipini kullanabilir ve köşeli parantez içine kabul edilecek olası tipleri koyabilirsiniz.
Python 3.10'da ayrıca, olası tipleri <abbrtitle='also called "bitwise or operator", but that meaning is not relevant here'>vertical bar (`|`)</abbr> ile ayırabileceğiniz **yeni bir sözdizimi** de vardır.
Sadece `str` yerine `Optional[str]` kullanmak, bir değerin her zaman `str` olduğunu varsayabileceğiniz ama aslında `None` da olabileceği durumlarda editörün hataları tespit etmenize yardımcı olmasını sağlar.
`Optional[Something]` aslında `Union[Something, None]` için bir kısayoldur, eşdeğerdirler.
Bu aynı zamanda Python 3.10'da `Something | None` kullanabileceğiniz anlamına gelir:
#### `Union` veya `Optional` kullanmak { #using-union-or-optional }
Python sürümünüz 3.10'un altındaysa, benim oldukça **öznel** bakış açıma göre bir ipucu:
* 🚨 `Optional[SomeType]` kullanmaktan kaçının
* Bunun yerine ✨ **`Union[SomeType, None]` kullanın** ✨.
İkisi de eşdeğerdir ve altta aynı şeydir, ama `Optional` yerine `Union` önermemin nedeni şu: "**optional**" kelimesi, değerin isteğe bağlı olduğunu ima ediyor gibi görünebilir; oysa aslında anlamı " `None` olabilir"dir, optional olmasa ve hâlâ gerekli olsa bile.
Bence `Union[SomeType, None]` ne demek istediğini daha açık biçimde ifade eder.
Bu sadece kelimeler ve isimlerle ilgili. Ama bu kelimeler, sizin ve takım arkadaşlarınızın kod hakkında nasıl düşündüğünü etkileyebilir.
`name` parametresi `Optional[str]` olarak tanımlanmış, ama **optional değil**, parametre olmadan fonksiyonu çağırmazsınız:
```Python
say_hi() # Oh, no, this throws an error! 😱
```
`name` parametresi hâlâ **gerekli** ( *optional* değil) çünkü varsayılan değeri yok. Yine de `name`, değer olarak `None` kabul eder:
```Python
say_hi(name=None) # This works, None is valid 🎉
```
```
`str` yerine `Optional[str]` kullanmak editorün bu değerin her zaman `str` tipinde değil bazen `None` tipinde de olabileceğini belirtir ve hataları tespit etmemizde yardımcı olur.
İyi haber şu ki, Python 3.10'a geçtiğinizde bununla uğraşmanıza gerek kalmayacak, çünkü tip union'larını tanımlamak için basitçe `|` kullanabileceksiniz:
Ve artık `Optional` ve `Union` gibi isimlerle uğraşmanıza gerek kalmayacak. 😎
#### Generic tipler { #generic-types }
Köşeli parantez içinde type parameter alan bu tiplere **Generic types** veya **Generics** denir, örneğin:
//// tab | Python 3.10+
#### Generic tipler
Generic olarak aynı builtin tipleri (köşeli parantez ve içinde tiplerle) kullanabilirsiniz:
Köşeli parantez içinde tip parametreleri alan bu türler, örneğin:
* `list`
* `tuple`
* `set`
* `dict`
* `List`
Ve önceki Python sürümlerinde olduğu gibi, `typing` modülünden:
* `Tuple`
* `Set`
* `Union`
* `Dict`
* `Optional`
* `Optional`
* ...and others.
* ...and others.
**Generic types** yada **Generics** olarak adlandırılır.
Python 3.10'da, generic olan `Union` ve `Optional` kullanmaya alternatif olarak, <abbrtitle='also called "bitwise or operator", but that meaning is not relevant here'>vertical bar (`|`)</abbr> ile tip union'ları bildirebilirsiniz; bu çok daha iyi ve daha basittir.
////
//// tab | Python 3.9+
Generic olarak aynı builtin tipleri (köşeli parantez ve içinde tiplerle) kullanabilirsiniz:
* `list`
* `tuple`
* `set`
* `dict`
### Tip olarak Sınıflar
Ve `typing` modülündeki generics'ler:
Bir değişkenin tipini bir sınıf ile bildirebilirsiniz.
* `Union`
* `Optional`
* ...and others.
////
Diyelim ki `name` değerine sahip `Person` sınıfınız var:
Bunun "`one_person`, `Person` sınıfının bir **instance**'ıdır" anlamına geldiğine dikkat edin.
<ahref="https://docs.pydantic.dev/"class="external-link"target="_blank">Pydantic</a> veri doğrulaması yapmak için bir Python kütüphanesidir.
"`one_person`, `Person` adlı **class**'tır" anlamına gelmez.
Verilerin "biçimini" niteliklere sahip sınıflar olarak düzenlersiniz.
## Pydantic modelleri { #pydantic-models }
Ve her niteliğin bir türü vardır.
<ahref="https://docs.pydantic.dev/"class="external-link"target="_blank">Pydantic</a>, veri doğrulaması yapmak için bir Python kütüphanesidir.
Sınıfın bazı değerlerle bir örneğini oluşturursunuz ve değerleri doğrular, bunları uygun türe dönüştürür ve size tüm verileri içeren bir nesne verir.
Verinin "shape"'ini (şeklini) attribute'lara sahip sınıflar olarak bildirirsiniz.
Ve ortaya çıkan nesne üzerindeki bütün editör desteğini alırsınız.
Ve her attribute'un bir tipi vardır.
Resmi Pydantic dokümanlarından alınmıştır:
Sonra bu sınıfın bir instance'ını bazı değerlerle oluşturursunuz; bu değerleri doğrular, (gerekiyorsa) uygun tipe dönüştürür ve size tüm verileri içeren bir nesne verir.
{* ../../docs_src/python_types/tutorial011.py *}
Ve ortaya çıkan o nesne ile tüm editör desteğini alırsınız.
Daha fazla şey öğrenmek için <ahref="https://docs.pydantic.dev/"class="external-link"target="_blank">Pydantic'i takip edin</a>.
/// info | Bilgi
<ahref="https://docs.pydantic.dev/"class="external-link"target="_blank">Pydantic hakkında daha fazlasını öğrenmek için dokümanlarına göz atın</a>.
///
///
**FastAPI** tamamen Pydantic'e dayanmaktadır.
**FastAPI** tamamen Pydantic'e dayanır.
Bunların hepsini pratikte çok daha fazla [Tutorial - User Guide](tutorial/index.md){.internal-link target=_blank} içinde göreceksiniz.
/// tip | İpucu
Pydantic, varsayılan değer olmadan `Optional` veya `Union[Something, None]` kullandığınızda özel bir davranışa sahiptir; bununla ilgili daha fazlasını Pydantic dokümanlarında <ahref="https://docs.pydantic.dev/2.3/usage/models/#required-fields"class="external-link"target="_blank">Required Optional fields</a> bölümünde okuyabilirsiniz.
///
## Metadata Annotations ile Type Hints { #type-hints-with-metadata-annotations }
Python ayrıca `Annotated` kullanarak bu type hints'lerin içine **ek <abbr title="Data about the data, in this case, information about the type, e.g. a description.">metadata</abbr>** koymaya izin veren bir özelliğe de sahiptir.
Daha fazlasini görmek için [Tutorial - User Guide](tutorial/index.md){.internal-link target=_blank}.
Python 3.9'dan beri `Annotated`, standart kütüphanenin bir parçasıdır, dolayısıyla onu `typing`'den import edebilirsiniz.
Python'un kendisi bu `Annotated` ile bir şey yapmaz. Ve editörler ile diğer araçlar için tip hâlâ `str`'dir.
Ama `Annotated` içindeki bu alanı, uygulamanızın nasıl davranmasını istediğinize dair **FastAPI**'ye ek metadata sağlamak için kullanabilirsiniz.
Hatırlanması gereken önemli şey şu: `Annotated`'a verdiğiniz **ilk *type parameter***, **asıl tip**tir. Geri kalanı ise diğer araçlar için metadata'dır.
Şimdilik sadece `Annotated`'ın var olduğunu ve bunun standart Python olduğunu bilmeniz yeterli. 😎
İleride ne kadar **güçlü** olabileceğini göreceksiniz.
/// tip | İpucu
Bunun **standart Python** olması, editörünüzde hâlâ mümkün olan **en iyi geliştirici deneyimini** alacağınız anlamına gelir; kodunuzu analiz etmek ve refactor etmek için kullandığınız araçlarla vb. ✨
Ayrıca kodunuzun, diğer birçok Python aracı ve kütüphanesiyle çok uyumlu olacağı anlamına da gelir. 🚀
///
## **FastAPI** tip belirteçleri
## **FastAPI**'de type hints { #type-hints-in-fastapi }
**FastAPI** birkaç şey yapmak için bu tür tip belirteçlerinden faydalanır.
**FastAPI**, birkaç şey yapmak için bu type hints'lerden faydalanır.
**FastAPI** ile parametre tiplerini bildirirsiniz ve şunları elde edersiniz:
**FastAPI** ile type hints kullanarak parametreleri bildirirsiniz ve şunları elde edersiniz:
* **Editor desteği**.
* **Editör desteği**.
* **Tip kontrolü**.
* **Tip kontrolleri**.
...ve **FastAPI** aynı belirteçleri şunlar için de kullanıyor:
...ve **FastAPI** aynı bildirimleri şunlar için de kullanır:
* **Gereksinimleri tanımlama**: request path parameters, query parameters, headers, bodies, dependencies, ve benzeri gereksinimlerden
* **Verileri çevirme**: Gönderilen veri tipinden istenilen veri tipine çevirme.
* **Veriyi dönüştürmek**: request'ten gereken tipe.
* **Verileri doğrulama**: Her gönderilen verinin:
* **Veriyi doğrulamak**: her request'ten gelen veriyi:
* doğrulanması ve geçersiz olduğunda **otomatik hata** oluşturma.
* Veri geçersiz olduğunda client'a döndürülen **otomatik hatalar** üretmek.
* OpenAPI kullanarak apinizi **Belgeleyin** :
* OpenAPI kullanarak API'yi **belgelemek**:
* bu daha sonra otomatik etkileşimli dokümantasyon kullanıcı arayüzü tarafından kullanılır.
* bunun daha sonra otomatik etkileşimli dokümantasyon kullanıcı arayüzleri tarafından kullanılması.
Bütün bunlar kulağa soyut gelebilir. Merak etme. Tüm bunları çalışırken göreceksiniz. [Tutorial - User Guide](tutorial/index.md){.internal-link target=_blank}.
Bunların hepsi soyut gelebilir. Merak etmeyin. Bunların hepsini çalışırken [Tutorial - User Guide](tutorial/index.md){.internal-link target=_blank} içinde göreceksiniz.
Önemli olan, standart Python türlerini tek bir yerde kullanarak (daha fazla sınıf, dekoratör vb. eklemek yerine), **FastAPI**'nin bizim için işi yapmasını sağlamak.
Önemli olan, standart Python tiplerini tek bir yerde kullanarak (daha fazla sınıf, decorator vb. eklemek yerine), **FastAPI**'nin sizin için işin büyük kısmını yapacak olmasıdır.
/// info
/// info | Bilgi
Tüm öğreticiyi zaten okuduysanız ve türler hakkında daha fazla bilgi için geri döndüyseniz, iyi bir kaynak:<ahref="https://mypy.readthedocs.io/en/latest/cheat_sheet_py3.html"class="external-link"target="_blank"> the "cheat sheet" from `mypy`</a>.
Tüm tutorial'ı zaten baştan sona geçtiyseniz ve tipler hakkında daha fazlasını görmek için geri döndüyseniz, iyi bir kaynak: <ahref="https://mypy.readthedocs.io/en/latest/cheat_sheet_py3.html"class="external-link"target="_blank">`mypy`'nin "cheat sheet"i</a>.
`Cookie` sınıfı `Path` ve `Query` sınıflarının kardeşidir. Diğerleri gibi `Param` sınıfını miras alan bir sınıftır.
`Cookie`, `Path` ve `Query`'nin "kardeş" sınıfıdır. O da aynı ortak `Param` sınıfından miras alır.
Ancak `fastapi`'dan projenize dahil ettiğiniz`Query`, `Path`, `Cookie` ve diğerleri aslında özel sınıflar döndüren birer fonksiyondur.
Ama `fastapi`'dan`Query`, `Path`, `Cookie` ve diğerlerini import ettiğinizde, bunların aslında özel sınıflar döndüren fonksiyonlar olduğunu unutmayın.
///
///
/// info | Bilgi
/// info | Bilgi
Çerez tanımlamak için `Cookie` sınıfını kullanmanız gerekmektedir, aksi taktirde parametreler sorgu parametreleri olarak yorumlanır.
Cookie'leri tanımlamak için `Cookie` kullanmanız gerekir, aksi takdirde parametreler query parametreleri olarak yorumlanır.
///
///
## Özet
/// info | Bilgi
**Tarayıcılar Cookie'leri** arka planda ve özel şekillerde işlediği için **JavaScript**'in onlara dokunmasına kolayca izin **vermezler**.
`/docs` altındaki **API dokümantasyonu arayüzü**ne giderseniz, *path operation*'larınız için Cookie'lerin **dokümantasyonunu** görebilirsiniz.
Ama **veriyi doldurup** "Execute"'a tıklasanız bile, dokümantasyon arayüzü **JavaScript** ile çalıştığı için Cookie'ler gönderilmez ve herhangi bir değer yazmamışsınız gibi bir **hata** mesajı görürsünüz.
///
## Özet { #recap }
Çerez tanımlamalarını `Cookie` sınıfını kullanarak `Query` ve `Path` tanımlar gibi tanımlayın.
Cookie'leri `Cookie` ile, `Query` ve `Path` ile aynı ortak kalıbı kullanarak tanımlayın.
* `app`: ise `main.py` dosyasının içerisinde `app = FastAPI()` satırında oluşturduğumuz `FastAPI` nesnesi.
* `--reload`: kod değişikliklerinin ardından sunucuyu otomatik olarak yeniden başlatır. Bu parameteyi sadece geliştirme aşamasında kullanmalıyız.
///
<spanstyle="background-color:#007166"><fontcolor="#D3D7CF"> app </font></span> Using import string: <fontcolor="#3465A4">main:app</font>
<spanstyle="background-color:#007166"><fontcolor="#D3D7CF"> server </font></span> Server started at <fontcolor="#729FCF"><ustyle="text-decoration-style:solid">http://127.0.0.1:8000</u></font>
<spanstyle="background-color:#007166"><fontcolor="#D3D7CF"> server </font></span> Documentation at <fontcolor="#729FCF"><ustyle="text-decoration-style:solid">http://127.0.0.1:8000/docs</u></font>
<spanstyle="background-color:#007166"><fontcolor="#D3D7CF"> tip </font></span> Running in development mode, for production use:
<b>fastapi run</b>
Çıktı olarak şöyle bir satır ile karşılaşacaksınız:
Logs:
<spanstyle="background-color:#007166"><fontcolor="#D3D7CF"> INFO </font></span> Will watch for changes in these directories:
<spanstyle="background-color:#007166"><fontcolor="#D3D7CF"> INFO </font></span> Uvicorn running on <fontcolor="#729FCF"><ustyle="text-decoration-style:solid">http://127.0.0.1:8000</u></font><b>(</b>Press CTRL+C
to quit<b>)</b>
<spanstyle="background-color:#007166"><fontcolor="#D3D7CF"> INFO </font></span> Started reloader process <b>[</b><fontcolor="#34E2E2"><b>383138</b></font><b>]</b> using WatchFiles
<spanstyle="background-color:#007166"><fontcolor="#D3D7CF"> INFO </font></span> Started server process <b>[</b><fontcolor="#34E2E2"><b>383153</b></font><b>]</b>
<spanstyle="background-color:#007166"><fontcolor="#D3D7CF"> INFO </font></span> Waiting for application startup.
<spanstyle="background-color:#007166"><fontcolor="#D3D7CF"> INFO </font></span> Application startup complete.
```
</div>
Çıktı olarak buna benzer bir satır göreceksiniz:
```hl_lines="4"
```hl_lines="4"
INFO: Uvicorn running on http://127.0.0.1:8000 (Press CTRL+C to quit)
INFO: Uvicorn running on http://127.0.0.1:8000 (Press CTRL+C to quit)
```
```
Bu satır, yerel makinenizde uygulamanızın çalıştığı bağlantıyı gösterir.
Bu satır, yerel makinenizde uygulamanızın sunulduğu URL'yi gösterir.
### Etkileşimli API Dokümantasyonu { #interactive-api-docs }
Şimdi <ahref="http://127.0.0.1:8000/docs"class="external-link"target="_blank">http://127.0.0.1:8000/docs</a>bağlantısını açalım.
Şimdi <ahref="http://127.0.0.1:8000/docs"class="external-link"target="_blank">http://127.0.0.1:8000/docs</a>adresine gidin.
<ahref="https://github.com/swagger-api/swagger-ui"class="external-link"target="_blank">Swagger UI</a> tarafından sağlanan otomatik etkileşimli bir API dokümantasyonu göreceğiz:
Otomatik etkileşimli API dokümantasyonunu göreceksiniz (<ahref="https://github.com/swagger-api/swagger-ui"class="external-link"target="_blank">Swagger UI</a> tarafından sağlanır):
Ve şimdi,<ahref="http://127.0.0.1:8000/redoc"class="external-link"target="_blank">http://127.0.0.1:8000/redoc</a>adresine gidin.
<ahref="https://github.com/Rebilly/ReDoc"class="external-link"target="_blank">ReDoc</a> tarafından sağlanan otomatik dokümantasyonu göreceğiz:
Alternatif otomatik dokümantasyonu göreceksiniz (<ahref="https://github.com/Rebilly/ReDoc"class="external-link"target="_blank">ReDoc</a> tarafından sağlanır):
**FastAPI**, **OpenAPI** standardını kullanarak tüm API'ınızın tamamını tanımlayan bir "şema" oluşturur.
**FastAPI**, API'leri tanımlamak için **OpenAPI** standardını kullanarak tüm API'nızla birlikte bir "şema" üretir.
#### "Şema"
#### "Şema" { #schema }
"Şema", bir şeyin tanımı veya açıklamasıdır. Geliştirilen koddan ziyade soyut bir açıklamadır.
Bir "şema", bir şeyin tanımı veya açıklamasıdır. Bunu uygulayan kod değil, yalnızca soyut bir açıklamadır.
#### API "Şeması"
#### API "şeması" { #api-schema }
Bu durumda, <ahref="https://github.com/OAI/OpenAPI-Specification"class="external-link"target="_blank">OpenAPI</a>, API şemasını nasıl tanımlayacağınızı belirten bir şartnamedir.
Bu durumda, <ahref="https://github.com/OAI/OpenAPI-Specification"class="external-link"target="_blank">OpenAPI</a>, API'nızın şemasını nasıl tanımlayacağınızı belirleyen bir şartnamedir.
Bu şema tanımı, API yollarınızla birlikte yollarınızın aldığı olası parametreler gibi tanımlamaları içerir.
Bu şema tanımı, API path'lerinizi, aldıkları olası parametreleri vb. içerir.
#### Veri "Şeması"
#### Veri "şeması" { #data-schema }
"Şema" terimi, JSON içeriği gibi bazı verilerin şeklini de ifade edebilir.
"Şema" terimi, JSON içeriği gibi bazı verilerin şeklini de ifade edebilir.
Bu durumda, JSON özellikleri ve sahip oldukları veri türleri gibi anlamlarına gelir.
Bu durumda, JSON özniteliklerini ve sahip oldukları veri türlerini vb. ifade eder.
#### OpenAPI ve JSON Şema
#### OpenAPI ve JSON Schema { #openapi-and-json-schema }
OpenAPI, API'niz için bir API şeması tanımlar. Ve bu şema, JSON veri şemaları standardı olan **JSON Şema** kullanılarak API'niz tarafından gönderilen ve alınan verilerin tanımlarını (veya "şemalarını") içerir.
OpenAPI, API'nız için bir API şeması tanımlar. Ve bu şema, JSON veri şemaları standardı olan **JSON Schema** kullanılarak API'nız tarafından gönderilen ve alınan verilerin tanımlarını (veya "şemalarını") içerir.
#### `openapi.json` Dosyasına Göz At
#### `openapi.json`'ı Kontrol Edin { #check-the-openapi-json }
Ham OpenAPI şemasının nasıl göründüğünü merak ediyorsanız, FastAPI otomatik olarak tüm API'ınızın tanımlamalarını içeren bir JSON (şeması) oluşturur.
Ham OpenAPI şemasının nasıl göründüğünü merak ediyorsanız, FastAPI otomatik olarak tüm API'nızın açıklamalarını içeren bir JSON (şeması) üretir.
Bu şemayı direkt olarak<ahref="http://127.0.0.1:8000/openapi.json"class="external-link"target="_blank">http://127.0.0.1:8000/openapi.json</a> bağlantısından görüntüleyebilirsiniz.
Bunu doğrudan şurada görebilirsiniz:<ahref="http://127.0.0.1:8000/openapi.json"class="external-link"target="_blank">http://127.0.0.1:8000/openapi.json</a>.
Aşağıdaki gibi başlayan bir JSON ile karşılaşacaksınız:
Şunun gibi başlayan bir JSON gösterecek:
```JSON
```JSON
{
{
@ -119,79 +135,87 @@ Aşağıdaki gibi başlayan bir JSON ile karşılaşacaksınız:
...
...
```
```
#### OpenAPI Ne İşe Yarar?
#### OpenAPI Ne İçin Kullanılır { #what-is-openapi-for }
OpenAPI şeması, FastAPI projesinde bulunan iki etkileşimli dokümantasyon sistemine güç veren şeydir.
OpenAPI'ya dayalı düzinelerce alternatif etkileşimli dokümantasyon aracı mevcuttur. **FastAPI** ile oluşturulmuş uygulamanıza bu alternatiflerden herhangi birini kolayca ekleyebilirsiniz.
OpenAPI şeması, dahil gelen iki etkileşimli dokümantasyon sistemine güç veren şeydir.
Ayrıca, API'ınızla iletişim kuracak önyüz, mobil veya IoT uygulamaları gibi istemciler için otomatik olarak kod oluşturabilirsiniz.
Ve OpenAPI tabanlı düzinelerce alternatif vardır. **FastAPI** ile oluşturulmuş uygulamanıza bu alternatiflerden herhangi birini kolayca ekleyebilirsiniz.
## Adım Adım Özetleyelim
Ayrıca, API'nızla iletişim kuran istemciler için otomatik olarak kod üretmek için de kullanabilirsiniz. Örneğin, frontend, mobil veya IoT uygulamaları.
İsterseniz FastAPI uygulamanızı <ahref="https://fastapicloud.com"class="external-link"target="_blank">FastAPI Cloud</a>'a deploy edebilirsiniz, henüz yapmadıysanız gidip bekleme listesine katılın. 🚀
`FastAPI`, API'niz için tüm işlevselliği sağlayan bir Python sınıfıdır.
Zaten bir **FastAPI Cloud** hesabınız varsa (sizi bekleme listesinden davet ettik 😉), uygulamanızı tek bir komutla deploy edebilirsiniz.
/// note | Teknik Detaylar
Deploy etmeden önce, giriş yaptığınızdan emin olun:
`FastAPI` doğrudan `Starlette`'i miras alan bir sınıftır.
<ahref="https://www.starlette.dev/"class="external-link"target="_blank">Starlette</a>'in tüm işlevselliğini `FastAPI` ile de kullanabilirsiniz.
Bir `dict`, `list`, `str`, `int` gibi tekil değerler döndürebilirsiniz.
Ayrıca Pydantic modelleri de döndürebilirsiniz (bunun hakkında daha sonra daha fazlasını göreceksiniz).
Otomatik olarak JSON'a dönüştürülecek (ORM'ler vb. dahil) başka birçok nesne ve model vardır. En beğendiklerinizi kullanmayı deneyin, büyük ihtimalle zaten destekleniyordur.
### Adım 6: Deploy edin { #step-6-deploy-it }
Uygulamanızı tek bir komutla **<ahref="https://fastapicloud.com"class="external-link"target="_blank">FastAPI Cloud</a>**'a deploy edin: `fastapi deploy`. 🎉
#### FastAPI Cloud Hakkında { #about-fastapi-cloud }
**<ahref="https://fastapicloud.com"class="external-link"target="_blank">FastAPI Cloud</a>**, **FastAPI**'ın arkasındaki aynı yazar ve ekip tarafından geliştirilmiştir.
Minimum eforla bir API'yi **oluşturma**, **deploy etme** ve **erişme** sürecini kolaylaştırır.
FastAPI ile uygulama geliştirmenin aynı **developer experience**'ını, bunları buluta **deploy etmeye** de taşır. 🎉
FastAPI Cloud, *FastAPI and friends* açık kaynak projelerinin birincil sponsoru ve finansman sağlayıcısıdır. ✨
Bir `dict`, `list` veya `str`, `int` gibi tekil değerler döndürebilirsiniz.
#### Diğer cloud sağlayıcılarına deploy edin { #deploy-to-other-cloud-providers }
Ayrıca, Pydantic modelleri de döndürebilirsiniz (bu konu ileriki aşamalarda irdelenecektir).
FastAPI açık kaynaklıdır ve standartlara dayanır. FastAPI uygulamalarını seçtiğiniz herhangi bir cloud sağlayıcısına deploy edebilirsiniz.
Otomatik olarak JSON'a dönüştürülecek (ORM'ler vb. dahil) başka birçok nesne ve model vardır. En beğendiklerinizi kullanmayı deneyin, yüksek ihtimalle destekleniyordur.
FastAPI uygulamalarını onlarla deploy etmek için cloud sağlayıcınızın kılavuzlarını takip edin. 🤓
## Özet
## Özet { #recap }
* `FastAPI`'yı projemize dahil ettik.
* `FastAPI`'yı import edin.
* Bir `app` örneği oluşturduk.
* Bir `app` instance'ı oluşturun.
* Bir **yol operasyonu dekoratörü** (`@app.get("/")` gibi) yazdık.
* `@app.get("/")` gibi decorator'ları kullanarak bir **path operation decorator** yazın.
* Bir **yol operasyonu fonksiyonu** (`def root(): ...` gibi) yazdık.
* Bir **path operation function** tanımlayın; örneğin, `def root(): ...`.
* Geliştirme sunucumuzu (`uvicorn main:app --reload` gibi) çalıştırdık.
* `fastapi dev` komutunu kullanarak geliştirme sunucusunu çalıştırın.
* Opsiyonel olarak `fastapi deploy` ile uygulamanızı deploy edin.
Yol "parametrelerini" veya "değişkenlerini" Python <abbrtitle="String Biçimleme: Format String">string biçimlemede</abbr> kullanılan sözdizimi ile tanımlayabilirsiniz.
Yol "parametrelerini" veya "değişkenlerini" Python <abbrtitle="String Biçimleme: Format String">string biçimlemede</abbr> kullanılan sözdizimi ile tanımlayabilirsiniz.
Bu durumda, `item_id` bir `int` olarak tanımlanacaktır.
Bu durumda, `item_id` bir `int` olarak tanımlanacaktır.
@ -26,7 +26,7 @@ Bu sayede, fonksiyon içerisinde hata denetimi, kod tamamlama gibi konularda edi
///
///
## Veri <abbrtitle="Dönüşüm: serialization, parsing ve marshalling olarak da biliniyor">Dönüşümü</abbr>
## Veri <abbrtitle="ayrıca şu isimlerle de bilinir: serialization, parsing, marshalling">dönüşümü</abbr> { #data-conversion }
Eğer bu örneği çalıştırıp tarayıcınızda <ahref="http://127.0.0.1:8000/items/3"class="external-link"target="_blank">http://127.0.0.1:8000/items/3</a> sayfasını açarsanız, şöyle bir yanıt ile karşılaşırsınız:
Eğer bu örneği çalıştırıp tarayıcınızda <ahref="http://127.0.0.1:8000/items/3"class="external-link"target="_blank">http://127.0.0.1:8000/items/3</a> sayfasını açarsanız, şöyle bir yanıt ile karşılaşırsınız:
@ -38,11 +38,11 @@ Eğer bu örneği çalıştırıp tarayıcınızda <a href="http://127.0.0.1:800
Dikkatinizi çekerim ki, fonksiyonunuzun aldığı (ve döndürdüğü) değer olan `3` bir string `"3"` değil aksine bir Python `int`'idir.
Dikkatinizi çekerim ki, fonksiyonunuzun aldığı (ve döndürdüğü) değer olan `3` bir string `"3"` değil aksine bir Python `int`'idir.
Bu tanımlamayla birlikte, **FastAPI** size otomatik istek <abbrtitle="HTTP isteği ile birlikte gelen string'i Python verisine dönüştürme">"ayrıştırma"</abbr> özelliği sağlar.
Bu tanımlamayla birlikte, **FastAPI** size otomatik istek <abbrtitle="HTTP request'i ile birlikte gelen string'i Python verisine dönüştürme">"parsing"</abbr> özelliği sağlar.
///
///
## Veri Doğrulama
## Veri Doğrulama { #data-validation }
Eğer tarayıcınızda <ahref="http://127.0.0.1:8000/items/foo"class="external-link"target="_blank">http://127.0.0.1:8000/items/foo</a> sayfasını açarsanız, şuna benzer güzel bir HTTP hatası ile karşılaşırsınız:
Eğer tarayıcınızda <ahref="http://127.0.0.1:8000/items/foo"class="external-link"target="_blank">http://127.0.0.1:8000/items/foo</a> sayfasını açarsanız, şuna benzer güzel bir HTTP hatası ile karşılaşırsınız:
@ -62,7 +62,7 @@ Eğer tarayıcınızda <a href="http://127.0.0.1:8000/items/foo" class="external
}
}
```
```
Çünkü burada `item_id` yol parametresi `int` tipinde bir değer beklerken `"foo"` yani `string` tipinde bir değer almıştı.
Çünkü burada `item_id` yol parametresi `"foo"` değerini almıştı, ki bu bir `int` değildir.
Aynı hata <ahref="http://127.0.0.1:8000/items/4.2"class="external-link"target="_blank">http://127.0.0.1:8000/items/4.2</a> sayfasında olduğu gibi `int` yerine `float` bir değer verseydik de ortaya çıkardı.
Aynı hata <ahref="http://127.0.0.1:8000/items/4.2"class="external-link"target="_blank">http://127.0.0.1:8000/items/4.2</a> sayfasında olduğu gibi `int` yerine `float` bir değer verseydik de ortaya çıkardı.
@ -76,9 +76,9 @@ Bu özellik, API'ınızla iletişime geçen kodu geliştirirken ve ayıklarken i
///
///
## Dokümantasyon
## Dokümantasyon { #documentation }
Ayrıca, tarayıcınızı <ahref="http://127.0.0.1:8000/docs"class="external-link"target="_blank">http://127.0.0.1:8000/docs</a> adresinde açarsanız, aşağıdaki gibi otomatik ve interaktif bir API dökümantasyonu ile karşılaşırsınız:
Ayrıca, tarayıcınızı <ahref="http://127.0.0.1:8000/docs"class="external-link"target="_blank">http://127.0.0.1:8000/docs</a> adresinde açarsanız, aşağıdaki gibi otomatik ve interaktif bir API dokümantasyonu ile karşılaşırsınız:
<imgsrc="/img/tutorial/path-params/image01.png">
<imgsrc="/img/tutorial/path-params/image01.png">
@ -90,7 +90,7 @@ Dikkatinizi çekerim ki, yol parametresi integer olarak tanımlanmıştır.
///
///
## Standartlara Dayalı Avantajlar, Alternatif Dokümantasyon
## Standartlara Dayalı Avantajlar, Alternatif Dokümantasyon { #standards-based-benefits-alternative-documentation }
Oluşturulan şema <ahref="https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.1.0.md"class="external-link"target="_blank">OpenAPI</a> standardına uygun olduğu için birçok uyumlu araç mevcuttur.
Oluşturulan şema <ahref="https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.1.0.md"class="external-link"target="_blank">OpenAPI</a> standardına uygun olduğu için birçok uyumlu araç mevcuttur.
@ -100,7 +100,7 @@ Bu sayede, **FastAPI**'ın bizzat kendisi <a href="http://127.0.0.1:8000/redoc"
Aynı şekilde, farklı diller için kod türetme araçları da dahil olmak üzere çok sayıda uyumlu araç bulunur.
Aynı şekilde, farklı diller için kod türetme araçları da dahil olmak üzere çok sayıda uyumlu araç bulunur.
## Pydantic
## Pydantic { #pydantic }
Tüm veri doğrulamaları <ahref="https://docs.pydantic.dev/"class="external-link"target="_blank">Pydantic</a> tarafından arka planda gerçekleştirilir, bu sayede tüm avantajlardan faydalanabilirsiniz. Böylece, emin ellerde olduğunuzu hissedebilirsiniz.
Tüm veri doğrulamaları <ahref="https://docs.pydantic.dev/"class="external-link"target="_blank">Pydantic</a> tarafından arka planda gerçekleştirilir, bu sayede tüm avantajlardan faydalanabilirsiniz. Böylece, emin ellerde olduğunuzu hissedebilirsiniz.
@ -108,7 +108,7 @@ Aynı tip tanımlamalarını `str`, `float`, `bool` ve diğer karmaşık veri ti
Bunlardan birkaçı, bu eğitimin ileriki bölümlerinde irdelenmiştir.
Bunlardan birkaçı, bu eğitimin ileriki bölümlerinde irdelenmiştir.
## Sıralama Önem Arz Eder
## Sıralama Önem Arz Eder { #order-matters }
*Yol operasyonları* tasarlarken sabit yol barındıran durumlar ile karşılaşabilirsiniz.
*Yol operasyonları* tasarlarken sabit yol barındıran durumlar ile karşılaşabilirsiniz.
@ -118,21 +118,21 @@ Benzer şekilde `/users/{user_id}` gibi tanımlanmış ve belirli bir kullanıc
*Yol operasyonları* sıralı bir şekilde gözden geçirildiğinden dolayı `/users/me` yolunun `/users/{user_id}` yolundan önce tanımlanmış olmasından emin olmanız gerekmektedir:
*Yol operasyonları* sıralı bir şekilde gözden geçirildiğinden dolayı `/users/me` yolunun `/users/{user_id}` yolundan önce tanımlanmış olmasından emin olmanız gerekmektedir:
Yol, ilk kısım ile eşleştiğinden dolayı her koşulda ilk yol operasyonu kullanılacaktır.
Yol, ilk kısım ile eşleştiğinden dolayı her koşulda ilk yol operasyonu kullanılacaktır.
## Ön Tanımlı Değerler
## Ön Tanımlı Değerler { #predefined-values }
Eğer *yol parametresi* alan bir *yol operasyonunuz* varsa ve alabileceği *yol parametresi* değerlerinin ön tanımlı olmasını istiyorsanız, standart Python <abbrtitle="Enumeration">`Enum`</abbr> tipini kullanabilirsiniz.
Eğer *yol parametresi* alan bir *yol operasyonunuz* varsa ve alabileceği *yol parametresi* değerlerinin ön tanımlı olmasını istiyorsanız, standart Python <abbrtitle="Enumeration">`Enum`</abbr> tipini kullanabilirsiniz.
### Bir `Enum` Sınıfı Oluşturalım
### Bir `Enum` Sınıfı Oluşturalım { #create-an-enum-class }
`Enum` sınıfını projemize dahil edip `str` ile `Enum` sınıflarını miras alan bir alt sınıf yaratalım.
`Enum` sınıfını projemize dahil edip `str` ile `Enum` sınıflarını miras alan bir alt sınıf yaratalım.
@ -140,13 +140,7 @@ Eğer *yol parametresi* alan bir *yol operasyonunuz* varsa ve alabileceği *yol
Sonrasında, sınıf içerisinde, mevcut ve geçerli değerler olacak olan sabit değerli özelliklerini oluşturalım:
Sonrasında, sınıf içerisinde, mevcut ve geçerli değerler olacak olan sabit değerli özelliklerini oluşturalım:
3.4 sürümünden beri <ahref="https://docs.python.org/3/library/enum.html"class="external-link"target="_blank">enumerationlar (ya da enumlar) Python'da mevcuttur</a>.
///
/// tip | İpucu
/// tip | İpucu
@ -154,33 +148,33 @@ Merak ediyorsanız söyleyeyim, "AlexNet", "ResNet" ve "LeNet" isimleri Makine
///
///
### Bir *Yol Parametresi* Tanımlayalım
### Bir *Yol Parametresi* Tanımlayalım { #declare-a-path-parameter }
Sonrasında, yarattığımız enum sınıfını (`ModelName`) kullanarak tip belirteci aracılığıyla bir *yol parametresi* oluşturalım:
Sonrasında, yarattığımız enum sınıfını (`ModelName`) kullanarak tip belirteci aracılığıyla bir *yol parametresi* oluşturalım:
İstemci tarafında şuna benzer bir JSON yanıtı ile karşılaşırsınız:
İstemci tarafında şuna benzer bir JSON yanıtı ile karşılaşırsınız:
@ -205,7 +199,7 @@ Bu üyeler istemciye iletilmeden önce kendilerine karşılık gelen değerlerin
}
}
```
```
## Yol İçeren Yol Parametreleri
## Yol İçeren Yol Parametreleri { #path-parameters-containing-paths }
Farz edelim ki elinizde `/files/{file_path}` isminde bir *yol operasyonu* var.
Farz edelim ki elinizde `/files/{file_path}` isminde bir *yol operasyonu* var.
@ -213,7 +207,7 @@ Fakat `file_path` değerinin `home/johndoe/myfile.txt` gibi bir *yol* barındır
Sonuç olarak, oluşturmak istediğin URL `/files/home/johndoe/myfile.txt` gibi bir şey olacaktır.
Sonuç olarak, oluşturmak istediğin URL `/files/home/johndoe/myfile.txt` gibi bir şey olacaktır.
### OpenAPI Desteği
### OpenAPI Desteği { #openapi-support }
Test etmesi ve tanımlaması zor senaryolara sebebiyet vereceğinden dolayı OpenAPI, *yol* barındıran *yol parametrelerini* tanımlayacak bir çözüm sunmuyor.
Test etmesi ve tanımlaması zor senaryolara sebebiyet vereceğinden dolayı OpenAPI, *yol* barındıran *yol parametrelerini* tanımlayacak bir çözüm sunmuyor.
@ -221,7 +215,7 @@ Ancak bunu, Starlette kütüphanesinin dahili araçlarından birini kullanarak *
Parametrenin bir yol içermesi gerektiğini belirten herhangi bir doküman eklemememize rağmen dokümanlar yine de çalışacaktır.
Parametrenin bir yol içermesi gerektiğini belirten herhangi bir doküman eklemememize rağmen dokümanlar yine de çalışacaktır.
### Yol Dönüştürücü
### Yol Dönüştürücü { #path-convertor }
Direkt olarak Starlette kütüphanesinden gelen bir opsiyon sayesinde aşağıdaki gibi *yol* içeren bir *yol parametresi* bağlantısı tanımlayabilirsiniz:
Direkt olarak Starlette kütüphanesinden gelen bir opsiyon sayesinde aşağıdaki gibi *yol* içeren bir *yol parametresi* bağlantısı tanımlayabilirsiniz:
@ -233,24 +227,24 @@ Bu durumda, parametrenin adı `file_path` olacaktır ve son kısım olan `:path`
Fonksiyonda yol parametrelerinin parçası olmayan diğer tanımlamalar otomatik olarak "sorgu" parametresi olarak yorumlanır.
Fonksiyonda path parametrelerinin parçası olmayan diğer fonksiyon parametrelerini tanımladığınızda, bunlar otomatik olarak "query" parametreleri olarak yorumlanır.
Sorgu, bağlantıdaki `?` kısmından sonra gelen ve `&` işareti ile ayrılan anahtar-değer çiftlerinin oluşturduğu bir kümedir.
Query, URL'deki `?` işaretinden sonra gelen ve `&` karakterleri ile ayrılan anahtar-değer çiftleri kümesidir.
Örneğin, aşağıdaki bağlantıda:
Örneğin, şu URL'de:
```
```
http://127.0.0.1:8000/items/?skip=0&limit=10
http://127.0.0.1:8000/items/?skip=0&limit=10
```
```
...sorgu parametreleri şunlardır:
...query parametreleri şunlardır:
* `skip`: değeri `0`'dır
* `skip`: değeri `0` olan
* `limit`: değeri `10`'dır
* `limit`: değeri `10` olan
Parametreler bağlantının bir parçası oldukları için doğal olarak string olarak değerlendirilirler.
URL'nin bir parçası oldukları için "doğal olarak" string'dirler.
Fakat, Python tipleri ile tanımlandıkları zaman (yukarıdaki örnekte `int` oldukları gibi), parametreler o tiplere dönüştürülür ve o tipler çerçevesinde doğrulanırlar.
Ama onları Python tipleri ile tanımladığınızda (yukarıdaki örnekte `int` olarak), o tipe dönüştürülürler ve o tipe göre doğrulanırlar.
Yol parametreleri için geçerli olan her türlü işlem aynı şekilde sorgu parametreleri için de geçerlidir:
Path parametreleri için geçerli olan tüm süreç, query parametreleri için de geçerlidir:
* Editör desteği (şüphesiz)
* Editör desteği (tabii ki)
* Veri "<abbrtitle="HTTP isteği ile birlikte gelen string'i Python verisine dönüştürme">ayrıştırma</abbr>"
* Veri <abbrtitle="converting the string that comes from an HTTP request into Python data">"parsing"</abbr>
* Veri doğrulama
* Veri doğrulama
* Otomatik dokümantasyon
* Otomatik dokümantasyon
## Varsayılanlar
## Varsayılanlar { #defaults }
Sorgu parametreleri, adres yolunun sabit bir parçası olmadıklarından dolayı isteğe bağlı ve varsayılan değere sahip olabilirler.
Query parametreleri path'in sabit bir parçası olmadığından, opsiyonel olabilir ve varsayılan değerlere sahip olabilirler.
Yukarıdaki örnekte `skip=0` ve `limit=10` varsayılan değere sahiplerdir.
Yukarıdaki örnekte `skip=0` ve `limit=10` varsayılan değerlerine sahipler.
Yani, aşağıdaki bağlantıya gitmek:
Yani şu URL'ye gitmek:
```
```
http://127.0.0.1:8000/items/
http://127.0.0.1:8000/items/
```
```
şu adrese gitmek ile aynı etkiye sahiptir:
şuna gitmek ile aynı olacaktır:
```
```
http://127.0.0.1:8000/items/?skip=0&limit=10
http://127.0.0.1:8000/items/?skip=0&limit=10
```
```
Ancak, mesela şöyle bir adresi ziyaret ederseniz:
Ama örneğin şuna giderseniz:
```
```
http://127.0.0.1:8000/items/?skip=20
http://127.0.0.1:8000/items/?skip=20
```
```
Fonksiyonunuzdaki parametre değerleri aşağıdaki gibi olacaktır:
Fonksiyonunuzdaki parametre değerleri şöyle olacaktır:
Bu durumda, `q` fonksiyon parametresi isteğe bağlı olacak ve varsayılan değer olarak `None` alacaktır.
Bu durumda, fonksiyon parametresi `q` opsiyonel olacaktır ve varsayılan olarak `None` olacaktır.
/// check | Ek bilgi
/// check | Ek bilgi
Ayrıca, dikkatinizi çekerim ki; **FastAPI**, `item_id` parametresinin bir yol parametresi olduğunu ve `q` parametresinin yol değil bir sorgu parametresi olduğunu fark edecek kadar beceriklidir.
Ayrıca**FastAPI**'nin, path parametresi `item_id`'nin bir path parametresi olduğunu ve `q`'nun olmadığını, dolayısıyla bir query parametresi olduğunu fark edecek kadar akıllı olduğuna da dikkat edin.
///
///
## Sorgu Parametresi Tip Dönüşümü
## Query parametresi tip dönüşümü { #query-parameter-type-conversion }
Aşağıda görüldüğü gibi dönüştürülmek üzere `bool` tipleri de tanımlayabilirsiniz:
`bool` tiplerini de tanımlayabilirsiniz ve dönüştürüleceklerdir:
veya adres, herhangi farklı bir harf varyasyonu içermesi durumuna rağmen (büyük harf, sadece baş harfi büyük kelime, vb.) fonksiyonunuz, `bool` tipli `short` parametresini `True` olarak algılayacaktır. Aksi halde `False` olarak algılanacaktır.
veya başka herhangi bir büyük/küçük harf varyasyonunda (tamamı büyük harf, ilk harfi büyük, vb.), fonksiyonunuz `short` parametresini `bool` değeri `True` olacak şekilde görecektir. Aksi halde `False` olarak görecektir.
## Çoklu Yol ve Sorgu Parametreleri
## Çoklu path ve query parametreleri { #multiple-path-and-query-parameters }
**FastAPI** neyin ne olduğunu ayırt edebileceğinden dolayı aynı anda birden fazla yol ve sorgu parametresi tanımlayabilirsiniz.
Aynı anda birden fazla path parametresi ve query parametresi tanımlayabilirsiniz, **FastAPI** hangisinin hangisi olduğunu bilir.
Ve parametreleri, herhangi bir sıraya koymanıza da gerek yoktur.
Ve onları belirli bir sırayla tanımlamak zorunda değilsiniz.
## Zorunlu query parametreleri { #required-query-parameters }
Türü yol olmayan bir parametre (şu ana kadar sadece sorgu parametrelerini gördük) için varsayılan değer tanımlarsanız o parametre zorunlu olmayacaktır.
Path olmayan parametreler (şimdilik sadece query parametrelerini gördük) için varsayılan bir değer tanımladığınızda, bu zorunlu değildir.
Parametre için belirli bir değer atamak istemeyip parametrenin sadece isteğe bağlı olmasını istiyorsanız değerini `None` olarak atayabilirsiniz.
Belirli bir değer eklemek istemiyor ama sadece opsiyonel olmasını istiyorsanız, varsayılanı `None` olarak ayarlayın.
Fakat, bir sorgu parametresini zorunlu yapmak istiyorsanız varsayılan bir değer atamamanız yeterli olacaktır:
Ama bir query parametresini zorunlu yapmak istediğinizde, herhangi bir varsayılan değer tanımlamamanız yeterlidir:
Bu durumda, 3 tane sorgu parametresi var olacaktır:
Bu durumda, 3 query parametresi vardır:
* `needy`, zorunlu bir `str`.
* `needy`, zorunlu bir `str`.
* `skip`, varsayılan değeri `0` olan bir `int`.
* `skip`, varsayılan değeri `0` olan bir `int`.
* `limit`, isteğe bağlı bir `int`.
* `limit`, opsiyonel bir `int`.
/// tip | İpucu
/// tip | İpucu
Ayrıca, [Yol Parametrelerinde](path-params.md#on-tanml-degerler){.internal-link target=_blank} de kullanıldığı şekilde `Enum` sınıfından faydalanabilirsiniz.
[Path Parameters](path-params.md#predefined-values){.internal-link target=_blank} ile aynı şekilde `Enum`'ları da kullanabilirsiniz.
İstek gövdesinde JSON verisi yerine form alanlarınıkarşılamanız gerketiğinde `Form` sınıfını kullanabilirsiniz.
JSON yerine form alanları almanız gerektiğinde `Form` kullanabilirsiniz.
/// info | Bilgi
/// info | Bilgi
Formları kullanmak için öncelikle<ahref="https://github.com/Kludex/python-multipart"class="external-link"target="_blank">`python-multipart`</a> paketini indirmeniz gerekmektedir.
Formları kullanmak için önce <ahref="https://github.com/Kludex/python-multipart"class="external-link"target="_blank">`python-multipart`</a> paketini kurun.
Örneğin `pip install python-multipart`.
Bir [virtual environment](../virtual-environments.md){.internal-link target=_blank} oluşturduğunuzdan emin olun, onu aktive edin ve ardından örneğin şöyle kurun:
```console
$ pip install python-multipart
```
///
///
## `Form` Sınıfını Projenize Dahil Edin
## `Form`'u Import Edin { #import-form }
`Form` sınıfını `fastapi`'den projenize dahil edin:
Örneğin, OAuth2 spesifikasyonunun kullanılabileceği ("şifre akışı" olarak adlandırılan) yollardan birinde, form alanları olarak <abbrtitle="Kullanıcı Adı: Username">"username"</abbr> ve <abbrtitle="Şifre: Password">"password"</abbr> gönderilmesi gerekir.
Örneğin, OAuth2 spesifikasyonunun kullanılabileceği ("password flow" olarak adlandırılan) yollardan birinde, form alanları olarak `username` ve `password` göndermek gerekir.
Bu <abbrtitle="Spesifikasyon: Specification">spesifikasyon</abbr> form alanlarını adlandırırken isimlerinin birebir `username` ve `password` olmasını ve JSON verisi yerine form verisi olarak gönderilmesini gerektirir.
<abbrtitle="specification - spesifikasyon">spec</abbr> alanların isimlerinin birebir `username` ve `password` olmasını ve JSON değil form alanları olarak gönderilmesini gerektirir.
`Form`sınıfıyla tanımlama yaparken `Body`, `Query`, `Path` ve `Cookie` sınıflarında kullandığınız aynı validasyon, örnekler, isimlendirme (örneğin `username` yerine `user-name` kullanımı) ve daha fazla konfigurasyonu kullanabilirsiniz.
`Form`ile `Body` (ve `Query`, `Path`, `Cookie`) ile yaptığınız aynı konfigurasyonları (validasyon, örnekler, bir alias (ör. `username` yerine `user-name`), vb.) bildirebilirsiniz.
/// info | Bilgi
/// info | Bilgi
`Form` doğrudan `Body` sınıfını miras alan bir sınıftır.
`Form`, doğrudan `Body`'den miras alan bir sınıftır.
///
///
/// tip | İpucu
/// tip | İpucu
Form gövdelerini tanımlamak için `Form` sınıfını kullanmanız gerekir; çünkü bu olmadan parametreler sorgu parametreleri veya gövde (JSON) parametreleri olarak yorumlanır.
Form gövdelerini bildirmek için `Form`'u açıkça kullanmanız gerekir; çünkü bu olmadan parametreler query parametreleri veya gövde (JSON) parametreleri olarak yorumlanır.
///
///
## "Form Alanları" Hakkında
## "Form Alanları" Hakkında { #about-form-fields }
HTML formlarının (`<form></form>`) verileri sunucuya gönderirken JSON'dan farklı özel bir kodlama kullanır.
HTML formlarının (`<form></form>`) verileri sunucuya gönderme şekli normalde bu veriler için JSON'dan farklı "özel" bir kodlama kullanır.
**FastAPI** bu verilerin JSON yerine doğru şekilde okunmasını sağlayacaktır.
**FastAPI** bu veriyi JSON yerine doğru yerden okuduğundan emin olur.
/// note | Teknik Detaylar
/// note | Teknik Detaylar
Form verileri normalde `application/x-www-form-urlencoded`medya tipiyle kodlanır.
Formlardan gelen veriler normalde "media type" `application/x-www-form-urlencoded`kullanılarak kodlanır.
Ancak form içerisinde dosyalar yer aldığında`multipart/form-data` olarak kodlanır. Bir sonraki bölümde dosyaların işlenmesi hakkında bilgi edineceksiniz.
Ancak form dosyalar içerdiğinde`multipart/form-data` olarak kodlanır. Bir sonraki bölümde dosyaların işlenmesi hakkında okuyacaksınız.
Form kodlama türleri ve form alanları hakkında daha fazla bilgi edinmek istiyorsanız <ahref="https://developer.mozilla.org/en-US/docs/Web/HTTP/Methods/POST"class="external-link"target="_blank"><abbrtitle="Mozilla Developer Network">MDN</abbr> web docs for <code>POST</code></a> sayfasını ziyaret edebilirsiniz.
Bu kodlamalar ve form alanları hakkında daha fazla bilgi edinmek isterseniz <ahref="https://developer.mozilla.org/en-US/docs/Web/HTTP/Methods/POST"class="external-link"target="_blank"><abbrtitle="Mozilla Developer Network">MDN</abbr> web docs for <code>POST</code></a> sayfasına gidin.
///
///
/// warning | Uyarı
/// warning | Uyarı
*Yol operasyonları* içerisinde birden fazla `Form` parametresi tanımlayabilirsiniz ancak bunlarla birlikte JSON verisi kabul eden `Body` alanları tanımlayamazsınız çünkü bu durumda istek gövdesi `application/json` yerine `application/x-www-form-urlencoded`ile kodlanmış olur.
Bir *path operation* içinde birden fazla `Form` parametresi bildirebilirsiniz, ancak JSON olarak almayı beklediğiniz `Body` alanlarını da bildiremezsiniz; çünkü bu durumda request gövdesi `application/json` yerine `application/x-www-form-urlencoded`kullanılarak kodlanır.
Bu **FastAPI**'ın getirdiği bir kısıtlama değildir, HTTP protokolünün bir parçasıdır.
Bu **FastAPI**'ın bir kısıtlaması değildir, HTTP protokolünün bir parçasıdır.
///
///
## Özet
## Özet { #recap }
Form verisi girdi parametreleri tanımlamak için `Form` sınıfını kullanın.
Form verisi input parametrelerini bildirmek için `Form` kullanın.
**FastAPI**, geliştiricilere kolaylık sağlamak amacıyla`starlette.staticfiles`'ı `fastapi.staticfiles` olarak sağlar. Ancak`StaticFiles` sınıfı aslında doğrudan Starlette'den gelir.
**FastAPI**, geliştirici olarak sizin için bir kolaylık olarak`starlette.staticfiles`'ı `fastapi.staticfiles` olarak sağlar. Ancak aslında doğrudan Starlette'den gelir.
///
///
### Bağlama (Mounting) Nedir?
### "Mounting" Nedir { #what-is-mounting }
"Bağlamak", belirli bir yola tamamen "bağımsız" bir uygulama eklemek anlamına gelir ve ardından tüm alt yollara gelen istekler bu uygulama tarafından işlenir.
"Mounting", belirli bir path'e tamamen "bağımsız" bir uygulama eklemek anlamına gelir; bu uygulama daha sonra tüm alt path'leri işlemekle ilgilenir.
Bu, bir `APIRouter` kullanmaktan farklıdır çünkü bağlanmış bir uygulama tamamen bağımsızdır. Ana uygulamanızın OpenAPI ve dokümanlar, bağlanmış uygulamadan hiçbir şey içermez, vb.
Bu, bir `APIRouter` kullanmaktan farklıdır çünkü mount edilmiş bir uygulama tamamen bağımsızdır. Ana uygulamanızın OpenAPI ve dokümanları, mount edilmiş uygulamadan hiçbir şey içermez, vb.
[Advanced User Guide](../advanced/index.md){.internal-link target=_blank} bölümünde daha fazla bilgi edinebilirsiniz.
Bununla ilgili daha fazlasını [Advanced User Guide](../advanced/index.md){.internal-link target=_blank} bölümünde okuyabilirsiniz.
## Detaylar
## Detaylar { #details }
`"/static"` ifadesi, bu "alt uygulamanın" "bağlanacağı" alt yolu belirtir. Bu nedenle, `"/static"` ile başlayan her yol, bu uygulama tarafından işlenir.
İlk `"/static"`, bu "alt uygulamanın" üzerine "mount" edileceği alt path'i ifade eder. Dolayısıyla, `"/static"` ile başlayan herhangi bir path bunun tarafından işlenir.
`directory="static"` ifadesi, statik dosyalarınızı içeren dizinin adını belirtir.
`directory="static"`, statik dosyalarınızı içeren dizinin adını ifade eder.
`name="static"` ifadesi, alt uygulamanın **FastAPI** tarafından kullanılacak ismini belirtir.
`name="static"`, **FastAPI** tarafından dahili olarak kullanılabilecek bir isim verir.
Bu parametrelerin hepsi "`static`"den farklı olabilir, bunları kendi uygulamanızın ihtiyaçlarına göre belirleyebilirsiniz.
Bu parametrelerin tümü "`static`"den farklı olabilir; bunları kendi uygulamanızın ihtiyaçlarına ve spesifik detaylarına göre ayarlayın.
## Daha Fazla Bilgi
## Daha Fazla Bilgi { #more-info }
Daha fazla detay ve seçenek için <ahref="https://www.starlette.dev/staticfiles/"class="external-link"target="_blank">Starlette'in Statik Dosyalar hakkındaki dokümantasyonunu</a> incelleyin.
Daha fazla detay ve seçenek için <ahref="https://www.starlette.dev/staticfiles/"class="external-link"target="_blank">Statik Dosyalar hakkında Starlette dokümanlarını</a> inceleyin.
github-actions[bot]
6 months ago