Değişkenleriniz için tip bildirerek, editörler ve araçlar size daha iyi destek sağlayabilir.

Bu, Python type hints hakkında sadece **hızlı bir eğitim / bilgi tazeleme** dokümanıdır. **FastAPI** ile kullanmak için gereken minimum bilgiyi kapsar... ki aslında bu çok azdır.

**FastAPI** tamamen bu type hints üzerine kuruludur; bunlar ona birçok avantaj ve fayda sağlar.

# OpenAPI Webhook'lar { #openapi-webhooks }

Bazı durumlarda, API'nizi kullanan **kullanıcılara** uygulamanızın *onların* uygulamasını (request göndererek) bazı verilerle çağırabileceğini; genellikle bir tür **event** hakkında **bildirim** yapmak için kullanacağını söylemek istersiniz.

///

Ardından app ile bir `AsyncClient` oluşturup `await` kullanarak ona async request'ler gönderebiliriz.

{* ../../docs_src/async_tests/app_a_py310/test_main.py hl[9:12] *}

Bu, şu kullanıma denktir:

```Python
response = client.get('/')
```

...ki daha önce request'leri `TestClient` ile bu şekilde gönderiyorduk.

/// tip | İpucu

Ancak şunu unutmayın: `fastapi`'den `Query`, `Path`, `Header` ve diğerlerini import ettiğinizde, bunlar aslında özel sınıfları döndüren fonksiyonlardır.

///

/// info | Bilgi

Header'ları tanımlamak için `Header` kullanmanız gerekir; aksi halde parametreler query parametreleri olarak yorumlanır.

///

## Otomatik Dönüştürme { #automatic-conversion }

Bu sayede alt uygulama, dokümantasyon arayüzü için o path önekini kullanması gerektiğini bilir.

Ayrıca alt uygulamanın kendi mount edilmiş alt uygulamaları da olabilir; FastAPI tüm bu `root_path`’leri otomatik olarak yönettiği için her şey doğru şekilde çalışır.

Bununla birlikte **FastAPI** ile [pytest](https://docs.pytest.org/)'i doğrudan kullanabilirsiniz.

## `TestClient` Kullanımı { #using-testclient }

/// info | Bilgi

`TestClient` kullanmak için önce [`httpx`](https://www.python-httpx.org)'i kurun.

Bir [Sanal Ortam](../virtual-environments.md) oluşturduğunuzdan, onu aktifleştirdiğinizden ve sonra kurulumu yaptığınızdan emin olun; örneğin:

```console

FastAPI veriyi Pydantic ile JSON'a çevirmeye veya herhangi bir şekilde serileştirmeye çalışmayacağı için, bu durumda tip annotasyonu sadece editörünüz ve araçlarınız içindir; FastAPI tarafından kullanılmaz.

{* ../../docs_src/stream_data/tutorial001_py310.py ln[32:35] hl[33] *}

Kullanıcılarınızdan biri de bunu indirip yerelde çalıştırabilir.

Sonra kötü niyetli bir web sitesini açabilir, örneğin:

```
https://evilhackers.example.com
```

Ve bu kötü niyetli site, body olarak Blob kullanan fetch() ile yerel API’ye request’ler gönderebilir:

```
http://localhost:8000/v1/agents/multivac
```

Örneğin `/api/v1/openapi.json` adresinden sunulacak şekilde ayarlamak için:

{* ../../docs_src/metadata/tutorial002_py310.py hl[3] *}

OpenAPI şemasını tamamen kapatmak isterseniz `openapi_url=None` ayarlayabilirsiniz; bu, onu kullanan dokümantasyon arayüzlerini de devre dışı bırakır.

## Doküman URL'leri { #docs-urls }

Dahil gelen iki dokümantasyon arayüzünü yapılandırabilirsiniz:

* **Swagger UI**: `/docs` adresinden sunulur.

labels.designFileName=Dosya Adı
labels.incrementalCrawling=Son Değişikliği Kontrol Et
labels.errorCount=Hata Sayısı
labels.errorLog=Hata Günlüğü
labels.errorName=Hata Adı
labels.expiredTime=Son Kullanma Zamanı
labels.expires=Son Kullanma
labels.failureCountThreshold=Hata Sayısı
labels.fileConfigName=Dosya Tarama Yapılandırma Adı
labels.fileName=Dosya Adı
labels.handlerName=İşleyici Adı
labels.handlerParameter=Parametre