API REST
Uma API REST (Representational State Transfer) é uma interface de serviço web que utiliza métodos HTTP padrões (GET, POST, PUT, DELETE, PATCH) para acessar e manipular recursos identificados por URLs, seguindo um conjunto de convenções arquiteturais que tornam as APIs previsíveis e interoperáveis.
Entendendo API REST
REST é o estilo arquitetural dominante para APIs web. Suas convenções — recursos identificados por URLs, mudanças de estado via métodos HTTP, requisições sem estado e formatos de resposta padrão — criam previsibilidade que facilita a integração. A maioria dos serviços web (GitHub, Slack, Notion, Google Workspace, Stripe) expõe APIs REST. O design RESTful é centrado em recursos: uma tarefa é um recurso em /tasks/123, um usuário é um recurso em /users/456. GET /tasks/123 recupera a tarefa. POST /tasks cria uma nova tarefa. PUT /tasks/123 substitui a tarefa. PATCH /tasks/123 atualiza parcialmente. DELETE /tasks/123 remove a tarefa. Essas convenções permitem que desenvolvedores trabalhem rapidamente com APIs desconhecidas. As respostas REST normalmente utilizam o formato JSON, que é leve, de fácil leitura e amplamente suportado. As respostas incluem códigos de status que comunicam sucesso (200, 201) ou falha (400, 401, 403, 404, 500), permitindo um tratamento de erros robusto. REST apresenta limitações para casos de uso complexos: over-fetching (buscar mais dados do que o necessário), under-fetching (precisar de várias chamadas para obter todos os dados necessários) e falta de recursos em tempo real (nesse caso, use webhooks ou WebSocket para eventos). O GraphQL soluciona algumas dessas limitações para demandas de dados mais complexas.
Como GAIA usa API REST
A GAIA se comunica com mais de 50 integrações principalmente por meio de APIs REST. Gmail, Google Calendar, Notion, Slack, Linear, GitHub e a maioria dos outros serviços conectados oferecem APIs REST que a GAIA utiliza para ler dados, criar registros e acionar ações. O MCP (Model Context Protocol) fornece uma camada padronizada acima dessas APIs REST para as ferramentas de agente da GAIA.
Conceitos relacionados
Integração de API
Integração de API é o processo de conectar diferentes aplicativos por meio de suas Interfaces de Programação de Aplicações, permitindo que compartilhem dados e funcionalidades de forma transparente.
Webhook
Um webhook é um mecanismo de callback HTTP em que um sistema envia uma requisição HTTP automatizada para uma URL especificada sempre que um evento definido ocorre, permitindo notificações em tempo real e integração entre serviços sem necessidade de polling.
OAuth
OAuth (Open Authorization) é um padrão aberto de autorização delegada que permite que um aplicativo de terceiros acesse dados do usuário em outro serviço sem que o usuário precise compartilhar sua senha.
Model Context Protocol (MCP)
O Model Context Protocol (MCP) é um padrão aberto que permite que modelos de IA se conectem com segurança a ferramentas, fontes de dados e serviços externos por meio de uma interface unificada.
