Skip to Content

Взаимодействие приложения с API

Стандартное взаимодействие приложения с API ВКонтакте производится путем создания HTTP-запроса (POST или GET) к http://api.vkontakte.ru/api.php.

Сервер принимает не более трёх запросов в секунду, содержащих одинаковые параметры api_id и viewer_id. То есть запущенное конкретным пользователем приложение не должно отправлять более трёх запросов в секунду, в противном случае сервер возвращает ошибку "Too many requests per second". 

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

Какие параметры необходимо передавать при запросе?
Название параметра Обязательный параметр Описание
api_id - идентификатор приложения, присваивается при создании.
method - название метода API из общего списка функций.
sig - подпись, которая создается в целях безопасности. Порядок создания подписи описан ниже. 
v - версия API, текущая версия равна 2.0. 
format - формат возвращаемых данных – XML или JSON. По умолчанию XML. 
test_mode - если этот параметр равен 1, разрешает тестовые запросы к данным приложения. При этом аутентификация не проводится и считается, что текущий пользователь – это автор приложения. Это позволяет тестировать приложение без загрузки его на сайт. По умолчанию 0.

Как создавать подпись запроса?
Параметр sig равен md5 от конкатенации следующих строк: 

viewer_id – id текущего пользователя, переданный SWF посредством flashvars при инициализации. 
пар "parameter_name=parameter_value", расположенных в порядке возрастания имени параметра (по алфавиту). 
секрета приложения api_secret (секрет Вы можете менять при редактировании страницы приложения). 
 

sig = md5(viewer_idname1=value1name2=value2secret)

В данном случае sig равен md5("6492api_id=4method=getFriendsv=2.0secret") то есть b499ce268e9995a08b2f2aebff2488be 

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

http://api.vkontakte.ru/api.php?api_id=4&v=2.0&method=getFriends&sig=b499ce268e9995a08b2f2aebff2488be

В данном случае API получает запрос getFriends ("вернуть список друзей текущего пользователя"). 

Пример ответа:

<response>
<uid>1</uid>
<uid>6</uid>
<uid>6492</uid>
</response>

Ответ по умолчанию приходит в формате XML в кодировке UTF-8. 

Если же приходит сообщение об ошибке, то ответ мог бы выглядеть, например, следующим образом: 
 

<error>
<error_code>4</error_code>
<error_msg>Incorrect signature</error_msg>
<request_params list="true">
<param><key>api_id</key><value>4</value></param>
<param><key>sig</key><value>b499ce268e9995a08b2f2aebff2488be</value></param>
</request_params>
</error>

Коды ошибок

Код ошибки Описание
1 Unknown error occured. 
2 Application is disabled. Enable your application or use test mode. 
3 Unknown method passed. 
4 Incorrect signature. 
5 User authorization failed.

 

Комментарии

блин. это всё я и на сайте

блин. это всё я и на сайте контакта могу прочитать! даёшь примеры!

jHdnOF ydnswglqaycr,

jHdnOF ydnswglqaycr, [url=http://izmgsngrmteh.com/]izmgsngrmteh[/url], [link=http://wehfutmkfvkk.com/]wehfutmkfvkk[/link], http://atkzlmecgsrt.com/

HmK1V2 wgrztfvkhtdi,

HmK1V2 wgrztfvkhtdi, [url=http://hlikvjparpfc.com/]hlikvjparpfc[/url], [link=http://pmcbpdtaubjo.com/]pmcbpdtaubjo[/link], http://vrmwhadmkyub.com/

Настройки просмотра комментариев

Выберите нужный метод показа комментариев и нажмите "Сохранить установки".

Отправить комментарий