REST-API
Eine REST (Representational State Transfer) API ist eine Webservice-Schnittstelle, die Standard-HTTP-Methoden (GET, POST, PUT, DELETE, PATCH) verwendet, um auf Ressourcen zuzugreifen und diese zu bearbeiten. Sie folgt einer Reihe von Architekturkonventionen, die APIs vorhersagbar und interoperabel machen.
Verstehen REST-API
REST ist der dominierende Architekturstil für Web-APIs. Seine Konventionen – Ressourcen werden durch URLs identifiziert, Zustandsänderungen erfolgen über HTTP-Methoden, stateless Requests, standardisierte Antwortformate – schaffen Vorhersehbarkeit und erleichtern die Integration. Die meisten Webdienste (GitHub, Slack, Notion, Google Workspace, Stripe) bieten REST-APIs an. Das RESTful Design dreht sich um Ressourcen: Eine Aufgabe ist eine Ressource unter /tasks/123, ein Benutzer eine Ressource unter /users/456. GET /tasks/123 ruft die Aufgabe ab. POST /tasks erstellt eine neue Aufgabe. PUT /tasks/123 ersetzt die Aufgabe. PATCH /tasks/123 aktualisiert sie teilweise. DELETE /tasks/123 entfernt sie. Durch diese Konventionen können Entwickler schnell mit ihnen unbekannten APIs arbeiten. REST-Antworten nutzen typischerweise das JSON-Format, das leichtgewichtig, menschenlesbar und universell unterstützt ist. Antworten enthalten Statuscodes, die Erfolg (200, 201) oder Fehler (400, 401, 403, 404, 500) anzeigen und damit eine robuste Fehlerbehandlung ermöglichen. REST hat Einschränkungen bei komplexen Anwendungsfällen: Over-Fetching (zu viele Daten werden geladen), Under-Fetching (mehrere Anfragen nötig, um alle erforderlichen Daten zu erhalten) und das Fehlen von Echtzeit-Funktionen (für Ereignisse Webhooks oder WebSockets verwenden). GraphQL behebt einige dieser Schwächen bei komplexen Datenanforderungen.
Wie GAIA verwendet REST-API
GAIA kommuniziert hauptsächlich über REST-APIs mit seinen mehr als 50 Integrationen. Gmail, Google Kalender, Notion, Slack, Linear, GitHub und die meisten anderen verbundenen Dienste stellen REST-APIs bereit, die GAIA abfragt, um Daten zu lesen, Einträge zu erstellen und Aktionen auszulösen. MCP (Model Context Protocol) bietet eine standardisierte Schicht über diesen REST-APIs für die Agenten-Tools von GAIA.
Verwandte Konzepte
API-Integration
API-Integration ist der Prozess, verschiedene Softwareanwendungen über deren Programmierschnittstellen (APIs) miteinander zu verbinden, um einen nahtlosen Austausch von Daten und Funktionen zu ermöglichen.
Webhook
Ein Webhook ist ein HTTP-Callback-Mechanismus, bei dem ein System eine automatisierte HTTP-Anfrage an eine festgelegte URL sendet, sobald ein definiertes Ereignis eintritt. So wird die Integration und Benachrichtigung zwischen Diensten in Echtzeit ermöglicht – ganz ohne Abfragen.
OAuth
OAuth (Open Authorization) ist ein offener Standard für delegierte Autorisierung, der es Drittanwendungen erlaubt, auf Nutzerdaten in einem anderen Dienst zuzugreifen, ohne dass die Nutzer ihr Passwort weitergeben müssen.
Model Context Protocol (MCP)
Das Model Context Protocol (MCP) ist ein offener Standard, der es KI-Modellen ermöglicht, sich sicher über eine einheitliche Schnittstelle mit externen Tools, Datenquellen und Diensten zu verbinden.
