GetMyBot-Wissensdatenbank

API-Schnellstart

Wie ein Programm Ihre Bots auflistet und eine Reaktion erstellt: Token, erste Anfrage und curl-Beispiele.

Auf dieser Seite

Über die API kann Ihr Programm GetMyBot bedienen: Bots auflisten, Reaktionen anlegen oder Daten lesen. Dieses Beispiel richtet sich an Integrationsentwickler. Für die gewöhnliche Einrichtung nutzen Sie den visuellen Builder.

Erstellen Sie zuerst einen persönlichen Token als Zugangsschlüssel. Senden Sie dann eine HTTP-Anfrage an die Adresse der Operation, den Endpoint. Die folgenden curl-Befehle laufen im Terminal. Ersetzen Sie https://ihre-domain durch die Adresse Ihrer GetMyBot-Installation.

Schritt 1: Persönlichen Token erstellen

Erstellen Sie im persönlichen Bereich einen neuen PAT. Kopieren Sie ihn sofort: Der Wert wird einmal angezeigt und beginnt mit mbp_. Wählen Sie die nötigen Scopes, also Berechtigungen für die benötigten Vorgänge. Siehe Authentifizierung.

Schritt 2: Basisadresse und Format

REST-Endpoints liegen unter /api, ohne Versionsnummer im Pfad. Anfragen und Antworten verwenden JSON. Für Anfragen mit Körper senden Sie Content-Type: application/json. Der Token steht im Header Authorization: Bearer <PERSÖNLICHER_TOKEN>. Ersetzen Sie den ganzen Platzhalter samt spitzen Klammern durch den vollständigen Token einschließlich mbp_; fügen Sie das Präfix nicht noch einmal hinzu.

Schritt 3: Erste Anfrage, Bot-Liste

Für die Liste Ihrer Bots brauchen Sie bots:read oder *:

curl -H "Authorization: Bearer <PERSÖNLICHER_TOKEN>" https://ihre-domain/api/bots

Die Antwort ist ein JSON-Array von Bots. Ein ungültiger oder abgelaufener Token führt zu 401 mit {"error":"..."}. Siehe API-Fehler.

Schritt 4: Erste Änderung, Reaktion erstellen

Eine Mutation ändert Daten. Dieses Beispiel erzeugt eine Reaktion im gewählten Bot. Verwenden Sie ein Projekt, in dem Sie diese Reaktion brauchen. Nötig ist reactions:write; setzen Sie die Bot-ID aus Schritt 3 ein:

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

Bei Erfolg erhalten Sie die Reaktion mit ihrer id. Die genauen Felder nennt die interaktive Referenz, die für jeden Endpoint Beispiele in curl, JavaScript und Python erzeugt.

Schritt 5: Weitere Endpoints finden

In der interaktiven Referenz finden Sie Adressen, nötige Scopes, Anfragefelder und die Schaltfläche Try it für einen Testaufruf.

Erste Managed-AI-Anfrage

Erstellen Sie einen PAT mit managed_ai:invoke. Der Wert von Idempotency-Key kennzeichnet eine Operation. Bei Wiederholung derselben Anfrage behalten Sie Schlüssel und Körper bei; für eine neue Operation wählen Sie einen neuen Schlüssel.

curl -X POST https://ihre-domain/api/v1/ai/responses \
  -H "Authorization: Bearer <PERSÖNLICHER_TOKEN>" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: ai-demo-0001" \
  -d '{"profile":"balanced","provider":"auto","input":[{"role":"user","content":[{"type":"input_text","text":"Fasse den Dialog kurz zusammen"}]}],"max_output_tokens":300}'

Wenn Ihre Integration Managed AI oder Meta anbietet, fragen Sie zuerst /api/public/capabilities ab. Die Antwort nennt, ob die Funktion auf dieser Installation eingeschaltet ist. Eine ausgeschaltete Funktion ist kein Netzwerkfehler: Blenden Sie sie aus oder zeigen Sie „nicht verfügbar“ an.

Weiterführende Artikel