Cómo funcionan las API REST · Mapas mentales
Cómo funcionan las API REST. Un mapa mental editable con ramas de colores, ideas secundarias y conexiones. Las líneas curvas muestran relaciones; las flechas aparecen cuando importa la dirección.
Una API REST es una conversación en HTTP: el cliente envía una petición que nombra un recurso y una acción, el servidor la procesa y la respuesta lleva un código de estado y el resultado.
Cómo funcionan las API REST · Mapas mentales
El lienzo interactivo de MindMap de esta explicación: cada carril, cada fila y cada flecha de arriba forma parte de un diagrama real de QueryChart que puedes abrir y editar.
Cómo leer este mapa mental
- Empieza por el tema central y sigue una rama de color para explorar sus ideas.
- Las líneas curvas muestran relaciones; las flechas aparecen cuando importa la dirección.
Request
Esta rama reúne “The method is the verb — GET reads, POST creates, PUT replaces, PATCH updates, DELETE removes. REST names resources by URL and acts on them with these verbs.”, “Client sends the request over HTTPS”.
Routing
Esta rama reúne “The URL path is the routing key: /users/42 is the handler for one user. Query parameters, headers and the body carry everything else the handler needs.”, “Validation covers authentication (are you who you say you are?), authorization (are you allowed?), and the payload itself (is the data well formed?).”.
Business logic
Esta rama reúne “Handler runs the business logic”, “Server reads or writes the resource in the database”.
Response
Esta rama reúne “The status code is the contract: 200 OK, 201 Created, 204 No Content, 404 Not Found, 500 Server Error. Clients branch on it before they read the body.”, “Client receives the response and parses it”, “Client renders the result to the user”.
Errors
Esta rama reúne “Server returns 400 / 401 / 403”.
Conexiones entre ramas
REST es un contrato en HTTP: los métodos son verbos, las URL son recursos y los códigos de estado son el resultado legible por máquinas.
El cliente es sin estado: cada petición lleva todo lo que el servidor necesita, así que no hace falta ninguna sesión compartida.
La validación es la frontera de seguridad; una petición no válida se rechaza antes de ejecutar cualquier lógica de negocio.
La respuesta se define primero por su código de estado y después por su cuerpo.
El tráfico REST viaja sobre la misma infraestructura de DNS, HTTPS e internet que dibujan los otros diagramas de tecnología.
Relaciones clave y conclusiones
- REST es un contrato en HTTP: los métodos son verbos, las URL son recursos y los códigos de estado son el resultado legible por máquinas.
- El cliente es sin estado: cada petición lleva todo lo que el servidor necesita, así que no hace falta ninguna sesión compartida.
- La validación es la frontera de seguridad; una petición no válida se rechaza antes de ejecutar cualquier lógica de negocio.
- La respuesta se define primero por su código de estado y después por su cuerpo.
- El tráfico REST viaja sobre la misma infraestructura de DNS, HTTPS e internet que dibujan los otros diagramas de tecnología.
Cuándo usar este diagrama
- Enseñar el modelo de método, URL y código de estado de HTTP a los ingenieros antes de que diseñen su primer endpoint.
- Revisar el contrato de una API (¿los errores son códigos de estado o un 200 con un indicador?) frente a la convención REST.
- Anclar una conversación sobre idempotencia y caché en cómo se construyen y se validan las peticiones de verdad.
Cómo funciona
Adapta el tema central
Cambia el nombre del tema para adaptarlo a tu proyecto o clase.
Desarrolla las ramas
Edita las ideas y añade ejemplos o notas.
Conecta ideas relacionadas
Dibuja conexiones entre ramas; usa flechas cuando la dirección importe.
Preguntas frecuentes
¿Qué es una API REST?
Una API REST es un conjunto de endpoints HTTP que exponen los recursos de un sistema. Los clientes actúan sobre los recursos con métodos HTTP (GET para leer, POST para crear, PUT o PATCH para actualizar, DELETE para eliminar) y el servidor responde con un código de estado y una representación, normalmente JSON. REST es un estilo más que un estándar, y su valor está en que cualquier cliente que hable HTTP puede usarla.
¿Cuál es la diferencia entre GET, POST, PUT y DELETE?
Son los verbos del contrato REST. GET lee un recurso y no debería tener efectos secundarios. POST crea un recurso nuevo y devuelve su identidad. PUT reemplaza un recurso entero y es idempotente: repetirlo no cambia nada más. PATCH aplica una actualización parcial. DELETE elimina un recurso. Juntos, el verbo y la URL nombran la acción completa, y por eso la caja de la petición del diagrama destaca primero el método.
¿Por qué son importantes los códigos de estado en REST?
Porque son el resultado de la petición legible por máquinas. Un cliente puede ramificarse según el código de estado sin analizar el cuerpo: 2xx éxito, 4xx error del cliente, 5xx error del servidor. Las API que devuelven un 200 con un indicador de error en el cuerpo rompen este contrato y obligan a cada cliente a tratar la respuesta como un caso especial.
¿Qué hace que una API sea «RESTful»?
La lista práctica: recursos nombrados por URL, acciones expresadas como métodos HTTP, peticiones sin estado (cada una lleva todo lo que el servidor necesita), respuestas que usan bien los códigos de estado y, a menudo, hipermedia o URL versionadas. El lienzo modela la ida y vuelta (petición, validación, procesamiento, respuesta), que es la forma que comparte todo intercambio RESTful.
Editar este mapa mental en QueryChart
Abre este mapa mental en un lienzo editable. Mueve ideas, añade ramas y dibuja conexiones.