Einführung

API-Schlüssel erhalten

Was ist Sofia API?

Sofia API gibt Ihrem Code Zugriff auf Ihr Sofia-Konto: die Betriebe Ihrer Workspaces, ihre verbundenen Netzwerke, ihre Mediathek, ihre Beiträge und ihre Statistiken. Es ist eine REST-API über HTTPS. Anfragen und Antworten sind JSON, und jeder Endpunkt liegt unter einer Basis-URL.

text
https://api.sofia-post.com/api/v1

Was kann die API?

  • Beiträge veröffentlichen: sofort, zu einem Zeitpunkt oder als Entwurf, auf einem oder mehreren Netzwerken gleichzeitig.
  • Vor dem Veröffentlichen prüfen: Ein Probelauf (Dry Run) sagt Ihnen, ob jedes Netzwerk den Beitrag akzeptieren würde, und schreibt nichts.
  • Medien verwalten: eine Datei hochladen oder von einer URL in die Mediathek eines Betriebs importieren.
  • Beiträge verfolgen: den Status jedes Netzwerks, seinen Permalink oder den Grund des Fehlschlags lesen. Ein signierter Webhook kann Sie ebenfalls benachrichtigen.
  • Statistiken lesen: die jüngsten Zahlen, die Sofia für jedes verbundene Konto gesammelt hat.
  • Netzwerke verbinden: einen gehosteten Link erstellen, über den der Inhaber ein fehlendes Netzwerk verbinden kann.

Für wen ist sie gedacht?

Wenn Sie Ihren eigenen Workspace automatisieren, genügt ein persönlicher Schlüssel: Erstellen Sie ihn unter Einstellungen › API und senden Sie ihn als Bearer-Token. Für ein SaaS-Produkt, das für seine Nutzer in deren eigenen Workspaces handelt, registrieren Sie einen OAuth-Client: Jede Person autorisiert Ihre Anwendung für den Workspace ihrer Wahl.

Nächste Schritte