GET graph.user.chats
Получение информации о всех чатах
Название | Обязательный | Тип | Значение по умолчанию | Описание |
---|---|---|---|---|
marker | Нет | | Маркер для постраничной выгрузки данных | |
count | Нет | | 50 | Количество запрашиваемых чатов |
Метод позволяет получать данные о всех чатах группы. Чаты отсортированы в порядке убывания времени последнего действия в чате.
Для постраничной выгрузки используется параметр marker. При первом запросе он не указывается, при каждом следующем запросе его значение берется из предыдущего ответа метода. Если в ответе метода отсутствует marker, то это означает, что больше чатов для загрузки нет.
В случае, если вам известен ID вашего чата, желательно при работе с API использовать метод /me/chat.
Пример запроса
https://api.ok.ru/graph/me/chats
?access_token=tkn18YdUJZe:CQABPOJKAKEKEKEKE
&count=1
?access_token=tkn18YdUJZe:CQABPOJKAKEKEKEKE
&count=1
Ответ
{
"chats": [ /* Массив чатов той же структуры, что и в ответе на /me/chat */
{
"type": "GROUP_CHAT", /* тип чата [GROUP_CHAT, DIALOG, CHAT] */
"status": "ACTIVE", /* Статус пользователя относительно чата [ACTIVE, LEFT, REMOVED] */
"title": "Some chat title", /* Название чата */
"icon":{"url":"https://st.mycdn.me/res/i/ok_logo.png"}, /* URL иконки чата в формате jpg или png */
"participants": { /* Map пользователей-участников чата */
"user:123456789012": 1498581292941 /* Key: ID пользователя в формате user:ID, value: время последнего действия в чате */
},
"lastEventTime": 1498581292941, /* Время последнего изменения чата или сообщений в этом чате */
"chat_id": "chat:C3ecb9d02a600", /* ID чата в формате chat:id */
"owner_id": "user:123456789012", /* ID пользователя-владельца чата в формате user:id */
"group_id": "group:12345678901234" /* ID группы-владельца чата в формате group:id */
}
],
"marker": "LTE0OTcyNDMzNTYzMzM6LTE0OTcyNDMzNTYzMzM=" /* Маркер для постраничной загрузки данных о чатах */
}