Entwicklereinstellungen
Persönliche Schlüssel, App-Clients und die Verbindung eines Agenten oder der CLI: die Befehle der Seite Sofia API und welchen Sie wählen sollten.
Dieser Bereich ist der Einstieg in alles Programmatische. Die Referenzdokumentation liegt in den Tabs API, Agents und Sofia in deine App einbinden; diese Seite beschreibt die Befehle der Oberfläche. Öffnen Sie die Einstellungen, Bereich „Sofia API“.
Zugriff
Die Seite hat zwei Tabs: „Persönlicher Zugriff“ und „App-Clients“.
Ihr persönlicher Schlüssel
- Erstellen Sie den Schlüssel. „Neuer Schlüssel“: Geben Sie ihm auf Wunsch einen Namen, ein Ablaufdatum (7 Tage, 30 Tage, 90 Tage, 1 Jahr oder ohne Ablauf) und seine Berechtigungen. Alle sind standardmäßig angekreuzt; behalten Sie nur, was Ihr Tool braucht.
- Kopieren Sie ihn sofort. Er wird nur einmal angezeigt, und Sofia behält nur seinen Fingerabdruck.
- Nutzen Sie ihn. Senden Sie ihn im Header
Authorization: Bearerjedes Aufrufs. Ein Schlüssel handelt in all Ihren Betrieben, mit Ihren Rechten.
Einen KI-Assistenten verbinden
Für Claude, ChatGPT, Cursor, Gemini CLI oder Claude Code ist der Connector der verbundenen Anwendungen oft einfacher: Er braucht keinen Schlüssel. Siehe Der KI-Connector.
CLI und Agents
„Agent-Anweisungen kopieren“ liefert den Text, den Sie in Ihren Agenten einfügen, damit er die API nutzt. Der Befehl sofia, auf npm unter dem Namen sofia-post veröffentlicht, umhüllt die API, um aus einem Terminal, einem Skript oder einer geplanten Aufgabe zu veröffentlichen; seine Installation steht im Tab „Agents“.
App-Clients
Ein App-Client dient dazu, etwas zu bauen, das andere Sofia-Nutzer autorisieren, statt etwas, das wie Sie handelt.
- Erstellen Sie den Client. „Neuer Client“: ein Name, ein Logo von mindestens 180 × 180 Pixeln, die Adresse Ihrer Datenschutzerklärung, eine bis fünf Weiterleitungs-URLs über HTTPS und die Berechtigungen, die die App anfragen darf. Name und Logo werden den Personen bei der Autorisierung gezeigt.
- Kopieren Sie die Zugangsdaten. Sie erhalten eine Client ID und ein Client Secret. Ein öffentlicher Client, für eine App mit öffentlichem Code, hat kein Secret und authentifiziert sich mit PKCE; diese Wahl ist endgültig.
- Implementieren Sie den Flow. Siehe den Tab „Sofia in deine App einbinden“.
Schlüssel oder OAuth-Client?
| Kriterium | Persönlicher Schlüssel | App-Client |
|---|---|---|
| Handelt als | Sie | Die Person, die ihn autorisiert |
| Geeignet für | Ihre eigenen Skripte und Automatisierungen | Ein Produkt, das andere Sofia-Nutzer verwenden werden |
| Einrichtung | Den Schlüssel kopieren | Einen Client anlegen und den Flow implementieren |
| Zum Widerrufen | Den Schlüssel „Widerrufen“ | Die Person entzieht den Zugriff unter „Verbundene Anwendungen“, oder Sie löschen den Client |
Wenn Sie Ihre eigene Veröffentlichung automatisieren, nutzen Sie den Schlüssel. Bauen Sie einen Client nur, wenn die Konten anderer Personen im Spiel sind.
Weiterführend
- API: Endpunkte, Payloads und Einstellungen pro Netzwerk, im Tab API.
- CLI: aus einem Terminal veröffentlichen, im Tab Agents.
- KI-Connector: Claude, Cursor oder ChatGPT verbinden, siehe Der KI-Connector.