¿Qué es una API REST?

Una API REST es una interfaz que expone recursos a través de HTTP mediante un conjunto reducido de verbos y patrones de URL predecibles. REST, abreviatura de Representational State Transfer, es un estilo arquitectónico más que un protocolo estricto, pero la práctica habitual de usar GET, POST, PUT, PATCH y DELETE contra URLs de recursos se ha convertido en la forma predeterminada de integrar servicios web.

Definición

En un diseño REST típico, cada recurso tiene su propia URL, y las operaciones sobre ese recurso se corresponden con verbos HTTP. Un producto puede residir en /products/123, recuperable con GET, modificable con PATCH y eliminable con DELETE. Las respuestas suelen ser JSON, los códigos de estado indican el resultado, y las cabeceras transportan metadatos como directivas de caché y tokens de autenticación.

Por qué importa

Las APIs REST son la lengua franca de los stacks de comercio modernos. Los sistemas PIM, el OMS, los proveedores de pago, los motores de búsqueda y las plataformas de contenido exponen endpoints REST que consumen los storefronts y las capas de integración. Su simplicidad, el amplio soporte de herramientas y la semántica HTTP explícita las hacen muy adecuadas para integraciones públicas.

REST frente a GraphQL

REST destaca en interacciones claras y orientadas a recursos y se beneficia del cacheo nativo de HTTP. GraphQL destaca en lecturas flexibles en las que el cliente decide la forma de la respuesta. En la práctica, la mayoría de los stacks de comercio composable combinan ambos: REST para la integración de servicio a servicio y los webhooks, GraphQL o BFFs para el frontend. La elección depende de las habilidades del equipo, del ecosistema y de cuán predecibles sean las necesidades del cliente.

Relacionado

Descubre Composable Digital Experience Platform · Composable Headless Frontend.