GET graph.user.chats ✎ Дополнить на GitHub

Получение информации о всех чатах

НазваниеОбязательныйТипЗначение по умолчаниюОписание
marker Нет String

Маркер для постраничной выгрузки данных
При первом запросе указывать не требуется, для последующих запросов маркер берется в ответе метода

count Нет Integer 50

Количество запрашиваемых чатов
От 1 до 100

Метод позволяет получать данные о всех чатах группы. Чаты отсортированы в порядке убывания времени последнего действия в чате.

Для постраничной выгрузки используется параметр marker. При первом запросе он не указывается, при каждом следующем запросе его значение берется из предыдущего ответа метода. Если в ответе метода отсутствует marker, то это означает, что больше чатов для загрузки нет.

В случае, если вам известен ID вашего чата, желательно при работе с API использовать метод /me/chat.

Пример запроса

https://api.ok.ru/graph/me/chats?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="          /* Маркер для постраничной загрузки данных о чатах */
}