fastapi/docs/es/docs/tutorial/request-forms-and-files.md

Formularios y archivos del request

Puedes definir archivos y campos de formulario al mismo tiempo usando File y Form.

/// note | Nota

Para recibir archivos subidos y/o form data, primero instala python-multipart.

Añádelo a tu proyecto:

$ uv add python-multipart

///

Importa File y Form

{* ../../docs_src/request_forms_and_files/tutorial001_an_py310.py hl[3] *}

Define parámetros File y Form

Crea parámetros de archivo y formulario de la misma manera que lo harías para Body o Query:

{* ../../docs_src/request_forms_and_files/tutorial001_an_py310.py hl[10:12] *}

Los archivos y campos de formulario se subirán como form data y recibirás los archivos y campos de formulario.

Y puedes declarar algunos de los archivos como bytes y algunos como UploadFile.

/// warning | Advertencia

Puedes declarar múltiples parámetros File y Form en una path operation, pero no puedes también declarar campos Body que esperas recibir como JSON, ya que el request tendrá el body codificado usando multipart/form-data en lugar de application/json.

Esto no es una limitación de FastAPI, es parte del protocolo HTTP.

///

Resumen

Usa File y Form juntos cuando necesites recibir datos y archivos en el mismo request.