Una REST API es una forma común de diseñar una API web en torno a recursos como usuarios, problemas o pedidos. Cada recurso tiene una URL, y métodos HTTP como GET, POST, PATCH y DELETE le indican al servidor qué quiere hacer el cliente.
REST significa Representational State Transfer. En la práctica, un cliente envía una solicitud HTTP, el servidor devuelve una representación de un recurso y cada solicitud debe tener sentido por sí sola. Muchas REST APIs devuelven JSON, pero usar JSON por sí solo no hace que una API sea RESTful.
Significado de REST API: piensa en recursos
La forma más rápida de entender REST es pensar en sustantivos, no en verbos.
Si tu sistema tiene problemas, estudiantes e intentos, esos pueden ser recursos. Una API orientada a recursos suele usar URLs como /api/problems/42 o /api/attempts/9001.
El método HTTP te dice entonces qué tipo de operación está ocurriendo:
GETlee un recursoPOSTcrea un recurso nuevoPUTreemplaza un recursoPATCHactualiza parte de un recursoDELETEelimina un recurso
Esa separación es lo que hace que REST sea fácil de revisar. La URL dice con qué estás trabajando. El método dice qué quieres hacer.
Cómo funciona una solicitud en una REST API
En un flujo típico, un navegador, una app móvil u otro servicio envía una solicitud a un servidor. La solicitud incluye una URL, un método HTTP, encabezados opcionales y, a veces, un cuerpo.
El servidor lee la solicitud, realiza la acción y devuelve una respuesta. Esa respuesta suele incluir un código de estado como 200 OK, 201 Created o 404 Not Found, además de datos que describen el resultado.
Una condición importante es la ausencia de estado. En REST, cada solicitud debe contener el contexto necesario para esa solicitud. Eso no significa que el servidor no almacene datos. Significa que el servidor no debería necesitar un estado oculto de conversación de solicitudes anteriores para entender la actual.
Ejemplo de REST API: una app de práctica de matemáticas
Supón que una app de práctica de matemáticas almacena problemas de álgebra e intentos de estudiantes.
Para leer el problema , el cliente podría enviar:
¿Necesitas ayuda con un problema?
Sube tu pregunta y obtén una solución verificada, paso a paso, en segundos.
Abrir GPAI Solver →