/saludar → leé la query 'nombre' y devolvé {"saludo": "Hola <nombre>"}.
Ejemplo: GET /saludar?nombre=Ash → {"saludo": "Hola Ash"}
Entrá y llevá tu progreso —ejercicios, medallas y Pokémon— a cualquier dispositivo. 🔄
Si tu cuenta ya tiene progreso guardado, se carga ese al entrar.
Entraste como . Tu progreso se sincroniza solo. 🔄
Ejemplo: GET /saludar?nombre=Ash → {"saludo": "Hola Ash"}
🎯 Meta: que tu API reciba datos en la URL: un id en el path (/pokemon/25) o filtros en la query (/buscar?tipo=Fuego).
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.
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())
💡 <int:n> dice que n es un número. Sin int: llegaría como texto. También podés usar <nombre> para texto.
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.
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.
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'}
💡 Path vs query: el path (/pokemon/25) identifica un recurso; la query (?tipo=Fuego) filtra o ajusta el pedido. Los dos llegan por la URL.
| Cosa | Para qué |
|---|---|
@app.route("/x/<int:n>") | parte variable numérica del path |
@app.route("/x/<nombre>") | parte variable de texto |
| la función recibe esos valores como argumentos | |
request.args.get("clave") | leer un parámetro de la query (?clave=...) |
Practicá con los ejercicios de este tema. 💪
⚡ “Una buena API responde la pregunta exacta que le hacés.”