Dados do formulário

Quando você precisar receber campos de formulário ao invés de JSON, você pode usar Form.

Informação

Para usar formulários, primeiro instale python-multipart.

Ex: pip install python-multipart.

Importe Form

Importe Form de fastapi:

from fastapi import FastAPI, Form

app = FastAPI()


@app.post("/login/")
async def login(username: str = Form(), password: str = Form()):
    return {"username": username}

Declare parâmetros de Form

Crie parâmetros de formulário da mesma forma que você faria para Body ou Query:

from fastapi import FastAPI, Form

app = FastAPI()


@app.post("/login/")
async def login(username: str = Form(), password: str = Form()):
    return {"username": username}

Por exemplo, em uma das maneiras que a especificação OAuth2 pode ser usada (chamada "fluxo de senha"), é necessário enviar um username e uma password como campos do formulário.

A spec exige que os campos sejam exatamente nomeados como username e password e sejam enviados como campos de formulário, não JSON.

Com Form você pode declarar os mesmos metadados e validação que com Body (e Query, Path, Cookie).

Informação

Form é uma classe que herda diretamente de Body.

Dica

Para declarar corpos de formulário, você precisa usar Form explicitamente, porque sem ele os parâmetros seriam interpretados como parâmetros de consulta ou parâmetros de corpo (JSON).

Sobre "Campos de formulário"

A forma como os formulários HTML (<form></form>) enviam os dados para o servidor normalmente usa uma codificação "especial" para esses dados, é diferente do JSON.

O FastAPI fará a leitura desses dados no lugar certo em vez de JSON.

Detalhes técnicos

Os dados dos formulários são normalmente codificados usando o "tipo de mídia" application/x-www-form-urlencoded.

Mas quando o formulário inclui arquivos, ele é codificado como multipart/form-data. Você lerá sobre como lidar com arquivos no próximo capítulo.

Se você quiser ler mais sobre essas codificações e campos de formulário, vá para o MDN web docs para POST.

Aviso

Você pode declarar vários parâmetros Form em uma operação de caminho, mas não pode declarar campos Body que espera receber como JSON, pois a solicitação terá o corpo codificado usando application/x-www- form-urlencoded em vez de application/json.

Esta não é uma limitação do FastAPI, é parte do protocolo HTTP.

Recapitulando

Use Form para declarar os parâmetros de entrada de dados de formulário.