Freigabe-Workflow
Wenn Ihr Veröffentlichungs-Workflow eine Freigabe vor dem Versand eines Beitrags erfordert, setzen Sie das FeldrequiresApproval auf true.
Dies entspricht einem Pausieren des Beitrags, bis der Parameter approved auf true gesetzt wird.
Beispiel für den Freigabe-Workflow
Der Beitrag hat den Status „awaiting approval”, bis der Parameterapproved über den /post-PATCH-Endpunkt auf true gesetzt wird.
Mit Parametern veröffentlichen
Veröffentlichen Sie Ihren Beitrag über den /post-Endpunkt mit dem Feld
requiresApproval auf
true. Sie können auch Standardparameter wie scheduleDate angeben.Status ist awaiting approval
Der Beitrag hat den Status „awaiting approval” und wird zurückgehalten, bis eine Freigabe erteilt wird.
Beitrag freigeben
Aktualisieren Sie den Beitrag mit der /post-PATCH-Operation und setzen Sie das Feld
approved
auf true. Der Beitrag wird nun zum geplanten Zeitpunkt gesendet.Publish the Post with Approval
Freigabe-Workflow-Video
Ein Beispiel für den Freigabe-Workflow sehen Sie im folgenden Video.Auto-Hashtags
Fügen Sie die relevantesten Hashtags zu Ihrem Beitrag hinzu.autoHashtag ist ein Objekt oder ein Boolean – siehe unten – mit den folgenden Parametern:
max: (optional) Ganzzahl der hinzuzufügenden Hashtags, Bereich 1–10. Standard: 2.position: (optional) String „auto” oder „end”. „auto” fügt die Hashtags innerhalb des Beitrags oder am Ende ein. „end” fügt Hashtags nur am Ende ein.
true anstelle eines Objekts.
Auto-Repost
Repostet Ihre Inhalte automatisch mehrfach in regelmäßigen Abständen und schafft so Evergreen-Content, der frisch bleibt und für Ihr Publikum sichtbar ist. Ein kostenpflichtiger Plan ist erforderlich. Parameter:repeat: (erforderlich) Die Anzahl der Male, die der Inhalt erneut gepostet wird. Muss zwischen 1 und 10 liegen.days: (erforderlich) Die Anzahl der Tage zwischen den einzelnen Reposts. Muss mindestens 2 Tage betragen.startDate: (optional) Wann der Repost-Zeitplan beginnen soll, im ISO-8601-UTC-Format. Wenn nicht angegeben, wird der erste Beitrag sofort veröffentlicht. Sie sollten den ParameterstartDateanstelle des Top-Level-ParametersscheduleDateverwenden.
Auto Repost
autoRepostId für jeden Repost.
Auto Repost Response
autoRepostId zugewiesen, um diese Serie von Beiträgen zu verfolgen.
Sie können alle Auto-Reposts eines Beitrags über den History-Aufruf mit der autoRepostId abrufen.
Wenn Sie einen Repost löschen müssen, verwenden Sie den DELETE-Aufruf mit der Post-ID.
First Comment
Fügt automatisch nach der Veröffentlichung des Beitrags einen ersten Kommentar (mit Medien) hinzu. Bei TikTok wird der Kommentar verzögert, bis die Videoverarbeitung abgeschlossen ist (siehe First-Comment-Verarbeitungszeit). Ein erster Kommentar unter Ihrem eigenen Social-Media-Beitrag kann Engagement anregen und die Tonalität der nachfolgenden Diskussion setzen.First-Comment-Verarbeitungszeit
Bei den meisten sozialen Netzwerken ist die API-Antwort verzögert, da unser System (1) warten muss, bis der ursprüngliche Beitrag vollständig veröffentlicht ist, und dann (2) den Kommentar zu diesem veröffentlichten Beitrag hinzufügen muss. Dieser sequenzielle Vorgang führt zu einer Verzögerung von etwa 20 Sekunden. TikTok wird anders behandelt. TikTok verarbeitet Videos asynchron, sodass dieid des Beitrags "pending" ist, bis das Webhook post.publish.publicly_available von TikTok die tatsächliche Video-ID auflöst (siehe TikTok-Verarbeitung). Die /post-Antwort gibt daher den TikTok-First-Comment sofort mit status: "pending" zurück, und der Kommentar wird automatisch gepostet, sobald TikTok die Verarbeitung abgeschlossen hat und das tikTokPublished-Scheduled-Action-Webhook ausgelöst wird. TikTok garantiert keine Verarbeitungszeit, daher gibt es keine feste Verzögerung.
Wichtiger TikTok-Hinweis: Damit First Comments auf TikTok ordnungsgemäß funktionieren, muss der Parameter visibility des Beitrags auf public gesetzt sein. Ein nicht-öffentliches Video erhält das Webhook publicly_available nicht, sodass sein First Comment nicht gepostet werden kann; in diesem Fall gibt Ayrshare einen Kommentar-Fehler zurück, anstatt ihn im Zustand pending zu belassen.
Idempotente Beiträge
Idempotenz ist eine optionale Funktion, die sicherstellt, dass eine Anfrage nur einmal ausgeführt wird, auch wenn sie versehentlich mehrfach gesendet wird. Beim Posten von Inhalten über die API können Sie im Anfragetext einen optionalen ParameteridempotencyKey angeben, um den Vorgang eindeutig zu identifizieren. So können Sie die Post-Anfrage sicher erneut ausführen, ohne das Risiko, Duplikate zu erzeugen.
Um Idempotenz zu nutzen, fügen Sie den Parameter idempotencyKey zum JSON-Body der /post-POST-Anfrage hinzu:
Idempotency Key
idempotencyKey sollte ein pro Benutzerprofil eindeutiger String sein. Wird für ein bestimmtes Benutzerprofil eine Anfrage mit demselben idempotencyKey gestellt, wird unabhängig vom Status des Beitrags (success, error, pending oder deleted) ein Fehler zurückgegeben, der auf einen doppelten Schlüssel hinweist.
Idempotenz hilft, die versehentliche Erstellung doppelter Beiträge beim Wiederholen fehlgeschlagener Anfragen oder bei Netzwerkproblemen zu vermeiden. Es wird jedoch weiterhin empfohlen, in Ihrer Anwendung angemessene Fehlerbehandlungs- und Retry-Mechanismen zu implementieren, um potenzielle Fehler elegant zu handhaben.
Bild- und Video-Anforderungen
Das Posten von Bildern und Videos hat für jedes Netzwerk unterschiedliche Anforderungen, aber keine Sorge. Unser System prüft Ihren Beitrag vor dem Senden, sodass Sie eine Fehlerantwort erhalten, falls etwas nicht stimmt. Details zu Bild- und Video-Richtlinien finden Sie unter dem folgenden Link.Bild- und Video-Richtlinien
Gültige URL
Stellen Sie sicher, dass Ihre Medien-URL(s) gültig sind und direkt auf die Medien zugreifen. Ein erster Test ist der Aufruf der URL in einem Browser. Wenn sich das Bild im Browser nicht laden oder herunterladen lässt, wird es wahrscheinlich fehlschlagen. Zum Beispiel funktioniert eine DropBox-URL, die die DropBox-Web-App öffnet, nicht. Wir verifizieren die Medien-URL, indem wir eineHEAD-Anfrage durchführen.
Stellen Sie sicher, dass der Hosting-Anbieter die HEAD-Anfrage nicht blockiert, sonst schlägt der Beitrag mit einem 403-Fehler fehl.
Hier ein Beispiel für eine HEAD-Anfrage an die Medien-URL:
Fetch HEAD Request
Automatisierter Medienschutz
Ayrshare enthält einen integrierten Medienschutz, der bestimmte Probleme bei der Medienübermittlung während des Postens erkennen und beheben kann. Wenn ein Beitrag erfolgreich ist, aber ein Inhaltsproblem erkannt und behoben wurde, enthält jeder betroffene Eintrag inpostIds[] ein optionales contentIssues-Objekt, mit dem Sie das zugrunde liegende Problem identifizieren und beheben können:
originMediaHostFailed in Ihren Antworten sehen, überprüfen Sie Ihre Medien-Hosting-Konfiguration. Häufige Ursachen und Lösungen finden Sie unter Meta Media Crawler blockiert.
Leerzeichen und Sonderzeichen
Wir empfehlen, in Ihren Medien-URLs Folgendes zu vermeiden:- Leerzeichen in der URL.
- URL-kodierte Leerzeichen in der URL.
- Sonderzeichen in der URL, auch wenn sie URL-kodiert sind, etwa Akzente wie é.
test .webp fehl. Wir empfehlen außerdem, keine URL-kodierten Leerzeichen wie %20 in der URL zu verwenden – dies kann bei manchen sozialen Netzwerken ebenfalls Probleme verursachen.
Und dieses Unsplash-Bild:
Dateinamen und URLs bereinigen
Sie können Ihre Dateinamen mit einem regulären Ausdruck wie/[^a-z0-9\/\.]/gi bereinigen.
Weitere Informationen
- Wenn Sie selbst hosten, stellen Sie sicher, dass die URL extern erreichbar ist und keine besonderen Berechtigungen erfordert.
- Siehe unten, wie mit Videos mit unbekannten Endungen umgegangen wird, oft signierte URLs wie bei AWS S3.
- Wenn Sie eine signierte URL wie S3 verwenden, empfehlen wir, die URL-Ablaufzeit auf mindestens 7 Tage zu setzen. So kann unser Team Sie bei Fragen zur Veröffentlichung des Beitrags unterstützen.
- Prüfen Sie mit unseren Medien-Verifikationstools, ob die Medien-URL existiert.
Download-Geschwindigkeit
Stellen Sie sicher, dass Ihr Medien-Hosting eine schnelle Verbindung hat, insbesondere die Download-Geschwindigkeit. Sie können die Leistung Ihres Medien-Hostings unter pingdom testen. Wir empfehlen mindestens eine B-Bewertung.Videoendung
Wenn Ihre URL nicht mit einer bekannten Videoendung wiemp4 endet, können Sie im Beitrag das Feld isVideo: true verwenden, um festzulegen, dass es sich bei der mediaUrl um ein Video handelt. Ayrshare versucht, den Dateityp zu ermitteln, z. B. MOV. Wir empfehlen jedoch, Ihre Videodatei explizit mit einer bekannten Endung wie mp4 zu versehen, da dies bei den sozialen Netzwerken eine höhere Erfolgsquote hat.
Nur Bild oder Video
Einige soziale Netzwerke unterstützen das Senden von Medien ohne Beitragstext. Wenn Sie keinen Beitragstext einfügen möchten, senden Sie einen leeren String:post: ""
Die folgenden sozialen Netzwerke unterstützen Beiträge ohne Text/leer: Facebook, Instagram, LinkedIn, Threads, TikTok und X/Twitter.
Bilder und Videos testen
Erwägen Sie, zufälligen Text und zufällige Bilder oder Videos zu generieren, um Ihre Tests zu beschleunigen. Sie müssen sich nicht für jeden Testbeitrag etwas Neues ausdenken!Zeilenumbrüche
Wenn Sie Zeilenumbrüche (neue Zeilen) in einem Beitrag verwenden möchten, verwenden Sie den unsichtbaren Zeilenumbruch
\u2063\n. Zum Beispiel This is a new\u2063\nline..Wir empfehlen außerdem, es in Postman zu testen, um zu sehen, wie der neue Zeilenumbruch in Ihrer bevorzugten Sprache übersetzt wird. Zum Beispiel verwendet PHP oft nur ein \n.Einige soziale Netzwerke unterstützen Zeilenumbrüche im Beitragstext derzeit nicht.Multi-Plattform-Beiträge und Medien
Diese Funktion erlaubt es Ihnen, Inhalte und Medien Ihres Beitrags in einem einzigen API-Aufruf für verschiedene soziale Netzwerke anzupassen. Sie können eindeutigen Text und/oder Bilder für jede Plattform angeben, indem Sie für die Felderpost und mediaUrls Objekte verwenden.
- Verwenden Sie eine Objektstruktur für die Felder
postund/odermediaUrls. - Geben Sie plattform-spezifische Inhalte mit den Plattformnamen als Schlüsseln an.
- Fügen Sie einen
default-Schlüssel für Inhalte hinzu, die auf Plattformen verwendet werden sollen, die nicht explizit angegeben sind.
- Instagram verwendet seinen spezifischen Text und die Bild-URL.
- Facebook verwendet seinen spezifischen Text und die Standard-Bild-URL.
- LinkedIn verwendet den Standardtext und seine spezifische Bild-URL.
Wenn Sie mehrere Bilder auf verschiedene Plattformen posten müssen, erstellen Sie separate Beiträge für jede
Plattform, anstatt diese Multi-Plattform-Struktur zu verwenden.
Profile Keys
Posten Sie im Namen eines Nutzers, indem Sie den Profile Key des Nutzers als Body-Parameter angeben und die zusätzlichen Daten in der Antwort erhalten. Business- oder Enterprise-Plan erforderlich.Profiles
Rich-Text-Beiträge
Sie können Rich Text wie „𝓗𝓮𝓵𝓵𝓸, how about a little 𝗯𝗼𝗹𝗱 𝘁𝗲𝘅𝘁 and 𝘪𝘵𝘢𝘭𝘪𝘤𝘴 𝘵𝘦𝘹𝘵 and an x₂?” hinzufügen. Sie können Rich Text in Netzwerken wie Twitter, Facebook, LinkedIn, Telegram und Instagram verwenden. Bei Reddit verwenden Sie bitte Reddit-flavored Markdown-Formatierung. HTML-Elemente werden verwendet, um die Art des Rich Text anzugeben, der in Unicode übersetzt wird. Zum Beispiel:HTML-Elemente
| HTML | Beispiel |
|---|---|
| <b>Nice One!</b> | Nice One! |
| <strong>Hello, world!</strong> | Hello, world! |
| <em>World</em> | World |
| normal <i>italics <b>bold italics</b></i> | normal italics bold italics |
| `<b>Hello</b>, world!` | Hello, world! |
| `<b>Hello</b>, world!` | Hello, world! |
| <samp>123</samp> | 𝟷𝟸𝟹 |
| <var>Hello</var> | 𝓗𝓮𝓵𝓵𝓸 |
| x<sub>2</sub> | x₂ |
| x<sup>2</sup> | x² |
CSS-Codes
| Code | Beispiel | Ergebnis |
|---|---|---|
| \u00B0 | It’s 25\u00B0C today! | It’s 25°C today! |
| \u2063\n | This is a new\u2063\nline. | This is a new line. |
Beiträge planen
Geplante Beiträge erstellen
Sie können zukünftige Beiträge planen, indem Sie den ParameterscheduleDate mit der Datum/Zeit in Zulu/UTC angeben. Zulu-Zeit, auch bekannt als Coordinated Universal Time (UTC), ist der weltweit standardisierte Zeitrahmen.
Verwenden Sie zum Beispiel das Format YYYY-MM-DDThh:mm:ssZ und senden Sie 2026-07-08T12:30:00Z.
Weitere Beispiele finden Sie unter utctime.
Wenn ein
mediaUrl mit einem geplanten Beitrag enthalten ist, muss das Medium zum geplanten
Veröffentlichungszeitpunkt verfügbar sein. Wenn der Beitrag beispielsweise für den 5. März 2026 geplant ist, muss das
Medium am 5. März 2026 verfügbar sein.Status eines geplanten Beitrags prüfen
Sie können den Status eines geplanten Beitrags auf mehrere Arten prüfen:- Richten Sie das Webhook Scheduled Action ein, um den Status des geplanten Beitrags automatisch zu empfangen. Dies ist im Business-Plan verfügbar und ist die empfohlene Methode.
- Rufen Sie den Status eines geplanten Beitrags mit dem GET-Aufruf und der Post-ID ab.
- Prüfen Sie den Status im Ayrshare-Dashboard. Wechseln Sie zunächst zum Nutzerprofil, unter dem der Beitrag veröffentlicht wurde, und gehen Sie dann zur Seite „Posts” und suchen Sie mit der Ayrshare-Post-ID.
Geplante Beiträge pausieren
Sie können geplante Beiträge, die noch nicht veröffentlicht wurden, pausieren. Das Pausieren eines geplanten Beitrags verhindert seine Veröffentlichung, bis er wieder fortgesetzt wird. Verwenden Sie den PATCH-Aufruf, um den geplanten Beitrag zu pausieren oder fortzusetzen. Beachten Sie: Wird ein Beitrag fortgesetzt und dasscheduleDate liegt in der Vergangenheit, wird der Beitrag sofort veröffentlicht. Ziehen Sie in Erwägung, das scheduleDate vor dem Fortsetzen zu aktualisieren.
Links verkürzen
Links in einem Beitrag können mit dem Ayrshare-Link-Shortener verkürzt werden. Sie können die automatische Link-Verkürzung mit dem ParametershortenLinks beim Senden eines Beitrags aktivieren. Max Pack erforderlich.
Unsplash-Bilder
Die folgenden Felder sind für den Body-Parameterunsplash verfügbar:
- Zufälliges Bild:
randomliefert ein zufälliges Unsplash-Bild. - Suchbasiertes Bild: Wert String Suchbegriff; z. B.
moneywählt ein zufälliges Bild basierend auf money aus. - Bild-IDs: Wert Array von IDs; z. B. [“HubtZZb2fCM”] des Bildes https://unsplash.com/photos/HubtZZb2fCM
Wenn Sie eine Unsplash-URL in
mediaUrls posten, achten Sie darauf, die Bildadresse zu kopieren und
nicht nur die URL. Weitere Informationen finden Sie in diesem
Beispiel.