Unlimited WordPress themes, graphics, videos & courses! Unlimited asset downloads! From $16.50/m
Advertisement
  1. Code
  2. APIs
Code

Введение в API Instagram

by
Difficulty:IntermediateLength:MediumLanguages:

Russian (Pусский) translation by Ilya Nikov (you can also view the original English article)

Instagram API

Это первый учебник из серии об API Instagram. Instagram - мобильная служба социальной фотографии, основанная в 2010 году и приобретенная Facebook за 1 миллиард долларов в 2012 году. Вот как вы строите стартап!

По данным Pew Research, 26% всех онлайн-взрослых используют Instagram. Кроме того, «примерно половина интернет-пользователей молодых людей в возрасте 18-29 лет (53%) использует Instagram. И половина пользователей (49%) ежедневно пользуются сайтом ».

Pew Internet Social Media Usage 2014

Популярность, вездесущность и визуальная красота Instagram делают его привлекательным и интересным API для разработчиков. Я написал более 90 руководств для Tuts +, и, безусловно, одной из самых интересных была часть Instagram моей предыдущей серии из двух частей, Определение свидетелей сцены с потенциальными преступлениями с помощью социальных медиа. В этом учебнике мы нашли свидетелей для видеосъемки Макклемора, которая была более двух лет назад:

Instagram API Eyewitness Tutorial Macklemore arrives

В этом уроке я расскажу вам о том, что вы можете сделать с помощью API Instagram и как начать с ним работу. В будущих эпизодах я расскажу вам о различных полезных сценариях, которые используют API. В каждом эпизоде я предоставил репозиторий с образцом кода с моим любимым PHP фреймворком, Yii. Вы можете узнать больше о Yii здесь и в моей серии статей Программирование с Yii2 (Tuts +).

Я участвую в обсуждениях ниже. Если у вас есть вопрос или предложение, пожалуйста, напишите комментарий ниже. Вы также можете связаться со мной в Twitter @reifman или отправить мне электронное письмо.

Что вы можете сделать с помощью API Instagram?

Помимо поиска очевидцев, существует множество других вещей, которые вы можете сделать с помощью универсального и мощного API Instagram. Ознакомьтесь с 8 способами использования API Instagram. Они также ссылаются на некоторые интересные сторонние службы, уже использующие API:

  • Instaprint предоставляет подключенный к Instagram фотопринтер для ваших событий.
  • Eventstagram обеспечивает публичное отображение и совместное использование материалов Instagram на ваших мероприятиях.
  • Casetify позволяет печатать пользовательские обложки устройств из учетной записи Instagram.

Как API-интерфейсы веб-сервисов, API Instagram является надежным, и по моему опыту работает очень хорошо (лучше, чем Twitter). Я начну с общего обзора API, прежде чем углубляться в детали.

Instagram API Documentation Overview and Endpoints

Давайте рассмотрим конечные точки.

Конечные точки

Конечные точки Instagram представляют собой множество URL-адресов веб-служб, основанных на REST, для доступа к большей части общей функциональности Instagram.

Пользователи

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

Instagram API Example Users Endpoint Get Recent Media

Отношения

Instagram API Relationship Endpoints

Конечная точка отношений позволяет вам извлекать списки фолловеров (как подписчиков так и тех, на кого вы подписаны), а также отвечать на запросы отношений и вносить изменения в отношения.

Медиа

С конечной точкой Media вы можете получить информацию о фотографии или видео Instagram. Она также предоставляет возможности геопоиска для медиа, размещенных с определенного времени и места, как это было сделано в уроке Определение свидетелей сцены с потенциальными преступлениями с помощью API социальных медиа. Она также позволяет извлекать популярные сообщения Instagram.

Вот фрагмент кода JSON для примера ответа на запрос https://api.instagram.com/v1/media/popular?access_token=ACCESS-TOKEN:

Комментарии, Лайки и Теги

Как и следовало ожидать, конечные точки Комментарии, Лайки и Теги позволяют перечислять комментарии, лайки и теги для элементов мультимедиа, а также применять (или не указывать) их на носители.

Например, вот пример ответа на запрос для медиа с тегом «снег» с использованием конечной точки https://api.instagram.com/v1/tags/snow/media/recent?access_token=ACCESS-TOKEN:

Locations

