Primera App¶

Código¶

La app más simple de FastAPI podría ser:

main.py

from fastapi import FastAPI

app = FastAPI()


@app.get("/")
def read_root():
    return {"message": "Hello World"}

Copia ese contenido a un archivo main.py.

Servidor¶

Ejecuta el servidor en vivo:

$ uvicorn main:app --reload

<span style="color: green;">INFO</span>:     Uvicorn running on http://127.0.0.1:8000 (Press CTRL+C to quit)
<span style="color: green;">INFO</span>:     Started reloader process [28720]
<span style="color: green;">INFO</span>:     Started server process [28722]
<span style="color: green;">INFO</span>:     Waiting for application startup.
<span style="color: green;">INFO</span>:     Application startup complete.

Note

El comando uvicorn main:app --reload hace referencia a:

main: el archivo main.py (el "módulo" de Python).
app: el objeto creado dentro de main.py con la línea app = FastAPI().
--reload: hace que el servidor reinicie después de que haya cambios en el código. Solo se debe usar durante el desarrollo.

Tip

En ese comando, el fragmento main:app es equivalente a:

from main import app

En la salida, hay una línea con algo como:

INFO:     Uvicorn running on http://127.0.0.1:8000 (Press CTRL+C to quit)

Esa línea muestra la URL donde está siendo servida tu app, en tu máquina local.

Docs del API¶

Ahora puedes abrir los docs del API en: http://127.0.0.1:8000/docs.