Herramientas y DevOps · revisado en julio de 2026
API REST
Una API REST es una interfaz que permite que dos programas se comuniquen por HTTP usando URLs para identificar recursos y verbos como GET, POST, PUT y DELETE para operar sobre ellos. Es el estilo más común para exponer datos y funcionalidad en la web, y suele intercambiar información en formato JSON.
from fastapi import FastAPI
app = FastAPI()
@app.get("/pedidos/{pedido_id}")
def obtener_pedido(pedido_id: int):
return {"id": pedido_id, "total": 149.90}Preguntas frecuentes
¿Qué significa que una API sea REST?
Que sigue un conjunto de convenciones: cada recurso tiene su propia URL, las operaciones se expresan con verbos HTTP y las respuestas no dependen de un estado guardado entre peticiones. Esto la hace predecible y fácil de consumir desde cualquier lenguaje.
¿En qué se diferencia una API REST de GraphQL?
REST expone varios endpoints, uno por recurso, y devuelve estructuras fijas; GraphQL expone un solo endpoint donde el cliente pide exactamente los campos que necesita. REST es más simple de cachear y entender; GraphQL evita traer datos de más.
¿Con qué se construye una API REST en Python?
FastAPI es una opción muy usada: define endpoints con funciones de Python, valida los datos de entrada y salida con Pydantic y genera documentación OpenAPI automáticamente.