You will see your docs including a "Callbacks" section for your *path operation* that shows how the *external API* should look like:

Você verá sua documentação incluindo uma seção "Callbacks" para sua *operação de rota* que mostra como a *API externa* deveria ser:

```

////

..就像:

{* ../../docs_src/dependencies/tutorial003_an_py310.py hl[19] *}

但是声明类型是被鼓励的，因为那样你的编辑器就会知道将传递什么作为参数 `commons` ，然后它可以帮助你完成代码，类型检查，等等：

<img src="/img/tutorial/dependencies/image02.png">

## 快捷方式 { #shortcut }

但是你可以看到，我们在这里有一些代码重复了，编写了`CommonQueryParams`两次：

//// tab | Python 3.10+

```Python
commons: Annotated[CommonQueryParams, Depends(CommonQueryParams)]
```

```

</div>

## Перевірте { #check-it }

Перейдіть до інтерактивної документації: [http://127.0.0.1:8000/docs](http://127.0.0.1:8000/docs).

Ви побачите щось подібне:

<img src="/img/tutorial/security/image01.png">

/// check | Кнопка Authorize!

У вас уже є нова блискуча кнопка «Authorize».

А ваша *операція шляху* має маленький замок у правому верхньому куті, на який можна натиснути.

///

{* ../../docs_src/path_operation_advanced_configuration/tutorial005_py310.py hl[6] *}

当你打开自动 API 文档时，你的扩展会显示在该 *路径操作* 的底部。

<img src="/img/tutorial/path-operation-advanced-configuration/image01.png">

如果你查看最终生成的 OpenAPI（在你的 API 的 `/openapi.json`），你也会看到你的扩展作为该 *路径操作* 的一部分：

```JSON hl_lines="22"
{
    "openapi": "3.1.0",
    "info": {
        "title": "FastAPI",
        "version": "0.1.0"

Bu nedenle interaktif dokümanlar, bu dependency'lerden gelen tüm bilgileri de içerir:

<img src="/img/tutorial/dependencies/image01.png">

## Basit Kullanım { #simple-usage }

Tarayıcınızı [http://127.0.0.1:8000/docs](http://127.0.0.1:8000/docs) adresinde açtığınızda, aşağıdaki gibi otomatik ve interaktif bir API dokümantasyonu görürsünüz:

<img src="/img/tutorial/path-params/image01.png">

/// check | Ek bilgi

Yine, sadece aynı Python tip tanımıyla **FastAPI** size otomatik ve interaktif dokümantasyon (Swagger UI entegrasyonuyla) sağlar.

Dikkat edin: path parametresi integer olarak tanımlanmıştır.

### Doküman arayüzünde örnek { #example-in-the-docs-ui }

Yukarıdaki yöntemlerden herhangi biriyle `/docs` içinde şöyle görünür:

<img src="/img/tutorial/body-fields/image01.png">

### Birden fazla `examples` ile `Body` { #body-with-multiple-examples }

Elbette birden fazla `examples` da geçebilirsiniz:

{* ../../docs_src/schema_extra_example/tutorial004_an_py310.py hl[23:38] *}

...다음과 같이요:

{* ../../docs_src/dependencies/tutorial003_an_py310.py hl[19] *}

하지만 타입을 선언하는 것을 권장합니다. 그러면 에디터가 매개변수 `commons`에 무엇이 전달되는지 알 수 있고, 코드 완성, 타입 체크 등에서 도움을 받을 수 있습니다:

<img src="/img/tutorial/dependencies/image02.png">

## 단축 { #shortcut }

하지만 `CommonQueryParams`를 두 번 작성하는 코드 반복이 있다는 것을 볼 수 있습니다:

//// tab | Python 3.10+

```Python
commons: Annotated[CommonQueryParams, Depends(CommonQueryParams)]
```

Vous verrez votre documentation incluant une section « Callbacks » pour votre *chemin d'accès* qui montre à quoi l’*API externe* devrait ressembler :