API REST
Una API REST (Transferencia de Estado Representacional) es una interfaz de servicio web que utiliza métodos HTTP estándar (GET, POST, PUT, DELETE, PATCH) para acceder y manipular recursos identificados por URLs, siguiendo un conjunto de convenciones arquitectónicas que hacen que las APIs sean predecibles e interoperables.
Comprendiendo API REST
REST es el estilo arquitectónico dominante para las APIs web. Sus convenciones —recursos identificados por URLs, cambios de estado mediante métodos HTTP, solicitudes sin estado y formatos de respuesta estándar— generan una previsibilidad que facilita la integración. La mayoría de los servicios web (GitHub, Slack, Notion, Google Workspace, Stripe) exponen APIs REST. El diseño RESTful se centra en los recursos: una tarea es un recurso en /tasks/123, un usuario es un recurso en /users/456. GET /tasks/123 recupera la tarea. POST /tasks crea una nueva. PUT /tasks/123 reemplaza la tarea. PATCH /tasks/123 la actualiza parcialmente. DELETE /tasks/123 la elimina. Estas convenciones permiten que los desarrolladores trabajen rápidamente con APIs desconocidas. Las respuestas REST suelen usar el formato JSON, que es ligero, legible y universalmente soportado. Las respuestas incluyen códigos de estado que comunican éxito (200, 201) o error (400, 401, 403, 404, 500), permitiendo un manejo robusto de errores. REST presenta limitaciones en casos complejos: exceso de datos recuperados (over-fetching), falta de datos necesarios (under-fetching) y ausencia de capacidades en tiempo real (para eventos, usa webhooks o WebSocket). GraphQL soluciona algunas de estas limitaciones cuando los requisitos de datos son complejos.
Cómo GAIA usa API REST
GAIA se comunica con sus más de 50 integraciones principalmente a través de APIs REST. Gmail, Google Calendar, Notion, Slack, Linear, GitHub y la mayoría de otros servicios conectados exponen APIs REST que GAIA consulta para leer datos, crear registros y desencadenar acciones. MCP (Model Context Protocol) proporciona una capa estandarizada por encima de estas APIs REST para las herramientas de agente de GAIA.
Conceptos relacionados
Integración de API
La integración de API es el proceso de conectar distintas aplicaciones de software a través de sus Interfaces de Programación de Aplicaciones, permitiendo que compartan datos y funcionalidades de manera fluida.
Webhook
Un webhook es un mecanismo de devolución de llamada HTTP donde un sistema envía una solicitud HTTP automatizada a una URL específica cada vez que ocurre un evento definido, lo que permite notificación e integración en tiempo real entre servicios sin sondeo.
OAuth
OAuth (Autorización Abierta) es un estándar abierto para autorización delegada que permite que una aplicación de terceros acceda a los datos del usuario en otro servicio sin necesitar que el usuario comparta su contraseña.
Protocolo de Contexto de Modelo (MCP)
El Protocolo de Contexto de Modelo (MCP) es un estándar abierto que permite a los modelos de IA conectarse de forma segura con herramientas, fuentes de datos y servicios externos a través de una interfaz unificada.
