![ReDoc](https://fastapi.tiangolo.com/img/index/index-02-redoc-simple.png)

### OpenAPI

O **FastAPI** gera um "*schema*" com toda a sua API usando o padrão **OpenAPI** para definir APIs.

#### "*Schema*"

Um "*schema*" é uma definição ou descrição de algo. Não o código que o implementa, mas apenas uma descrição abstrata.

En algún punto habrías comenzado con la definición de la función, tenías los parámetros listos...

Pero, luego tienes que llamar "ese método que convierte la primera letra en una mayúscula".

Era `upper`? O era `uppercase`? `first_uppercase`? `capitalize`?

Luego lo intentas con el viejo amigo de los programadores, el auto-completado del editor.

Por exemplo, estava claro que idealmente ele deveria ser baseado nos _type hints_ padrões do Python.

Também, a melhor abordagem era usar padrões já existentes.

Então, antes mesmo de começar a codificar o **FastAPI**, eu investi vários meses estudando as especificações do OpenAPI, JSON Schema, OAuth2 etc. Entendendo suas relações, sobreposições e diferenças.

Et une réponse avec un code HTTP `200` qui utilise votre `response_model`, mais inclut un `example` personnalisé :

```Python hl_lines="20-31"
{!../../../docs_src/additional_responses/tutorial003.py!}
```

Tout sera combiné et inclus dans votre OpenAPI, et affiché dans la documentation de l'API :

<img src="/img/tutorial/additional-responses/image01.png">

## Combinez les réponses prédéfinies et les réponses personnalisées

Au final, peu importe le cas parmi ceux ci-dessus, **FastAPI** fonctionnera de manière asynchrone et sera extrêmement rapide.

Mais si vous suivez bien les instructions ci-dessus, alors **FastAPI** pourra effectuer quelques optimisations et ainsi améliorer les performances.

## Détails techniques

```

Pero, si por ejemplo vas a:

```
http://127.0.0.1:8000/items/?skip=20
```

Los valores de los parámetros en tu función serán:

* `skip=20`: porque lo definiste en la URL
* `limit=10`: porque era el valor por defecto

## Parámetros opcionales

Del mismo modo puedes declarar parámetros de query opcionales definiendo el valor por defecto como `None`:

```Python hl_lines="9"

Esta misma sintaxis (o casi idéntica) también se incluyó recientemente en las versiones modernas de JavaScript (en Browser y NodeJS).

Pero antes de eso, manejar código asíncrono era bastante más complejo y difícil.

### Plus loin avec la documentation API interactive

Maintenant, rendez-vous sur <a href="http://127.0.0.1:8000/docs" class="external-link" target="_blank">http://127.0.0.1:8000/docs</a>.

* La documentation interactive de l'API sera automatiquement mise à jour, y compris le nouveau corps de la requête :

![Swagger UI](https://fastapi.tiangolo.com/img/index/index-03-swagger-02.png)

Essa mesma sintaxe (ou quase a mesma) foi também incluída recentemente em versões modernas do JavaScript (no navegador e NodeJS).

Mas antes disso, controlar código assíncrono era bem mais complexo e difícil.

­text/markdown¤etagÙ 4af243ccccbadaf12545¡vÎeçnÐδg»Ä ¤nullÅ%uûc¿“êíûO á §hÁ¿ÂÄ·Î,2ù ÞV² 6R6u2·¾ çò] „ ]iyýYVa~v„ yûJEØέ¡ µXiA[5¦dN@^Í ¯µA~eMýªi}d g )Õv mý…vMFe¯Õ~c›?ª~^tBK’1•_VIwY¸÷s`”SU©¤ ‹' ñmwON¾ MhzÕ}ªd Ð{œ™¡û=M°sR_eô*Kºim¿ðñ)cKÖ»`w~h]» ûzq]»oeRa{®}Úk ãh'wg­œ¸Ž–Œ ;/²XDBbÕÔ£­* æœ~Yuý%r°C[S»Ö÷is`g 1}gp i»³ ·# Tqc}~Gi% `nÄÐ{œ™¡ûué&Ojg}nFO&ûo½æËìaK£XqCïR_K7Y ,Fñ 0±›lPÃïÝ-²ø* BIÜï1#_^^uB¸å7i¹}û,W{•[ixU !v\YF—ÃýËF}J- › 3)%ÄÌ1±3‰c` ; &f|VtW¦£¯JEÇ´wgZr NyËergWXxeèZ¬mck¿ëkZai7åû~eU1m}qVïP¯¨IcVPUæ¹jwCk¸Irk©G}n爯Èé...