API ВКонтакте

Авторизация

Для доступа к большинству методов требуется авторизация. Используется протокол OAuth 2.0. Разработчик регистрирует приложение в специальном разделе «ВКонтакте» для разработчиков, получает идентификатор (client_id) и секретный ключ. Пользователь предоставляет приложению доступ к определённым правам (scope), таким как доступ к друзьям, сообщениям, фотографиям. После успешной авторизации приложение получает access_token — временный ключ, который передаётся в каждом запросе.

Версионирование

Каждый запрос к API должен содержать параметр v, указывающий версию интерфейса (например, v=5.250). Версии нумеруются по дате выпуска: первые две цифры — день, три последние — номер сборки. Старые версии поддерживаются в течение нескольких лет, но разработчикам рекомендуется использовать актуальную.

Ограничения (Rate Limiting)

Для предотвращения злоупотреблений API имеет строгие лимиты на количество запросов. Основные ограничения:

• Максимум 3 запроса в секунду для большинства методов.
• Для методов, работающих с сообщениями (messages.send), — 20 запросов в секунду.
• Для методов, связанных с рекламой (ads.*), — 1 запрос в секунду.

Превышение лимита приводит к возврату ошибки с кодом 6 («Too many requests per second»). Для обхода ограничений разработчики используют паузы между запросами или пакетную обработку (execute).

Основные методы и функциональные группы

API ВКонтакте включает методы, сгруппированные по функциональным разделам. Ниже приведены основные категории.

Пользователи и друзья

• users.get — получение информации о пользователе (имя, фамилия, дата рождения, город, статус).
• friends.get — получение списка друзей пользователя.
• users.search — поиск пользователей по имени, городу, возрасту и другим параметрам.

Сообщества (группы и паблики)

• groups.get — получение списка сообществ, в которых состоит пользователь.
• groups.getById — получение информации о сообществе (название, описание, количество участников).
• wall.get — получение записей со стены сообщества.
• wall.post — публикация записи от имени сообщества (требуются права администратора).

Сообщения

• messages.send — отправка личного сообщения пользователю или в чат.
• messages.getHistory — получение истории переписки.
• messages.getConversations — получение списка диалогов.

Медиафайлы

• photos.get — получение списка фотографий пользователя или сообщества.
• photos.save — сохранение фотографии на сервер «ВКонтакте».
• video.get — получение списка видеозаписей.
• docs.get — получение списка документов.

Реклама

• ads.getAds — получение списка рекламных объявлений.
• ads.createAds — создание нового объявления.
• ads.getStatistics — получение статистики по рекламным кампаниям.

Универсальные методы

• execute — выполнение последовательности методов в одном запросе (пакетная обработка). Позволяет обойти ограничения на количество запросов, объединяя до 25 вызовов в один.
• storage.get — получение данных из облачного хранилища приложения.
• likes.getList — получение списка пользователей, поставивших отметку «Мне нравится».

Примеры использования

Получение информации о пользователе

Запрос: `` https://api.vk.com/method/users.get?user_ids=1&fields=city,bdate&access_token=TOKEN&v=5.250 ` Ответ (JSON): `json { "response": [ { "id": 1, "first_name": "Павел", "last_name": "Дуров", "bdate": "10.10.1984", "city": { "id": 2, "title": "Санкт-Петербург" } } ] } ``

Отправка сообщения

Запрос: `` https://api.vk.com/method/messages.send?user_id=12345&message=Привет!&access_token=TOKEN&v=5.250 ` Ответ: `json { "response": 12345 } ``

Инструменты для разработчиков

«ВКонтакте» предоставляет несколько инструментов для работы с API:

• VK API Console — онлайн-интерфейс для тестирования методов без написания кода. Доступен по адресу https://vk.com/dev/methods`.
• VK SDK — официальные библиотеки для языков программирования: PHP, JavaScript, Python, Java, C#. Они упрощают авторизацию, формирование запросов и обработку ошибок.
• Callback API — механизм, позволяющий получать уведомления о событиях (новые сообщения, подписки, изменения в сообществе) в реальном времени. Сервер разработчика получает POST-запросы от «ВКонтакте» при наступлении события.
• Long Poll — механизм для получения обновлений в реальном времени через постоянное соединение (WebSocket). Используется для чат-ботов и приложений, требующих мгновенной реакции.