Passer au contenu principal
GET
Obtenez les messages ou les conversations pour une plateforme de messagerie. Les délais de récupération diffèrent selon les réseaux sociaux. Sur Facebook et Instagram, les messages sont disponibles via Ayrshare en temps réel. Sur X/Twitter, il y a un délai pouvant aller jusqu’à 3 minutes pour voir les nouvelles mises à jour de messages. Veuillez contacter le support pour en savoir plus sur le Plan Enterprise si vous avez besoin d’un accès en temps réel aux messages X/Twitter.
Mise en cache des réponses : les réponses GET messages sont mises en cache pour optimiser les performances. Pour Facebook et Instagram, les réponses sont mises en cache pendant 60 secondes. Pour X/Twitter, les réponses sont mises en cache pendant 15 secondes afin de mieux prendre en charge le polling. Les champs lastUpdated et nextUpdate dans la réponse indiquent le moment où les données ont été récupérées pour la dernière fois et le moment où de nouvelles données seront disponibles.
La récupération initiale de l’historique des messages pour Facebook et Instagram est limitée aux 20 derniers messages. Veuillez consulter la section Récupération de l’historique des messages pour Facebook et Instagram pour plus d’informations.

Paramètres d’en-tête

Paramètres de chemin

platform
string
requis
La plateforme pour obtenir le message : facebook, instagram, twitter

Paramètres de requête

status
string
défaut:"active"
requis
Retourne les conversations actives ou les conversations archivées. Valeurs : active ou archived.
conversationId
string
Retourne uniquement la conversation spécifique.
conversationsOnly
boolean
défaut:false
Retourne toutes les conversations. Si true, le champ conversationId est ignoré.
limit
integer
X/Twitter uniquement. Limite le nombre de messages renvoyés par requête (1–100). Permet un polling efficace sans synchronisation complète de l’historique. À utiliser avec next pour la pagination. S’il est omis, le comportement par défaut (récupération complète des messages) est utilisé.
next
string
X/Twitter uniquement. Curseur de pagination chiffré retourné par le champ meta.pagination.next d’une requête précédente. À utiliser avec limit pour récupérer la page de résultats suivante.