API REST
Une API REST (Representational State Transfer) est une interface de service web qui utilise les méthodes HTTP standard (GET, POST, PUT, DELETE, PATCH) pour accéder et manipuler des ressources identifiées par des URL, en suivant un ensemble de conventions architecturales qui rendent les API prévisibles et interopérables.
Comprendre API REST
REST est le style d'architecture dominant pour les API web. Ses conventions — ressources identifiées par des URL, modifications d'état via les méthodes HTTP, requêtes sans état, et formats de réponse standardisés — créent une prévisibilité qui facilite l'intégration. La plupart des services web (GitHub, Slack, Notion, Google Workspace, Stripe) proposent des API REST. La conception RESTful est centrée sur les ressources : une tâche est une ressource à /tasks/123, un utilisateur est à /users/456. GET /tasks/123 récupère la tâche. POST /tasks crée une nouvelle tâche. PUT /tasks/123 remplace la tâche. PATCH /tasks/123 la met partiellement à jour. DELETE /tasks/123 la supprime. Ces conventions permettent aux développeurs de travailler rapidement avec des API inconnues. Les réponses REST utilisent généralement le format JSON, qui est léger, lisible et universellement supporté. Les réponses incluent des codes d'état qui indiquent le succès (200, 201) ou l'échec (400, 401, 403, 404, 500), permettant une gestion des erreurs robuste. REST présente des limites pour les cas d'utilisation complexes : la sur-récupération (récupérer plus de données que nécessaire), la sous-récupération (avoir besoin de plusieurs appels pour obtenir toutes les données requises), et l'absence de fonctionnalités temps réel (utiliser des webhooks ou WebSocket pour les événements). GraphQL répond à certaines de ces limites pour les besoins de données complexes.
Comment GAIA utilise API REST
GAIA communique avec plus de 50 intégrations principalement via des API REST. Gmail, Google Calendar, Notion, Slack, Linear, GitHub et la plupart des autres services connectés proposent des API REST que GAIA interroge pour lire des données, créer des enregistrements et déclencher des actions. Le MCP (Model Context Protocol) fournit une couche standardisée au-dessus de ces API REST pour les outils agents de GAIA.
Concepts liés
Intégration API
L'intégration API est le processus qui consiste à connecter différentes applications logicielles via leurs interfaces de programmation (API), leur permettant de partager facilement données et fonctionnalités.
Webhook
Un webhook est un mécanisme de rappel HTTP par lequel un système envoie automatiquement une requête HTTP à une URL spécifiée dès qu’un événement défini survient, ce qui permet une notification et une intégration en temps réel entre services sans avoir à interroger régulièrement.
OAuth
OAuth (Open Authorization) est une norme ouverte pour l’autorisation déléguée permettant à une application tierce d’accéder aux données d’un utilisateur sur un autre service sans exiger que celui-ci partage son mot de passe.
Model Context Protocol (MCP)
Le Model Context Protocol (MCP) est une norme ouverte permettant aux modèles d'IA de se connecter en toute sécurité à des outils, sources de données et services externes via une interface unifiée.
