Definición
Una API REST es una API que sigue el estilo de arquitectura REST (Representational State Transfer), el más extendido en la web. Cada recurso, como un cliente, un pedido o una factura, tiene una dirección URL propia, y las operaciones se expresan con los verbos estándar de internet: GET para leer, POST para crear, PUT para modificar y DELETE para borrar. Los datos viajan normalmente en formato JSON, legible tanto por máquinas como por personas.
En la empresa, cuando un proveedor de software dice que tiene API, casi siempre se refiere a una API REST. Su ventaja es la universalidad: cualquier lenguaje de programación y cualquier herramienta de integración la entiende, y un desarrollador puede empezar a usarla en minutos con la documentación. Los servicios de pagos, facturación electrónica, mensajería, mapas, firma digital y modelos de IA se consumen de esta forma. Es el idioma común de la integración entre sistemas.
REST lleva más de dos décadas siendo el estándar de facto y no parece que vaya a cambiar, aunque convive con alternativas como GraphQL para casos concretos. El malentendido habitual es pensar que una API REST es buena por ser REST. La calidad depende de la documentación, la consistencia, la gestión de errores, los límites de uso y la seguridad. Una API REST mal diseñada obliga a hacer decenas de llamadas para obtener un dato que debería costar una.
En la práctica
Una empresa de reparto integra su aplicación con la API REST de su proveedor de mapas para calcular rutas y con la de su pasarela de pago para cobrar contra reembolso. Ambas integraciones las hace un desarrollador en una semana gracias a que siguen el mismo estilo.
Por qué importa
Si un proveedor te ofrece una API REST bien documentada, integrarlo será barato y podrás cambiarlo si hace falta. Si te ofrece exportar un Excel, estás comprando trabajo manual para tu equipo durante años.
Preguntas frecuentes
- ¿Qué significa API REST y qué diferencia tiene con una API normal?
- REST es un estilo de diseño de API sobre la web, no una tecnología distinta. Una API REST organiza la información en recursos con direcciones propias y usa los verbos estándar de internet para operar con ellos. Cuando alguien dice API sin más, casi siempre se refiere a una API REST, porque es el estilo dominante.
- ¿Qué es mejor, REST o GraphQL?
- Para la mayoría de integraciones entre sistemas de empresa, REST: es más simple, universal y fácil de cachear. GraphQL compensa cuando el cliente necesita combinar muchos datos relacionados en una sola consulta, como en aplicaciones móviles complejas. Muchas empresas ofrecen ambas; elige según quién va a consumir la API.