Что такое логирование api

Что такое логирование api

В этом руководстве Вы найдете базовую информацию о принципах работы API ВКонтакте и о подготовке к его использованию. Если Вы уже работали с нашим API или с аналогичными сервисами других платформ, и знаете, какое приложение хотите создать, мы рекомендуем Вам перейти в соответствующий раздел документации.

API (application programming interface) — это посредник между разработчиком приложений и какой-либо средой, с которой это приложение должно взаимодействовать. API упрощает создание кода, поскольку предоставляет набор готовых классов, функций или структур для работы с имеющимися данными.

API ВКонтакте — это интерфейс, который позволяет получать информацию из базы данных vk.com с помощью http-запросов к специальному серверу. Вам не нужно знать в подробностях, как устроена база, из каких таблиц и полей каких типов она состоит — достаточно того, что API-запрос об этом «знает». Синтаксис запросов и тип возвращаемых ими данных строго определены на стороне самого сервиса.

Например, для получения данных о пользователе с идентификатором 210700286 необходимо составить запрос такого вида:

Рассмотрим отдельно все его составляющие.

  • https:// — протокол соединения.
  • api.vk.com/method — адрес API-сервиса.
  • users.get — название метода API ВКонтакте. Методы представляют собой условные команды, которые соответствуют той или иной операции с базой данных — получение информации, запись или удаление. Например, users.get — метод для получения информации о пользователе, video.add — метод для добавления видеозаписи в свой список, likes.delete — метод для удаления отметки «Мне нравится».

