messages.getThread rest api

Возвращает сообщения в выбранном диалоге.

Для вызова функции требуется привилегия messages.

Параметры

Имя Тип Описание
uidunsigned int64идентификатор пользователя; обязательный параметр
offsetintотступ от последней записи; по-умолчанию 0
limitintмаксимальное количество записей в выдаче; по-умолчанию 10; максимум 1000

Результат

Возвращает сообщения в обратном хронологическом порядке (последние сначала).

Формат ответа для json-выдачи (результат для xml аналогичен):

[
    {
      // текст сообщения, отфильтрованный от HTML тегов
      "filtered_message": "раз два три", 
      "type": 0, // тип сообщения 0-входящее 1-исходящее
      "time": 1279882541 // время создания сообщения в формате unixtime
    },
    ...
]

Коды ошибок

КодОписание
1Unknown error: Please resubmit the request.
2Unknown method called.
3Service Unavailable. Please try again later.
4Method is deprecated.
100One of the parameters specified is missing or invalid.
102User authorization failed: the session key or uid is incorrect.
103Application lookup failed: the application id is not correct.
104Incorrect signature.
105Application is not installed for this user.
200Permission error: the application does not have permission to perform this action.

Пример вызова

http://www.appsmail.ru/platform/api?method=messages.getThread&
app_id=123456&session_key=551fd0e4779e35859dfccd03397dc8a0&
sig=95a393ed7639184a52f7a17b6771a92&offset=20&limit=30&
uid=12345678901234567890

Пример ответа в формате JSON

[
    {
      "time":1279882541,
      "filtered_message":"раз два три",
      "type":0
    },
    {
      "time":1279785758,
      "filtered_message":"234324234",
      "type":1
    },
    {
      "time":1279785408,
      "filtered_message":"5324",
      "type":1
    },
    {
      "time":1279785404,
      "filtered_message":"123",
      "type":1
    }
]

Пример ответа в формате XML


  
    раз два три
    
    0
  
  
    234324234
    
    1
  
  
    5324
    
    1
  
  
    123
    123
    
    1
  
 

См. также

Использование REST API

Функции REST API