Una API REST es una interfaz de programación de aplicaciones (Application Programming Interface) que permite a dos programas comunicarse entre sí mediante el protocolo HTTP, el mismo que hace funcionar la Web. REST (Representational State Transfer) es un estilo de arquitectura descrito por Roy Fielding en 2000; se apoya en los estándares ya existentes de la Web en lugar de en un protocolo propietario, lo que lo hace sencillo de adoptar y ampliamente interoperable.
En una API REST, cada dato se expone como un recurso identificado por una URL (por ejemplo /clientes/123). Se actúa sobre esos recursos con los verbos HTTP estándar: GET para leer, POST para crear, PUT o PATCH para modificar, DELETE para eliminar. Los intercambios circulan casi siempre en formato JSON, que es a la vez ligero, legible para las personas y fácil de procesar por las máquinas.
REST es sin estado (stateless): cada petición contiene toda la información necesaria para su procesamiento, en particular el token de autenticación, sin que el servidor tenga que recordar el contexto de los intercambios anteriores. Las respuestas van acompañadas de un código de estado HTTP (200 correcto, 201 creado, 401 no autorizado, 404 no encontrado…). Esta sencillez explica que REST se haya convertido en el estándar de facto de las integraciones entre aplicaciones.
eyeot expone una API REST documentada según la especificación OpenAPI y protegida mediante tokens. Constituye la base del módulo de integraciones y de la conexión de herramientas de terceros; la autorización de las aplicaciones se apoya en particular en OAuth 2.1.