Zum Hauptinhalt springen
GET
Rufen Sie Nachrichten oder Konversationen für eine Messaging-Plattform ab. Die Abrufzeiten unterscheiden sich je nach sozialem Netzwerk. Auf Facebook und Instagram sind Nachrichten über Ayrshare in Echtzeit verfügbar. Auf X/Twitter gibt es eine Verzögerung von bis zu 3 Minuten, bis neue Nachrichten-Updates sichtbar sind. Bitte wenden Sie sich an den Support, um mehr über den Enterprise Plan zu erfahren, wenn Sie Echtzeitzugriff auf X/Twitter-Nachrichten benötigen.
Response-Caching: GET-Nachrichten-Antworten werden zur Performance-Optimierung zwischengespeichert. Für Facebook und Instagram werden Antworten 60 Sekunden lang zwischengespeichert. Für X/Twitter werden Antworten 15 Sekunden lang zwischengespeichert, um Polling besser zu unterstützen. Die Felder lastUpdated und nextUpdate in der Antwort geben an, wann die Daten zuletzt abgerufen wurden und wann neue Daten verfügbar sein werden.
Der initiale Abruf des Nachrichtenverlaufs für Facebook und Instagram ist auf die letzten 20 Nachrichten beschränkt. Weitere Informationen finden Sie im Abschnitt Abruf des Nachrichtenverlaufs für Facebook und Instagram.

Header-Parameter

Pfad-Parameter

platform
string
erforderlich
Die Plattform, für die die Nachricht abgerufen werden soll: facebook, instagram, twitter

Query-Parameter

status
string
Standard:"active"
erforderlich
Gibt aktive oder archivierte Konversationen zurück. Werte: active oder archived.
conversationId
string
Gibt nur die angegebene Konversation zurück.
conversationsOnly
boolean
Standard:false
Gibt alle Konversationen zurück. Wenn true, wird das Feld conversationId ignoriert.
limit
integer
Nur X/Twitter. Begrenzt die Anzahl der pro Anfrage zurückgegebenen Nachrichten (1–100). Ermöglicht effizientes Polling ohne vollständigen Verlaufsabgleich. Verwenden Sie dies zusammen mit next für die Paginierung. Wenn weggelassen, wird das Standardverhalten (vollständiger Nachrichtenabruf) verwendet.
next
string
Nur X/Twitter. Verschlüsselter Paginierungs-Cursor, der aus dem Feld meta.pagination.next einer vorherigen Anfrage zurückgegeben wird. Verwenden Sie ihn zusammen mit limit, um die nächste Ergebnisseite abzurufen.