¿Qué es una API REST y qué significan GET, POST, PUT y DELETE?

Publicado el 2026-10-20 por frfrand

API REST explicada con ejemplos de clientes y productos: recursos, métodos HTTP, códigos de estado y diferencias con una API cualquiera.

Una API REST es una interfaz diseñada siguiendo un estilo de arquitectura centrado en recursos y en el uso coherente de mecanismos del protocolo web. Muchas APIs que llamamos REST se comunican mediante HTTP y usan métodos como GET, POST, PUT, PATCH y DELETE.

Pero REST no es simplemente «mandar JSON por HTTP». El diseño de recursos, las representaciones y la semántica de las operaciones también importan.

El ejemplo de una tienda online

Imagina que tienes productos y pedidos. Una aplicación móvil y una web necesitan consultar ambos tipos de información.

En vez de inventar una orden textual diferente para cada tarea, puedes utilizar rutas reconocibles: /productos, /productos/42 o /pedidos/15.

La ruta identifica un recurso o una colección. El método HTTP indica qué tipo de operación solicita el cliente.

¿Qué hace GET?

GET /productos/42 suele solicitar una representación del producto identificado como 42.

Por diseño, GET debe utilizarse para operaciones de lectura y no debería provocar efectos de negocio peligrosos como cobrar una compra o borrar una cuenta.

Eso no impide que el servidor registre métricas o accesos, pero la operación expuesta al cliente debe respetar las expectativas del protocolo.

¿Para qué sirven POST, PUT, PATCH y DELETE?

POST suele utilizarse para enviar información que el servidor procesará, como crear un pedido.

PUT se utiliza habitualmente para crear o sustituir la representación de un recurso identificado.

PATCH permite aplicar modificaciones parciales según el formato de petición definido.

DELETE solicita eliminar un recurso o realizar la operación de eliminación correspondiente.

No es correcto afirmar que todos los backends deben asignar exactamente CRUD a estos métodos sin considerar el diseño y la semántica real.

¿Qué es un código de estado HTTP?

El servidor devuelve un código que ayuda a entender el resultado de la petición.

Por ejemplo, 200 OK indica éxito en un caso habitual, 201 Created puede indicar creación, 400 Bad Request una solicitud inválida, 401 Unauthorized falta de autenticación adecuada, 403 Forbidden un acceso rechazado y 404 Not Found un recurso no encontrado.

El código no reemplaza una explicación útil del error, pero permite a clientes y herramientas reaccionar correctamente.

¿Qué formato utiliza una API REST?

Muchas utilizan JSON porque es cómodo para intercambiar datos estructurados. Pero REST no exige necesariamente JSON. Pueden existir otras representaciones según la aplicación.

Tampoco exige que el frontend esté hecho en un lenguaje concreto. Un backend Django puede ofrecer una API consumida desde React, una app Android y otros servicios.

¿Por qué se habla de stateless?

En el estilo REST, las solicitudes deberían contener información suficiente para que el servidor las interprete, sin depender de una conversación implícita que solo se conoce por haber recibido peticiones anteriores.

Eso no significa que el sistema no pueda guardar pedidos, usuarios o sesiones en bases de datos. Significa que el contrato de las solicitudes debe permitir entender qué requiere cada operación.

¿Cómo se protege una API?

Necesita autenticación cuando corresponda, autorización por recurso, validación de datos, límites de abuso y manejo correcto de errores.

Ocultar un botón del frontend no evita que alguien llame directamente al endpoint. Por ejemplo, GET /pedidos/15 no debería revelar información simplemente porque una persona adivinó el número del pedido.

También conviene aplicar consultas parametrizadas y revisar qué datos se devuelven para no exponer campos internos.

¿Y si necesito actualizar información en tiempo real?

Podés complementar una API HTTP con webhooks, WebSocket u otras tecnologías. No hay que forzar todos los escenarios al mismo patrón si una alternativa resulta más adecuada.

Una aplicación puede consultar productos por REST y recibir notificaciones por un canal diferente.

¿Cómo se relaciona con ArduMaker?

Los backends desplegados dentro de VPS de ArduMaker pueden ofrecer APIs HTTP para conectarse con otros programas. La plataforma proporciona la infraestructura y herramientas de integración; el contrato de recursos, métodos y permisos pertenece al diseño del software.

En resumen: REST es una forma de organizar interfaces web alrededor de recursos y reglas coherentes. Aprender los métodos y códigos HTTP permite entender buena parte de las APIs modernas.

Fuentes: Métodos HTTP en MDN · Visión general de HTTP · Qué es una API.