/// tip | İpucu

Bu basit örneklerle çok faydalı görünmeyebilir.

Ancak **security** ile ilgili bölümlerde bunun ne kadar işe yaradığını göreceksiniz.

Ayrıca size ne kadar kod kazandırdığını da göreceksiniz.

Nós poderíamos fazer melhor.

Podemos declarar um modelo `UserBase` que serve como base para nossos outros modelos. E então podemos fazer subclasses desse modelo que herdam seus atributos (declarações de tipo, validação, etc.).

Toda conversão de dados, validação, documentação, etc. ainda funcionará normalmente.

Dessa forma, podemos declarar apenas as diferenças entre os modelos (com `password` em texto claro, com `hashed_password` e sem senha):

O importante a se lembrar é que a chave `sub` deve ter um identificador único em toda a aplicação e deve ser uma string.

## Verifique { #check-it }

Execute o servidor e vá para a documentação: [http://127.0.0.1:8000/docs](http://127.0.0.1:8000/docs).

Você verá a interface de usuário assim:

### Output Response Verisi için Model { #model-for-output-response-data }

Dokümanlarla etkileşip response'u kontrol ederseniz, kod `description` alanlarından birine bir şey eklememiş olsa bile, JSON response default değeri (`null`) içerir:

<div class="screenshot">
<img src="/img/tutorial/separate-openapi-schemas/image02.png">
</div>

knightpoint.systems
knowsitall.info
knx-server.net
kobayashi.miyazaki.jp
kobierzyce.pl
kochi.jp
kochi.kochi.jp
kodaira.tokyo.jp
koeln
kofu.yamanashi.jp
koga.fukuoka.jp
koga.ibaraki.jp
koganei.tokyo.jp
koge.tottori.jp
koka.shiga.jp
kokonoe.oita.jp
kokubunji.tokyo.jp
kolobrzeg.pl
komae.tokyo.jp
komagane.nagano.jp
komaki.aichi.jp
komatsu
komatsu.ishikawa.jp

/// note | Detalles técnicos

En la especificación de OpenAPI se llama el [Objeto de Operación](https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.3.md#operation-object).

///

Tiene toda la información sobre la *path operation* y se usa para generar la documentación automática.

Incluye los `tags`, `parameters`, `requestBody`, `responses`, etc.

**FastAPI**, API'ları tanımlamak için **OpenAPI** standardını kullanarak tüm API'nızın tamamını içeren bir "şema" üretir.

#### "Şema" { #schema }

"Şema", bir şeyin tanımı veya açıklamasıdır. Onu uygulayan kod değil, sadece soyut bir açıklamadır.

#### API "şeması" { #api-schema }

Bu durumda, [OpenAPI](https://github.com/OAI/OpenAPI-Specification), API'nızın şemasını nasıl tanımlayacağınızı belirleyen bir şartnamedir.

Podríamos hacerlo mejor.

Podemos declarar un modelo `UserBase` que sirva como base para nuestros otros modelos. Y luego podemos hacer subclases de ese modelo que heredan sus atributos (declaraciones de tipos, validación, etc).

Toda la conversión de datos, validación, documentación, etc. seguirá funcionando normalmente.

De esa manera, podemos declarar solo las diferencias entre los modelos (con `password` en texto plano, con `hashed_password` y sin contraseña):

    * Numbers (`int`, `float`) com valores mínimos e máximos, etc.

* Validação de tipos mais exóticos, como:
    * URL.
    * Email.
    * UUID.
    * ...e outros.

Toda a validação é controlada pelo robusto e bem estabelecido **Pydantic**.

### Segurança e autenticação { #security-and-authentication }

labels.labeledURI=labeledURI
labels.user_roomNumber=Oda Numarası
labels.roomNumber=Oda Numarası
labels.user_description=Açıklama
labels.description=Açıklama
labels.user_title=Başlık
labels.title=Başlık
labels.user_pager=Çağrı Cihazı
labels.pager=Çağrı Cihazı
labels.user_street=Sokak
labels.street=Sokak
labels.user_postalCode=Posta Kodu
labels.postalCode=Posta Kodu
labels.user_physicalDeliveryOfficeName=Ofis