跳转到主要内容
GET
获取某个消息平台的消息或会话。 不同社交网络的检索时间有所不同。在 Facebook 和 Instagram 上,消息可通过 Ayrshare 实时获得。在 X/Twitter 上,查看新消息更新最多有 3 分钟延迟。若你需要实时访问 X/Twitter 消息,请联系支持团队了解 Enterprise Plan 的详情。
**响应缓存:**GET messages 响应会被缓存以优化性能。对于 FacebookInstagram,响应缓存 60 秒。对于 X/Twitter,响应缓存 15 秒,以更好地支持轮询。响应中的 lastUpdatednextUpdate 字段指示数据上一次获取的时间以及新数据可用的时间。
对于 Facebook 和 Instagram,首次消息历史检索仅限于最近 20 条消息。详情请参阅 Facebook 和 Instagram 的消息历史检索 部分。

Header Parameters

Path Parameters

platform
string
必填
用于获取消息的平台:facebookinstagramtwitter

Query Parameters

status
string
默认值:"active"
必填
返回活跃会话或已归档会话。取值:activearchived
conversationId
string
仅返回指定的会话。
conversationsOnly
boolean
默认值:false
返回所有会话。如果为 true,则 conversationId 字段将被忽略。
limit
integer
**仅 X/Twitter。**限制每次请求返回的消息数量(1–100)。可高效轮询而无需进行完整的历史同步。与 next 配合使用以进行分页。若省略,则采用默认行为(检索完整消息)。
next
string
**仅 X/Twitter。**从上一次请求响应的 meta.pagination.next 字段返回的加密分页游标。与 limit 一起使用以获取下一页结果。