/crear-pokemon (POST) recibe {"nombre":..,"tipo":..} → {"pokemon": {"nombre":..,"tipo":.…
con código 201.
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. 🔄
con código 201.
🎯 Meta: que tu API reciba datos del cliente con POST. Hasta ahora solo entregabas; ahora también recibís.
GET sirve para leer. Pero cuando el cliente quiere enviar algo (crear un Pokémon, mandar un formulario), usa POST, con los datos en el cuerpo del pedido (en JSON).
Por defecto una ruta solo acepta GET. Para aceptar POST lo decís con methods.
from flask import Flask, jsonify, request
app = Flask(__name__)
@app.route("/eco", methods=["POST"])
def eco():
datos = request.json # lo que mandó el cliente (un dict)
return jsonify(datos) # se lo devolvemos igual
c = app.test_client()
r = c.post("/eco", json={"nombre": "Mew", "nivel": 70})
print(r.get_json()) # {'nombre': 'Mew', 'nivel': 70}
💡 request.json te da el cuerpo del pedido ya convertido a diccionario. En el cliente, c.post(url, json={...}) manda ese cuerpo.
P: ¿Cómo se lee el cuerpo JSON que mandó el cliente en una ruta POST de Flask?
- `request.args.get("datos")`
- `request.body`
+ `request.json`
> `request.json` parsea automáticamente el cuerpo JSON del pedido y te da un diccionario. `request.args` es para la query string (lo del `?`).
from flask import Flask, jsonify, request
app = Flask(__name__)
@app.route("/sumar", methods=["POST"])
def sumar():
d = request.json
return jsonify({"suma": d["a"] + d["b"]})
c = app.test_client()
print(c.post("/sumar", json={"a": 25, "b": 17}).get_json()) # {'suma': 42}
P: ¿Qué código de estado HTTP se usa por convención cuando una API **crea** un recurso nuevo?
- `200`
- `404`
+ `201`
> `200` significa "OK" (pedido procesado). `201` significa "Creado": se usa cuando el resultado del POST fue crear algo nuevo. `404` es "no encontrado".
Cuando creás algo, la convención es responder 201 (creado). Devolvés una tupla (respuesta, código).
from flask import Flask, jsonify, request
app = Flask(__name__)
@app.route("/crear", methods=["POST"])
def crear():
nombre = request.json["nombre"]
return jsonify({"creado": nombre}), 201 # 👈 el 201
c = app.test_client()
r = c.post("/crear", json={"nombre": "Pikachu"})
print(r.status_code) # 201
print(r.get_json()) # {'creado': 'Pikachu'}
| Cosa | Para qué |
|---|---|
@app.route("/x", methods=["POST"]) | aceptar POST en esa ruta |
request.json | leer el cuerpo JSON del pedido |
return jsonify(...), 201 | responder con un código de estado |
c.post(url, json={...}) | (cliente) mandar datos por POST |
Practicá con los ejercicios de este tema. 💪
⚡ “GET pregunta, POST entrega. Con los dos, tu API conversa.”