API-Schnellstart

Dieser Leitfaden führt Sie von null bis zur ersten erfolgreichen Anfrage: einen persönlichen Token erstellen, die Basisadresse ermitteln und einen REST-Endpunkt aufrufen.

Schritt 1. Persönlichen Token erstellen

Öffnen Sie den persönlichen Bereich, den Abschnitt für persönliche Tokens, und erstellen Sie einen neuen Token (PAT). Kopieren Sie den Wert sofort — er wird einmal angezeigt und beginnt mit dem Präfix mbp_. Wählen Sie bei der Erstellung die Zugriffsbereiche (Scopes), die für Ihre Aufgabe ausreichen; Details im Leitfaden zur Authentifizierung.

Schritt 2. Basisadresse und Format

Alle REST-Endpunkte befinden sich unter dem Präfix /api. Es gibt keine Versionierung im Pfad. Anfrage- und Antwort-Bodies sind JSON; übergeben Sie für Anfragen mit Body den Header Content-Type: application/json. Der Token wird per Header Authorization: Bearer mbp_… übermittelt.

Schritt 3. Erste Anfrage — Bot-Liste

Prüfen Sie den Token mit einer Anfrage an Ihre Bot-Liste. Dafür benötigen Sie den Scope bots:read (oder *):

curl -H "Authorization: Bearer mbp_IHR_TOKEN" https://ihre-domain/api/bots

Als Antwort erhalten Sie ein JSON-Array mit Ihren Bots. Wenn der Token falsch oder abgelaufen ist, wird 401 mit dem Body {"error":"..."} zurückgegeben (siehe Fehler).

Schritt 4. Erste Mutation — Reaktion erstellen

Das Erstellen einer Reaktion erfordert den Scope reactions:write. Setzen Sie die Bot-ID aus Schritt 3 ein:

curl -X POST -H "Authorization: Bearer mbp_IHR_TOKEN" -H "Content-Type: application/json" -d '{"name":"Hallo","trigger":{"type":"command","value":"/start"}}' https://ihre-domain/api/bots/BOT_ID/reactions

Eine erfolgreiche Antwort gibt die erstellte Reaktion mit ihrer id zurück. Die genauen Body-Felder finden Sie in der interaktiven Referenz — sie generiert fertige Beispiele für curl, JavaScript und Python für jeden Endpunkt.

Schritt 5. Weiter — über die Referenz

Sobald der Token funktioniert, erkunden Sie den Rest am bequemsten in der interaktiven Referenz: dort sind die vollständige Endpunkt-Liste, erforderliche Scopes, Body-Schemata und die Schaltfläche „Try it" zu finden.

Nächste Schritte