{* ../../docs_src/additional_responses/tutorial001_py310.py hl[18,22] *}

/// note

Keep in mind that you have to return the `JSONResponse` directly.

///

/// info

The `model` key is not part of OpenAPI.

**FastAPI** will take the Pydantic model from there, generate the JSON Schema, and put it in the correct place.

The correct place is:

            "name": "The Baz"
        }
    ]
}
```

/// info

Notice how the `images` key now has a list of image objects.

///

## Deeply nested models { #deeply-nested-models }

You can define arbitrarily deeply nested models:

{* ../../docs_src/body_nested_models/tutorial007_py310.py hl[7,12,18,21,25] *}

/// info

#*    *##set ( $licFile = $directory + '/' + $project.artifact.artifactId + '.license' )
#*    *##set ( $downloaded = $locator.getResourceAsFile( "licenses/${spdx}.txt", "licenses/${licFile}" ) )

#*    *### add dependency info to output

- $directory/${project.artifact.artifactId}-${project.artifact.version}.jar: $project.artifact.toString().replace( ':eclipse-plugin:', ':jar:' )
    Project: $project.name

/// note | 기술 세부사항

`Header`는 `Path`, `Query` 및 `Cookie`의 "자매"클래스입니다. 이 역시 동일한 공통 `Param` 클래스를 상속합니다.

`Query`, `Path`, `Header` 그리고 다른 것들을 `fastapi`에서 임포트 할 때, 이들은 실제로 특별한 클래스를 반환하는 함수임을 기억하세요.

///

/// info | 정보

헤더를 선언하기 위해서 `Header`를 사용해야 합니다. 그렇지 않으면 해당 매개변수를 쿼리 매개변수로 해석하기 때문입니다.

///

## 자동 변환 { #automatic-conversion }

`Header`는 `Path`, `Query` 그리고 `Cookie`가 제공하는 것 외에 기능이 조금 더 있습니다.

            EnumSet.of(RdmaAccess.LOCAL_WRITE, RdmaAccess.REMOTE_WRITE));
        
        try {
            // Create SMB2 Read request with RDMA read channel info
            request.addRdmaChannelInfo(readRegion.getRemoteKey(), 
                                     readRegion.getAddress(),
                                     readRegion.getSize());
            

                                <c:if test="${fileAuthPager.allRecordCount == 0}">
                                    <div class="row top10"><div class="col-sm-12 empty-list-placeholder"><i class="fa fa-info-circle text-primary" aria-hidden="true"></i>
                                            <la:message key="labels.list_could_not_find_crud_table"/>
                                        </div>

                private
                fun visitClassFile(file: Path) {
                    try {
                        if (file.endsWith("module-info.class")) {
                            // We can't keep this info intact, ignore this.
                            return
                        }
                        val outputPrefix = if (file.startsWith("/META-INF/versions")) {

## 导入 `Path` { #import-path }

首先，从 `fastapi` 导入 `Path`，并导入 `Annotated`：

{* ../../docs_src/path_params_numeric_validations/tutorial001_an_py310.py hl[1,3] *}

/// info | 信息

FastAPI 在 0.95.0 版本添加了对 `Annotated` 的支持（并开始推荐使用它）。

如果你使用的是更旧的版本，尝试使用 `Annotated` 会报错。

请确保在使用 `Annotated` 之前，将 FastAPI 版本[升级](../deployment/versions.md#upgrading-the-fastapi-versions)到至少 0.95.1。

///

API 的另一个重要需求是从传入请求中<dfn title="读取并转换为 Python 数据">解析</dfn>数据。

Webargs 是一个在多个框架（包括 Flask）之上提供该功能的工具。

它在底层使用 Marshmallow 进行数据校验，并且由相同的开发者创建。

在拥有 **FastAPI** 之前，我也大量使用过它，这是个很棒的工具。

/// info | 信息

Webargs 由与 Marshmallow 相同的开发者创建。

///

/// check | 启发 **FastAPI**：

对传入请求数据进行自动校验。

///

### [APISpec](https://apispec.readthedocs.io/en/stable/) { #apispec }

@Singleton
public class LifecycleDebugLogger {
    private final Logger logger = LoggerFactory.getLogger(getClass());

    public void debug(String s) {
        logger.debug(s);
    }

    public void info(String s) {
        logger.info(s);
    }

    public void debugReactorPlan(ProjectBuildList projectBuilds) {
        if (!logger.isDebugEnabled()) {
            return;
        }