/// tip | İpucu

Sonraki bölümler **mutlaka "gelişmiş" olmak zorunda değildir**.

Ve kullanım durumunuza göre, çözüm bu bölümlerden birinde olabilir.

///

## Önce Öğreticiyi Okuyun { #read-the-tutorial-first }

Sonraki bölümler, ana [Öğretici - Kullanıcı Kılavuzu: Güvenlik](../../tutorial/security/index.md) sayfasını zaten okuduğunuzu varsayar.

Sonraki bölümlerde diğer seçenekleri, konfigürasyonları ve ek özellikleri göreceksiniz.

/// tip | İpucu

Sonraki bölümler **mutlaka "gelişmiş" olmak zorunda değildir**.

Ve kullanım amacınıza bağlı olarak, çözüm bunlardan birinde olabilir.

///

## Önce Tutorial'ı Okuyun { #read-the-tutorial-first }

Ana [Tutorial - User Guide](../tutorial/index.md) sayfasındaki bilgilerle **FastAPI**'nin çoğu özelliğini yine de kullanabilirsiniz.

* **Starlette**:
    * Uvicorn'dan sonra en iyi performansa sahip olacaktır. Aslında Starlette çalışmak için Uvicorn'u kullanır. Bu yüzden muhtemelen yalnızca daha fazla kod çalıştırmak zorunda kaldığı için Uvicorn'dan "daha yavaş" olabilir.
    * Ancak path tabanlı routing vb. ile basit web uygulamaları oluşturmanız için araçlar sağlar.
    * Starlette'i karşılaştırıyorsanız, Sanic, Flask, Django vb. web framework'lerle (veya mikroframework'lerle) karşılaştırın.

///

## Testleri Ayırma { #separating-tests }

Gerçek bir uygulamada testlerinizi büyük ihtimalle farklı bir dosyada tutarsınız.

Ayrıca **FastAPI** uygulamanız birden fazla dosya/modül vb. ile de oluşturulmuş olabilir.

### **FastAPI** Uygulama Dosyası { #fastapi-app-file }

[Daha Büyük Uygulamalar](bigger-applications.md)'te anlatılan şekilde bir dosya yapınız olduğunu varsayalım:

```
.
├── app
│   ├── __init__.py

errors.app.db.already.deleted = Başka bir işlem tarafından silinmiş olabilir. Lütfen tekrar deneyin.
errors.app.db.already.updated = Başka bir işlem tarafından güncellenmiş olabilir. Lütfen tekrar deneyin.
errors.app.db.already.exists = Veri zaten mevcut. Lütfen tekrar deneyin.
errors.app.double.submit.request = Bu istekten önce işlenmiş olabilir. Lütfen tekrar deneyin.

Bu response `dict`'lerinin her birinde, `response_model`'e benzer şekilde bir Pydantic model içeren `model` anahtarı olabilir.

**FastAPI** bu modeli alır, JSON Schema'sını üretir ve OpenAPI'de doğru yere ekler.

Örneğin, `404` status code'u ve `Message` Pydantic model'i ile başka bir response tanımlamak için şunu yazabilirsiniz:

* ...vb.

Yine de, bazı ortamlarda (örn. production) veya environment variable'lardan gelen konfigürasyonlara bağlı olarak API docs'u gerçekten devre dışı bırakmanız gereken çok spesifik bir use case'iniz olabilir.

## Ayarlar ve env var'lar ile koşullu OpenAPI { #conditional-openapi-from-settings-and-env-vars }

Üretilen OpenAPI'yi ve docs UI'larını yapılandırmak için aynı Pydantic settings'i kolayca kullanabilirsiniz.

Örneğin:

* [Stainless](https://www.stainless.com/?utm_source=fastapi&utm_medium=referral)
* [liblab](https://developers.liblab.com/tutorials/sdk-for-fastapi?utm_source=fastapi)

Bu çözümlerin bazıları açık kaynak olabilir veya ücretsiz katman sunabilir; yani finansal bir taahhüt olmadan deneyebilirsiniz. Başka ticari SDK üreteçleri de vardır ve internette bulunabilir. 🤓

## TypeScript SDK Oluşturma { #create-a-typescript-sdk }

Birçok durumda scope'lu OAuth2 gereğinden fazla (overkill) olabilir.

Ama ihtiyacınız olduğunu biliyorsanız ya da merak ediyorsanız okumaya devam edin.

///

## OAuth2 scope'ları ve OpenAPI { #oauth2-scopes-and-openapi }

OAuth2 spesifikasyonu, "scope"ları boşluklarla ayrılmış string'lerden oluşan bir liste olarak tanımlar.

Bu string'lerin her birinin içeriği herhangi bir formatta olabilir, ancak boşluk içermemelidir.

- 🚨 `Optional[SomeType]` kullanmaktan kaçının
- Bunun yerine ✨ **`Union[SomeType, None]` kullanın** ✨.

İkisi de eşdeğer ve temelde aynıdır; ancak "**optional**" kelimesi değerin isteğe bağlı olduğunu ima eder. Oysa aslında " `None` olabilir" demektir; değer isteğe bağlı olmasa ve hâlâ zorunlu olsa bile.

Bence `Union[SomeType, None]` ne demek istediğini daha açık anlatır.