Zum Hauptinhalt springen
Diese Anleitung ist für die Einrichtung eines einzelnen Unternehmens gedacht. Für Abonnements des Business Plan und des Enterprise Plan mit mehreren Nutzern wird eine personalisierte Integrationsanleitung bereitgestellt.

Ihre Social-Media-Konten verbinden

Melden Sie sich bei einem Ayrshare-Konto an oder registrieren Sie sich. Klicken Sie auf der Social-Account-Seite auf die sozialen Netzwerke, die Sie verbinden möchten. Bitte erteilen Sie alle Berechtigungen.

Facebook Linking Example

Ihren API Key abrufen

Ein API Key ist erforderlich, um den Zugriff auf die API-Endpunkte zu autorisieren. Dieser Schlüssel wird im Header Ihrer Anfragen verwendet und muss mit dem Schlüsselwort Bearer versehen sein. Ihr API Key befindet sich im Ayrshare-Dashboard auf der Seite API Key. Wechseln Sie bei Bedarf über die Seite User Profiles zu Ihrem ‘Primary Profile’. Von dort finden Sie die Seite API Key in der linken Seitenleiste. API Key Jeder API-Aufruf muss den API Key als Bearer-Token im Header enthalten. Fügen Sie außerdem den Content-Type application/json hinzu.
Header
Weitere Informationen finden Sie unter Authorization.

Ihren ersten API-Beitrag senden

Den Beitrag veröffentlichen

Im Folgenden finden Sie Code-Beispiele, die zeigen, wie Sie mit unserer API in verschiedenen Programmiersprachen einen Beitrag erstellen. Für eine noch einfachere Integration können Sie eines unserer vorgefertigten SDK-Pakete verwenden. Um einen Beitrag zu erstellen, benötigen Sie:
  • Ihren API Key zur Authentifizierung.
  • Den Textinhalt Ihres Beitrags.
  • Die sozialen Netzwerke, auf denen Sie posten möchten (nur Plattformen, die Sie verknüpft haben).
  • Optional: URLs von Bildern oder Videos, die Sie einbinden möchten.
Alle Beispiele verwenden den Endpunkt /post. Sehen wir uns einige Beispiele an:
Posten Sie auf X/Twitter? X erfordert Ihre eigenen API-Anmeldedaten. Fügen Sie 2 BYO-Header (X-Twitter-OAuth1-Api-Key und X-Twitter-OAuth1-Api-Secret) zu Ihrer Anfrage hinzu. Dies ist eine einmalige Einrichtung pro Ayrshare-Konto, und dasselbe Schlüsselpaar funktioniert für jedes Sub-Profil bzw. jeden Endnutzer. Details finden Sie in der Einrichtungsanleitung.
Glückwunsch! Sie haben soeben Ihren ersten Beitrag gesendet.

Antwort auf den Beitrag

Sie erhalten eine Antwort mit einem status von “success”, sobald unsere API Ihren Beitrag erfolgreich verarbeitet hat. Die Antwort enthält:
  • status: Gesamtstatus des API-Aufrufs (“success” oder “error”)
  • errors: Array etwaiger aufgetretener Fehler (leer bei Erfolg)
  • postIds: Array von Objekten mit plattformspezifischen Details:
    • Name der Plattform
    • Beitrags-ID auf dieser Plattform
    • URL zum Anzeigen des Beitrags
    • Weitere plattformspezifische Informationen
Jede Plattform im postIds-Array hat ihren eigenen Status, sodass Sie überprüfen können, welche Plattformen Ihren Beitrag erfolgreich empfangen haben. Prüfen Sie Ihre Social-Media-Seiten, um sicherzustellen, dass der Beitrag erfolgreich verarbeitet wurde und live ist. Beachten Sie, dass es bei einigen Plattformen eine leichte Verzögerung geben kann, bis Beiträge öffentlich erscheinen. Hier ist eine Beispielantwort:
Post Response
Weitere Code-Beispiele für den Aufruf der Social Media API in Node.js, Python, PHP, Golang, C# und Ruby sowie weitere großartige Funktionen finden Sie hier:

Post

Ein wenig tiefer eintauchen