API-интерфейсы социальных сервисов, такие как Twitter и Instagram, имеют свои собственные базы данных Place. Instagram называет их Locations. Конечные точки местоположения позволяют вам искать идентификаторы местоположений в службе Instagram по координате GPS и находить медиаданные, размещенные из этих идентификаторов местоположения.

Вот пример запроса для известных мест (или мест) вблизи GPS-координат Эйфелевой башни:

Instagram API Location Search

Instagram возвращает свои идентификаторы локального местоположения для известных мест поблизости. Например, вы можете использовать это с другими запросами местоположения, чтобы найти сообщения из ресторана 58 Tour Eiffel.

Аутентификация

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

Вот пример использования OAuth из консоли API (описано ниже):

Instagram OAuth Authentication Example

Доступ по умолчанию для OAuth доступен только для чтения, но Instagram позволяет попросить пользователя добавить другие разрешения через эти области:

  • Комментарии: для создания или удаления комментариев от имени пользователя (это разрешение распространяется только на одобренные приложения).
  • Отношения: подписаться на и отменить подписку от имени пользователя.
  • Лайки: лайк и дизлайк от имени пользователя.

Вы можете больше узнать о реализации OAuth от Instagram или дождаться предстоящих эпизодов этой серии.

Службы реального времени

С помощью API-интерфейса Instagram Real-Time вы можете подписаться на события для мониторинга активности в реальном времени для пользователей, тегов, местоположений (идентификаторы собственных мест Instagram) и областей GPS:

  • Users: получать уведомления, когда пользователи, зарегистрировавшиеся в вашем приложении, публикуют новые фотографии. Для этого требуется аутентификация с вашим приложением.
  • Теги: получать уведомления, когда новая фотография помечена тегами по вашему выбору.
  • Locations: получать уведомления, когда новые фотографии публикуются и помечены определенным местом (идентификатор места).
  • География: получение уведомлений при отправке новых фотографий в произвольном географическом местоположении, определяемом центральной точкой и радиусом.

Для доступа в режиме реального времени Instagram предлагает использовать Tornado на основе Python или Node.js. Так же вы можете использовать Phirehose, в режиме реального времени на PHP.

Для обновлений в реальном времени вы регистрируете конечную точку обратного вызова самостоятельно, например, URL. Ниже приведен пример публикации подписки с Instagram на конечную точку обратного вызова:

Первое - это новый медиа пост от пользователя, на которого вы подписаны. Второе - новый медиа-пост для подписки на тег.

Консоль API

Чтобы помочь вам начать работу и отладку, Instagram имеет консоль API на базе Apigee:

Apigee API console

Вы также можете делиться и вставлять результаты:

Отчеты об ошибках

После регистрации в качестве разработчика вы можете легко сообщить о проблемах API команде Instagram:

Instagram API Report an Issue

Какие платформы поддерживает API-интерфейс Instagram?

Вы можете получить доступ к API Instagram на любой платформе, используя конечные точки REST. Instagram предоставляет библиотеки для Python и Ruby. Packagist предлагает ряд библиотек сообщества для Instagram для PHP. IBM также имеет руководство по использованию ванильного PHP с Instagram.

Правила

Условия эксплуатации

Пользователи Instagram сохраняют право собственности на свои фотографии и видео. Поскольку авторское право настолько важно для авторского права, Instagram говорит: «Вы несете ответственность за то, что соблюдаете это право».

Вам также не разрешается копировать опыт приложения Instagram. Вместо этого используйте инновации.

Прежде чем вы начнете использовать API, у нас есть несколько рекомендаций, о которых мы хотели бы рассказать. Здесь вы можете ознакомиться с полными Условиями использования API.

Ограничения по скорости

Как и в любом API веб-сервиса, существуют ограничения по скорости, которые вы должны соблюдать или будете заблокированы. Например, приложения ограничены до 5000 вызовов в час.

Что дальше?

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

Пожалуйста, не стесняйтесь оставлять свои вопросы и комментарии ниже. Вы также можете связаться со мной в Twitter @reifman или отправить мне электронное письмо. Вы также можете просмотреть мою страницу инструктора Tuts +, чтобы увидеть другие мои учебники.

Ссылки по теме

Advertisement
Advertisement
Advertisement
Advertisement
Looking for something to help kick start your next project?
Envato Market has a range of items for sale to help get you started.