Überblick & Authentifizierung

Astreo ist offen am Rand: REST-API, Webhooks und MCP - auf derselben gescopten Sicht.

Astreo ist offen am Rand: Sie erreichen dieselbe gescopte Sicht wie in der App auch programmatisch - über drei Wege, die sich ergänzen.

Überblick: REST, Webhooks, MCP

• REST-API - Daten lesen und Workflows anstoßen (Pull).
• Webhooks - Astreo benachrichtigt Ihr System bei Ereignissen in Echtzeit (Push).
• MCP-Server - KI-Assistenten/Agenten greifen über das Model Context Protocol zu (Entwürfe, nie Auto-Versand).

Alle drei laufen auf derselben gescopten Sicht: Ein Zugang sieht nur, was er darf.

Personal Access Tokens (PAT)

Authentifiziert wird per Personal Access Token. Sie erzeugen ein Token in den Einstellungen; es wird nur einmal angezeigt und serverseitig gehasht gespeichert. Übergib es als Bearer-Header:

Authorization: Bearer astreo_pat_xxxxxxxx

Behandeln Sie das Token wie ein Passwort. Verlorene oder kompromittierte Tokens widerrufen Sie in den Einstellungen.

Scopes & Berechtigungen

Tokens sind gescopt - sie erhalten nur die Rechte, die Sie vergeben (z. B. nur Lesen). Ein Token kann nie mehr sehen oder tun als der Nutzer, dem es gehört.

Basis-URL & Versionierung

Die öffentliche API ist versioniert. Basis-URL:

https://app.astreo.de/api/v1

Antworten sind JSON. Neue Felder können additiv hinzukommen, ohne die Version zu brechen.