Sehen wir uns Schritt für Schritt an, was bei diesem API-Aufruf passiert ist.
1

Header festlegen

Wir haben den Header „Authorization Bearer Token” (API Key) und den Content-Type json gesetzt.
2

Body-Objekt erstellen

Anschließend haben wir ein Body-Objekt erstellt:
  • Beitrag mit dem Text „Today is a great day!”.
  • Soziale Netzwerke Facebook, Instagram und LinkedIn. Sie sollten nur die Plattformen einbeziehen, die Sie auf der Social-Linkage- Seite verknüpft haben.
  • Bild in den mediaUrls hinzugefügt.
3

Den /post-Endpunkt aufrufen

Alles als HTTP POST an den /post-Endpunkt gesendet.

Bevor Sie loslegen – einige Best Practices

Lesen Sie die Dokumentation

Wir pflegen eine umfangreiche und aktuelle Dokumentation. Da Sie bereits hier sind, nehmen Sie sich etwas Zeit, um die Abschnitte der Dokumentation in der linken Navigation zu erkunden.

Fehlercodes sind wichtig

Sie müssen sie behandeln, damit Ihre Nutzer eine großartige Erfahrung haben.

Fehler

Bewahren Sie Ihren API Key sicher auf

Wir nehmen Sicherheit sehr ernst – und Sie sollten das auch tun. Sie haben die volle Kontrolle über die Verbindung zwischen Ayrshare und Ihren Social-Media-Konten. Sobald die Konten verbunden sind, wird der Ayrshare API Key zu Ihrem Authentifizierungsmittel. Bitte bewahren Sie diesen Schlüssel geheim und sicher auf.

Veröffentlichen Sie Testbeiträge

Sie können Testbeiträge mit einem zufälligen Zitat, Bild oder Video veröffentlichen, indem Sie die Parameter randomPost, randomMediaUrl und isLandscapeVideo oder isPortraitVideo im /post-Endpunkt verwenden. Wenn Sie randomPost verwenden, ist der Parameter post nicht erforderlich.
Diese Beiträge werden live auf Ihren Social-Media-Seiten veröffentlicht. Löschen Sie sie daher gegebenenfalls nach dem Testen.

Zufälliges Zitat

Senden Sie ein zufälliges Zitat zum Testen der Beitragsveröffentlichung, indem Sie randomPost: true hinzufügen. Wird mit dem /post-Endpunkt verwendet.

Zufälliges Bild

Senden Sie ein zufälliges Bild, indem Sie randomMediaUrl: true hinzufügen. Wird mit dem /post-Endpunkt verwendet.

Zufälliges Video

Senden Sie ein zufälliges Landscape-Video, indem Sie isVideo: true und isLandscapeVideo: true hinzufügen. Das Video hat die standardmäßige Landscape-Größe. Wird mit dem /post-Endpunkt verwendet.
Senden Sie ein zufälliges Portrait-Video – erforderlich für TikTok oder Facebook-/Instagram-Reels –, indem Sie isVideo: true und isPortraitVideo: true hinzufügen. Wird mit dem /post-Endpunkt verwendet.

Zufälliger Kommentar

Senden Sie einen zufälligen Kommentar zum Testen der Kommentarveröffentlichung, indem Sie randomComment: true hinzufügen. Wird mit dem /comment-Endpunkt verwendet.

Beispiel-cURL-Aufruf

Senden Sie ein zufälliges Zitat und ein Portrait-Video.

Testen Sie Ihre API-Aufrufe mit Postman

Postman ist ein hervorragendes Tool zum Testen von API-Aufrufen. Sie können sogar Code in über einem Dutzend Sprachen generieren.

Demo-Code

Wenn Sie ein Beispielprojekt in React und Node.js suchen, sehen Sie sich dieses GitHub-Repository an:

Github Social Posting Demo App

Häufige Probleme

Manchmal läuft nicht alles nach Plan, daher finden Sie hier etwas Hilfe in unserem Help Center.

Fehlerbehebung

Kontaktieren Sie uns

Wir helfen Ihnen gerne. Nutzen Sie den Chat in der rechten unteren Ecke oder schreiben Sie uns eine E-Mail.