Flask: parámetros

Una API útil responde distinto según lo que le pidas. ¿El Pokémon número 25? ¿Los de tipo Fuego? Esos datos viajan en la URL.

🔢 Parámetros en el path

Ponés una parte variable de la URL entre <...>. Flask te la pasa como argumento a la función.

from flask import Flask, jsonify
app = Flask(__name__)

@app.route("/pokemon/<int:n>")
def pokemon(n):
    return jsonify({"id": n, "nombre": f"Pokémon #{n}"})

c = app.test_client()
print(c.get("/pokemon/25").get_json())   # {'id': 25, 'nombre': 'Pokémon #25'}
print(c.get("/pokemon/1").get_json())

P: En la ruta `@app.route("/pokemon/<int:n>")`, ¿qué significa `int:`?
- Que la ruta solo funciona con métodos enteros.
- Que `n` puede ser cualquier texto.
+ Que Flask convierte el valor de la URL a `int` antes de pasárselo a la función.
> Sin `int:`, el valor llega como texto (`"25"`). Con `int:n`, Flask lo convierte a número entero (`25`) automáticamente.

🔤 Parámetros de texto

from flask import Flask
app = Flask(__name__)

@app.route("/saludo/<nombre>")
def saludo(nombre):
    return f"Hola, {nombre}"

c = app.test_client()
print(c.get("/saludo/Ash").get_data(as_text=True))   # Hola, Ash

P: ¿Cómo se lee el parámetro `tipo` de la URL `/buscar?tipo=Fuego` en Flask?
- `request.json["tipo"]`
- `request.path["tipo"]`
+ `request.args.get("tipo")`
> Los parámetros de query (lo que va después del `?`) se leen con `request.args.get("clave")`. `request.json` es para el cuerpo de un POST.

❓ Query strings: filtros con ?

Lo que va después del ? en la URL son parámetros de consulta. Se leen con request.args.

from flask import Flask, jsonify, request
app = Flask(__name__)

@app.route("/buscar")
def buscar():
    tipo = request.args.get("tipo")          # de /buscar?tipo=Fuego
    return jsonify({"buscando": tipo})

c = app.test_client()
print(c.get("/buscar?tipo=Fuego").get_json())   # {'buscando': 'Fuego'}

📝 Resumen

➡️ ¿Y ahora qué?

Practicá con los ejercicios de este tema. 💪