E a documentação continuará funcionando, embora não adicione nenhuma informação dizendo que o parâmetro deve conter um path.

### Conversor de path { #path-convertor }

Usando uma opção diretamente do Starlette você pode declarar um *parâmetro de path* contendo um *path* usando uma URL como:

```
/files/{file_path:path}
```

### OpenAPI 支持 { #openapi-support }

OpenAPI 不支持声明包含路径的路径参数，因为这会导致测试和定义更加困难。

不过，仍可使用 Starlette 内置工具在 **FastAPI** 中实现这一功能。

而且不影响文档正常运行，但是不会添加该参数包含路径的说明。

### 路径转换器 { #path-convertor }

直接使用 Starlette 的选项声明包含路径的路径参数：

```
/files/{file_path:path}
```

本例中，参数名为 `file_path`，结尾部分的 `:path` 说明该参数应匹配路径。

用法如下：

{* ../../docs_src/path_params/tutorial004_py310.py hl[6] *}

   * (NCR). Any non-ASCII characters appearing in the input will be preserved in the output.
   * Specifically "\r" (carriage return) is preserved in the output, which may result in it being
   * silently converted to "\n" when the XML is parsed.
   *
   * <p>This escaper does not treat surrogate pairs specially and does not perform Unicode
   * validation on its input.
   */
  public static Escaper xmlContentEscaper() {

    }

    /**
     * Registers a data store instance with the factory using the specified name.
     * The data store will be accessible by both the provided name and its class simple name,
     * both converted to lowercase for case-insensitive lookup.
     *
     * @param name the name to register the data store under, must not be null
     * @param dataStore the data store instance to register, must not be null

    }

    /**
     * Creates an EditBody from a ScheduledJob entity.
     *
     * @param entity the scheduled job entity to convert
     * @return the converted EditBody
     */
    protected EditBody createEditBody(final ScheduledJob entity) {
        final EditBody body = new EditBody();
        copyBeanToBean(entity, body, op -> op.exclude(Constants.COMMON_CONVERSION_RULE));

    }

    @Test
    @DisplayName("available() wraps SmbException to IOException")
    void available_wrapsException() throws Exception {
        // Verify exceptions from th.send are converted to IOException via seToIoe
        SmbPipeInputStream stream = newStreamWithMinimalStubs(true);

        when(handle.ensureOpen()).thenReturn(fd);
        when(fd.getTree()).thenReturn(tree);

les convertir en quelque chose qui peut être envoyé sur le réseau. Par exemple, convertir un objet contenant des
données provenant d'une base de données en un objet JSON. Convertir des objets `datetime` en strings, etc.

        // Set a test time using reflection
        long testTime = System.currentTimeMillis();
        setFieldValue(response, "lastWriteTime", testTime);

        // All time methods should return the same converted time
        long expectedTime = testTime + serverTimeZoneOffset;
        assertEquals(expectedTime, response.getCreateTime());
        assertEquals(expectedTime, response.getLastWriteTime());

        monitorTarget.append(buf, "dateKey", supplier);
        String result = buf.toString();
        assertTrue(result.startsWith("\"dateKey\":\""));
        // Check that the date was converted to string and properly escaped
        assertTrue(result.contains("2021") || result.contains("Jan") || result.contains("1609459200000"));
    }

    // Test appendTimestamp method
    @Test

## Résultats { #results }

En utilisant uniquement les déclarations de type Python, **FastAPI** réussit à :

* Lire le contenu de la requête en tant que JSON.
* Convertir les types correspondants (si nécessaire).
* Valider la donnée.
    * Si la donnée est invalide, une erreur propre et claire sera renvoyée, indiquant exactement où et quelle était la donnée incorrecte.