Все методы разделены на секции. Например, для работы с сообществами Вам нужны методы секции groups, для работы с фотографиями — photos, и так далее. Полный список методов по секциям доступен на этой странице.

  • ?user_ >
  • В ответ сервер вернет JSON-объект с запрошенными данными (или сообщение об ошибке, если что-то пошло не так). JSON — это формат записи данных в виде пар «имя свойства»: «значение». Если Вы раньше не встречались с этим форматом, мы рекомендуем познакомиться с ним, прежде чем продолжить чтение: JSON, Wikipedia

    Ответ на наш запрос выглядит так:

    Структура ответа каждого метода также строго задана, и при работе с API Вы заранее знаете, что в поле id придет число, а в поле first_name — строка. Такие правила оговариваются на страницах с описанием метода и соответствующих объектов, которые он возвращает в ответе. Например, users.get — здесь описаны входные параметры метода и структура его ответа, а здесь — user подробно расписано каждое поле объекта из ответа.
    Если Вы уже имеете опыт работы с JSON, Вам также может быть полезна информация о JSON схеме API ВКонтакте: JSON схема API ВКонтакте.
    Объект из ответа может быть не уникален для конкретного метода. Например, объект пользователя с набором полей, содержащих данные о его образовании, возрасте, интересах, может возвращаться в ответе от методов users.get, users.search, groups.getMembers и еще нескольких.

    Читайте также:  Как подключить спутниковый ресивер к компьютеру

    В нашем примере был использован метод users.get, для вызова которого достаточно лишь указать его входные параметры. Но чаще всего этого будет мало. Вам необходимо зарегистрировать свое приложение, чтобы использовать все возможности API ВКонтакте.

    Откройте страницу «Управление» в левом меню, затем нажмите «Создать приложение» — Вы попадете на страницу https://vk.com/editapp?act=create

    Нужно выбрать один из трех типов приложений:

    • Standalone-приложение — это API_ID для мобильного или десктопного клиента, внешнего сайта, где работа с API будет вестись из Javascript. Основная мысль в том, что запросы к API должны осуществляться с устройства пользователя. В интерфейсе приложения с таким типом доступны настройки SDK и подключение сертификатов для push-уведомлений.
    • Веб-сайт — регистрация API_ID для внешнего сайта и работы с API с сервера. Например, если Вы хотите написать скрипт на PHP с использованием API ВК, Вам нужен именно этот вариант.
    • IFrame/Flash приложение — это те самые приложения, которые Вы можете видеть в нашем каталоге https://vk.com/apps. Они загружаются непосредственно на сервер ВКонтакте (Flash) или встраиваются во фрейме с внешнего сайта.

    Если Вы пока не определились, какое приложение хотите создать, выберите первый тип ("Standalone").

    После подтверждения действия Вы попадете на страницу с информацией о приложении. Откройте вкладку «Настройки» в меню слева. Вы увидите поле "ID приложения", в котором будет указано число, например, 5490057. Это число — идентификатор приложения, он же API_ID, APP_ID, client_id, оно потребуется Вам в дальнейшей работе.

    ВКонтакте — социальная сеть, где есть дружеские связи, настройки приватности и даже черные списки. Многое зависит от того, кто просматривает страницу: кто-то увидит на ней всю ту же информацию, что и владелец, а кто-то — лишь общедоступные данные.

    В API этот принцип сохраняется. Если Вы скрыли список своих групп от не-друзей, то и через API Ваши не-друзья не должны его увидеть. Поэтому почти все методы требуют авторизации пользователя перед началом работы. Проще говоря, сервер должен знать, кто к нему обращается за информацией, чтобы предоставить ее в том же виде, что и в основной версии сайта.

    В общем случае для идентификации в API используется специальный ключ доступа, который называется access_token. Токен — это строка из цифр и латинских букв, которую Вы передаете на сервер вместе с запросом. Из этой строки сервер получает всю нужную ему информацию. Есть разные способы получения токена, более того, он может быть выдан не только пользователю, но и сообществу, и сразу всему приложению — подробнее об этом Вы можете прочитать здесь.

    Мы воспользуемся самым простым способом (Implicit flow) и получим токен для работы с API из созданного Вами на прошлом этапе приложения.

    Читайте также:  Что такое рейд в игре

    Откройте новую вкладку в браузере и введите в адресную строку такой запрос:

    Число 5490057 в запросе нужно заменить на API_ID Вашего приложения.

    Нажмите Enter. Откроется окно с запросом прав. В нем отображаются название приложения, иконки прав доступа, и Ваши имя с фамилией.

    Нажмите «Разрешить». Вы попадете на новую страницу с предупреждением о том, что токен нельзя копировать и передавать третьим лицам. В адресной строке будет URL https://oauth.vk.com/blank.html, а после # Вы увидите дополнительные параметры — access_token, expires_in и user_id. Токен может выглядеть, например, так:

    Токен — это Ваш ключ доступа. При выполнении определенных условий человек, получивший Ваш токен, может нанести существенный ущерб Вашим данным и данным других людей. Поэтому очень важно не передавать свой токен третьим лицам.

    Поле expires_in содержит время жизни токена в секундах. 86400 секунд — это ровно сутки. Через сутки полученный токен перестанет действовать, для продолжения работы нужно будет получить новый. Есть возможность получить токен без срока действия — для этого в scope добавьте значение offline. Вы можете принудительно отозвать токен (например, в том случае, если он стал известен постороннему), сбросив сеансы в настройках безопасности Вашего аккаунта или сменив пароль. Также, если речь идет о токене не из Вашего собственного приложения, можно просто удалить приложение из настроек: https://vk.com/settings?act=apps

    Поле user_id содержит id пользователя, для которого получен токен.

    Теперь Вы можете сделать вызов метода от своего имени. Например, получить список друзей, которые сейчас находятся на сайте.

    Для этого введите в адресную строку:

    и вставьте после знака "=" Ваш access_token, затем нажмите Enter. В ответе сервер вернет список идентификаторов Ваших друзей, которые сейчас онлайн. Почитать подробнее о работе этого метода можно здесь. Заметьте, Вы не указали в запросе, для какого пользователя (user_id) нужно получить список — сервер использовал значение по умолчанию, т.е. Ваш идентификатор, который он получил из токена.

    Подробное руководство о получении ключей доступа находится на этой странице.

    Как Вы уже знаете, все методы делятся на секции — friends, photos, video и так далее. Каждая секция соответствует определенному разделу на сайте. Часто приложения создаются для работы с конкретным разделом. Например, для просмотра фотографий или для редактирования видео. При этом логично, что приложению, которое работает только с аудиозаписями пользователя, не нужен доступ одновременно и к его личным сообщениям.

    Поэтому в API права доступа приложения разграничены, как и методы. Приложение может запросить доступ только к группам, а может — к группам, фотографиям и аудиозаписям. На этой странице перечислены все существующие права доступа, которые можно запросить.

    Чтобы запросить права, используйте параметр scope диалога авторизации. Когда Вы получали токен для своего приложения, в scope было указано значение friends — и в окне авторизации приложение запросило доступ к друзьям.

    Читайте также:  Словарь с русского на английский язык переводчик

    У каждого права доступа есть уникальное название ("friends", "video" и т.д.) и код (+2, +4, +4096).
    В scope можно перечислить названия нужных прав доступа (например, scope=friends,v >
    Некоторые права доступа из соображений безопасности можно запрашивать только в приложениях с типом Standalone и только в процессе авторизации Implicit Flow, обратите на это внимание.

    Вы познакомились с основными понятиями, связанными с API ВКонтакте. Дальше все зависит лишь от Вашего вдохновения.

    Конечно, на практике никто не работает с API из соседней вкладки браузера. Для этого используют самые разные языки программирования, SDK, генераторы кода. Сам механизм работы с API весьма прост, средства для отправки http-запросов и обработки ответа от сервера предусмотрены практически в любой среде разработки: а значит, возможность выбора всегда есть.

    User API – это специальная технология, благодаря которой функции ВКонтакте могут использоваться на других сайтах. Т. е. это некоторая интеграция ВКонтакте в остальную Сеть. Чем же это грозит нам? А тем, что сам ВКонтакте. ру и User API Vkontakte немного различны по функционалу. Сайт Durov.ru – творение разработчиков ВКонтакте, призванное показать всю мощь и возможности User API. Им и будем пользоваться.

    – Узнаём кто добавил нас в Закладки

    Для начала, необходимо, чтобы у Вас в настройках был включён сервис “Закладки” и хотя бы один человек был добавлен в Ваши закладки. Если это не так, то быстренько исправляем. Затем заходим на Дуров. ру. Справа вверху выбираем вкладку “Bookmarks”. И в самой нижней колонке видим “Who bookmarked me”. Это и есть люди, занёсшие Вас в закладки ВКонтакте.

    – Смотрим скрытые фотографии

    Способ основан на том, что User API отдаёт все фотографии, на которых отмечен человек. Не смотря на настройки их приватности. Т. е. не важно где они находятся (хоть в закрытой группе) – Вы всё равно увидите их, в т. ч. комментарии к фото. Для этого просто заходим на нужный профиль и выбираем “Photos with the user”. Думаем, используем по-разному.

    Очередь просмотра

    Очередь

    • Удалить все
    • Отключить

    Хотите сохраните это видео?

    • Пожаловаться

    Пожаловаться на видео?

    Выполните вход, чтобы сообщить о неприемлемом контенте.

    Понравилось?

    Не понравилось?

    Текст видео

    ПОЛУЧИ 19 ЛАЙФХАКОВ ПО ТОМУ КАК СДЕЛАТЬ РЕКЛАМУ ВКОНТАКТЕ ДЕШЕВЛЕ В 2 РАЗА ▶ http://5626.ru/KmuYO
    ПОДПИШИСЬ НА КАНАЛ ▶ http://5626.ru/youtube

    Что такое API ВКонтакте? Простое объяснение сложного вопроса или API Вконтакте для новичков ► https://www.youtube.com/watch?v=0Xdon.

    Простое руководство о том, что такое API вконтакте и зачем оно нужно.

    Ссылка на основную публикацию
    Adblock detector