Перейти до основного вмісту
GET
Отримайте повідомлення або розмови для платформи обміну повідомленнями. Час отримання відрізняється для кожної соціальної мережі. У Facebook та Instagram повідомлення доступні через Ayrshare у режимі реального часу. У X/Twitter є затримка до 3 хвилин перед появою нових оновлень повідомлень. Будь ласка, зверніться до служби підтримки, щоб дізнатися більше про Enterprise-план, якщо вам потрібен доступ до повідомлень X/Twitter у режимі реального часу.
Кешування відповіді: GET-відповіді повідомлень кешуються для оптимізації продуктивності. Для Facebook та Instagram відповіді кешуються 60 секунд. Для X/Twitter відповіді кешуються 15 секунд для кращої підтримки опитувань. Поля lastUpdated та nextUpdate у відповіді вказують, коли дані востаннє отримувалися і коли будуть доступні свіжі дані.
Початкове отримання історії повідомлень для Facebook та Instagram обмежене останніми 20 повідомленнями. Будь ласка, ознайомтеся з розділом Отримання історії повідомлень для Facebook та Instagram для отримання додаткової інформації.

Параметри заголовка

Параметри шляху

platform
string
обов'язково
Платформа, з якої отримати повідомлення: facebook, instagram, twitter

Параметри запиту

status
string
за замовчуванням:"active"
обов'язково
Повернути активні або архівовані розмови. Значення: active або archived.
conversationId
string
Повернути лише конкретну розмову.
conversationsOnly
boolean
за замовчуванням:false
Повернути всі розмови. Якщо true, поле conversationId ігнорується.
limit
integer
Лише X/Twitter. Обмежте кількість повідомлень, що повертаються за один запит (1–100). Дозволяє ефективне опитування без повної синхронізації історії. Використовуйте з next для пагінації. Якщо не вказано, використовується стандартна поведінка (повне отримання повідомлень).
next
string
Лише X/Twitter. Зашифрований курсор пагінації, повернутий з поля meta.pagination.next попереднього запиту. Використовуйте з limit для отримання наступної сторінки результатів.