im.getLongPollServer
Возвращает данные, необходимые для подключения к Long Poll серверу
Long Poll подключение позволит Вам моментально узнавать о приходе новых сообщений и других событий.
Результат
Возвращает объект, который содержит поля key, server, ts.
Используя эти данные, Вы можете подключиться к серверу быстрых сообщений для мгновенного получения приходящих сообщений и других событий
Используя эти данные, Вы можете подключиться к серверу быстрых сообщений для мгновенного получения приходящих сообщений и других событий
Пример запроса
Для подключения Вам нужно составить запрос следующего вида:
http://{$server}?act=a_check&key={$key}&ts={$ts}&wait=25&mode=2
При каждом ответе сервер будет возвращать новый ts, пример ответа сервера:
{ ts: 934518069, updates: [] }
Такой ответ означает, что событий не произошло, так как возвращён пустой массив updates.
После получения любого ответа для продолжения связи Вам нужно отправить новый запрос с новым ts, полученным в последнем ответе.
Первым параметром каждого события передаётся его код, вам понадобятся следующие коды событий:
Остальные события могут быть проигнорированы
Пример ответа:
{ ts: 196851352, updates: [ [ 50, 11, 1], [ 51, 1, 1 ] ] }
Время действия ключа для подключения к LongPoll серверу может истечь через некоторое время, сервер вернёт параметр failed:
{ failed: 2 }
в таком случае требуется перезапросить его.
Кроме этого, могут быть также возвращены коды ошибок 1 и 3:
{ failed: 1, ts: $new_ts }
{ failed: 3 }
В случае ошибки 1, сервер сигнализирует о том, что история за некоторый интервал времени устарела и/или была частично утеряна, и возвращает новое значение ts. Приложение в таком случае должно каким-то образом получить актуальное состояние, и далее может получать события, начиная с $new_ts. Ошибка 3 обозначает полную утерю информации о пользователе, в этом случае рекомендуется перезапросить ключ и ts, как и в случае ошибки с кодом 2.
Коды ошибок
#0неправильный access_token