Возвращает список диалогов пользователя.
Для вызова функции требуется привилегия messages.
| Имя | Тип | Описание |
|---|---|---|
| uid | unsigned int64 | идентификатор пользователя; обязательный параметр |
| offset | int | отступ от последней записи; по-умолчанию 0 |
| limit | int | максимальное количество записей в выдаче; по-умолчанию 10; максимум 1000 |
Возвращает диалоги в обратном хронологическом порядке (последние сначала).
Формат ответа для json-выдачи (результат для xml аналогичен):
[
{
"incoming": 3, // количество входящих сообщений
"outgoing": 2, // количество исходящих сообщений
"unread": 0, // количество непрочитанных сообщений
"time": 1279882541, // время последнего сообщения в формате unixtime
"user": { // корреспондент
// объект, аналогичный результату выдачи users.getInforest
},
},
...
]
| Код | Описание |
|---|---|
| 1 | Unknown error: Please resubmit the request. |
| 2 | Unknown method called. |
| 3 | Service Unavailable. Please try again later. |
| 4 | Method is deprecated. |
| 100 | One of the parameters specified is missing or invalid. |
| 102 | User authorization failed: the session key or uid is incorrect. |
| 103 | Application lookup failed: the application id is not correct. |
| 104 | Incorrect signature. |
| 105 | Application is not installed for this user. |
| 200 | Permission error: the application does not have permission to perform this action. |
http://www.appsmail.ru/platform/api?method=messages.getThreadsList& app_id=123456&session_key=551fd0e4779e35859dfccd03397dc8a0& sig=95a393ed7639184a52f7a17b6771a92&offset=20&limit=30
Пример ответа в формате JSON
[
{
"outgoing": 2,
"unread": 0,
"time": 1279882541,
"incoming": 3,
"user": {
"link": "http://my.mail.ru/mail/ivanivanov/",
"location": {
"country": {
"name": "Россия",
"id": "24"
},
"city": {
"name": "Москва",
"id": "25"
},
"region": {
"name": "Москва",
"id": "999999"
}
},
"uid": "12345678901234567890",
"nick": "Петя",
"sex": 0,
"is_online": 0,
"pic_small": "http://avt.appsmail.ru/mail/ivanivanov/_avatarsmall",
"pic_big": "http://avt.appsmail.ru/mail/ivanivanov/_avatarbig",
"pic": "http://avt.appsmail.ru/mail/ivanivanov/_avatar",
"last_name": "Иванов",
"birthday": "14.03.1975",
"first_name": "Иван"
}
}
]
Пример ответа в формате XML
3
2
0
14.03.1975
Иван
0
Иванов
http://my.mail.ru/mail/ivanivanov/
Москва
25
Россия
24
Москва
999999
Петя
http://avt.appsmail.ru/mail/ivanivanov/_avatar
http://avt.appsmail.ru/mail/ivanivanov/_avatarbig
http://avt.appsmail.ru/mail/ivanivanov/_avatarsmall
0
12345678901234567890