Tag'leriniz için metadata oluşturup `openapi_tags` parametresine geçin:

{* ../../docs_src/metadata/tutorial004_py310.py hl[3:16,18] *}

Açıklamaların içinde Markdown kullanabileceğinizi unutmayın; örneğin "login" kalın (**login**) ve "fancy" italik (_fancy_) olarak gösterilecektir.

/// tip | İpucu

Kullandığınız tüm tag'ler için metadata eklemek zorunda değilsiniz.

///

### Tag'lerinizi kullanın { #use-your-tags }

Ayrıca sub-application mount ederken de içeride kullanılır.

Path prefix'i kırpılan bir proxy kullanmak, şu anlama gelir: Kodunuzda `/app` altında bir path tanımlarsınız; ancak üstte bir katman (proxy) ekleyip **FastAPI** uygulamanızı `/api/v1` gibi bir path'in altına koyarsınız.

Bu durumda, orijinal `/app` path'i aslında `/api/v1/app` altında servis edilir.

Bu sayede güncel **dokümantasyon**, birden fazla dilde istemci kütüphaneleri (<abbr title="Software Development Kits - Yazılım Geliştirme Kitleri">**SDKs**</abbr>) ve kodunuzla senkron kalan **test** veya **otomasyon iş akışları** üretmek kolaylaşır.

Bu rehberde, FastAPI backend'iniz için bir **TypeScript SDK** üretmeyi öğreneceksiniz.

## Açık Kaynak SDK Üreteçleri { #open-source-sdk-generators }

```JSON
{
    "X-Token values": [
        "bar",
        "foo"
    ]
}
```

## Özet { #recap }

Header'ları `Header` ile tanımlayın; `Query`, `Path` ve `Cookie` ile kullanılan ortak kalıbı burada da kullanın.

- ve uygulamada hiç kimlik doğrulama yoksa, aynı ağdan gelen her request’in güvenilir olduğu varsayılıyorsa.

## Örnek Saldırı { #example-attack }

Yerelde çalışan bir AI agent’ı (yapay zeka ajanı) çalıştırmanın bir yolunu geliştirdiğinizi düşünün.

Bir API sunuyor:

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

Ayrıca bir frontend var:

```

* Çeviride her şeyin yolunda olup olmadığını kontrol edin.
* Gerekirse dile özel prompt'u, genel prompt'u veya İngilizce dokümanı iyileştirin.
* Ardından çeviride kalan sorunları elle düzeltin; böylece iyi bir çeviri elde edin.

labels.user_given_name=Ad
labels.givenName=Ad
labels.user_surname=Soyadı
labels.surame=Soyadı
labels.user_mail=E-posta
labels.mail=E-posta
labels.user_employeeNumber=Çalışan Numarası
labels.employeeNumber=Çalışan Numarası
labels.user_telephoneNumber=Telefon Numarası
labels.telephoneNumber=Telefon Numarası
labels.user_homePhone=Ev Telefonu
labels.homePhone=Ev Telefonu

ve o *external API*'den şu gibi bir JSON body içeren response bekleyecek:

```JSON
{
    "ok": true
}
```

/// tip | İpucu

Callback URL'sinin, `callback_url` içindeki query parametresi olarak alınan URL'yi (`https://www.external.org/events`) ve ayrıca JSON body'nin içindeki fatura `id`'sini (`2expen51ve`) birlikte kullandığına dikkat edin.

///

### Callback router'ını ekleyin { #add-the-callback-router }

Bu araçlarla güvenlik sistemini herhangi bir veritabanıyla ve herhangi bir user veya veri modeliyle uyumlu hale getirebilirsiniz.

Eksik kalan tek detay, bunun henüz gerçekten "güvenli" olmamasıdır.

* [**JSON Schema**](https://json-schema.org/) ile otomatik veri modeli dokümantasyonu (OpenAPI zaten JSON Schema'ya dayanır).
* Bu standartlar etrafında, titiz bir çalışmanın ardından tasarlandı; sonradan eklenmiş bir katman değil.
* Bu sayede birçok dilde otomatik **client code generation** da kullanılabilir.

### Otomatik Dokümantasyon { #automatic-docs }