Завоевание Instagram с помощью PHP и API Instagram

 {%   if  login_url %} 
 < a href = "{{ login_url }}" > login with  instagram </ a > 
 {%   else   %} 
     <div> 
         < img src = "{{ data.user.profile_picture }}"  alt = "{{ data.user.username }}" > 
     </ div > 
     <ul> 
         <li> username :   {{  data . user . username }}</ li > 
         <li> bio :   {{  data . user . bio }}</ li > 
         <li> website :   {{  data . user . website }}</ li > 
         <li> id :   {{  data . user . id }}</ li > 
         <li> access token :   {{  data . access_token }}</ li > 
     </ ul > 
 {%  endif %} 

Теперь вы можете извлечь токен доступа и сохранить его в безопасном месте. Instagram не упомянул, как долго продлится токен доступа. Вся документация гласит, что срок ее действия истекает в будущем . Поэтому нам нужно обработать событие, когда срок действия токена истекает. Вы можете сделать это, проверив error_type под meta элементом в ответе. Если значение OAuthAccessTokenError , то это означает, что ваш токен доступа истек. Вам нужно будет проверить этот элемент только в том случае, если code в meta элементе имеет значение, отличное от 200. 200 означает ОК, как и код состояния HTTP. 400 означает ошибку.

Поиск по тегам

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

 $app -> get ( '/tags/search' ,   function ()   use ( $app ,  $client ,  $access_token )   { $tag =   'niagaraFalls' ; $response =  $client -> get ( "https://api.instagram.com/v1/tags/{$tag}/media/recent?access_token={$access_token}" ); $results =  $response -> json (); $app -> render ( 'images.php' ,  array ( 'results'   =>  $results )); 

 }); 

Представление images.php просто просматривает все возвращаемые результаты и извлекает URL изображения с низким разрешением. Затем мы используем это как источник для тега изображения.

 {%   for  row in  results . data %} 
     < img src = "{{ row.images.low_resolution.url }}" >  
 {%  endfor %} 

По умолчанию Instagram возвращает максимум 20 фотографий на запрос. Однако вы можете указать count качестве одного из параметров запроса, чтобы увеличить или ограничить количество возвращаемых фотографий.

Если вы не уверены, существует ли используемый вами тег, вы можете сначала выполнить поиск по тегу, а затем использовать первый полученный результат:

 $app -> get ( '/tags/search-with-tagvalidation' ,   function ()   use ( $app ,  $client ,  $access_token )   { $query =   'Niagara Falls' ; $response =  $client -> get ( "https://api.instagram.com/v1/tags/search?access_token={$access_token}&q={$query}" ); $result =  $response -> json (); 

     if (! empty ( $result [ 'data' ])){ $tag =  $result [ 'data' ][ 0 ][ 'name' ]; $response =  $client -> get ( "https://api.instagram.com/v1/tags/{$tag}/media/recent?access_token={$access_token}" ); $results =  $response -> json (); $app -> render ( 'images.php' ,  array ( 'results'   =>  $results )); 
     } else { echo 'no results' ; 
     } 

 }); 

Фид пользователей

Доступ к каналу пользователя можно получить, отправив запрос GET конечной точке /users/self/feed :

 $app -> get ( '/user/feed' ,   function ()   use ( $app ,  $client ,  $access_token )   { $response =  $client -> get ( "https://api.instagram.com/v1/users/self/feed?access_token={$access_token}" ); $results =  $response -> json (); 

 }); 

Вот снимок экрана с примером ответа пользователя:

Поиск пользователей

Давайте попробуем найти пользователей, у которых в качестве имени указано «Ash Ketchum»:

 $app -> get ( '/user/search' ,   function ()   use ( $app ,  $client ,  $access_token )   { $query =   'Ash Ketchum' ; $response =  $client -> get ( "https://api.instagram.com/v1/users/search?q={$query}&access_token={$access_token}" ); $results =  $response -> json (); 

 }); 

Вызов выше возвращает username , id , full_name и full_name пользователя. Хотя не все результаты являются точными совпадениями.

Вот скриншот ответа, который я получил:

Поиск фотографий в определенном месте

Вы также можете искать фотографии или видео, загруженные в определенном месте, с помощью API геокодирования Google. Мы используем API геокодирования Google для преобразования нашего запроса в координаты (широта и долгота), которые требуются API Instagram. Вот пример:

 $app -> get ( '/geo/search' ,   function ()   use ( $app ,  $client ,  $access_token )   { $query =   'banaue rice terraces' ; 

     //make a request to the Google Geocoding API $place_response =  $client -> get ( "http://maps.googleapis.com/maps/api/geocode/json?address={$query}&sensor=false" ); $place_result =  $place_response -> json (); 

     if ( $place_result [ 'status' ]   ==   'OK' ){ 

         //extract the lat and lng values $lat =  $place_result [ 'results' ][ 0 ][ 'geometry' ][ 'location' ][ 'lat' ]; $lng =  $place_result [ 'results' ][ 0 ][ 'geometry' ][ 'location' ][ 'lng' ]; 

         //make a request to the Instagram API using the lat and lng $response =  $client -> get ( "https://api.instagram.com/v1/media/search?access_token={$access_token}&lat={$lat}&lng={$lng}" ); $results =  $response -> json (); 

         if (! empty ( $results [ 'data' ])){ $app -> render ( 'images.php' ,  array ( 'results'   =>  $results )); 

         } else { echo 'no photos found' ; 
         } 

     } else { echo 'place not found' ; 
     } 

 }); 

Обратите внимание, что вы также можете указать distance , min_timestamp и max_timestamp до этой конечной точки для дальнейшей фильтрации результатов. Расстояние по умолчанию составляет 1 км, и вы можете указать до 5 км. min_timestamp и max_timestamp являются временными max_timestamp Unix для ограничения результатов фотографиями, которые были сделаны в течение определенного периода времени. Вы можете использовать Carbon, чтобы легко генерировать временные метки на основе пользовательских данных, таких как «вчера», «5 дней назад», «1 неделя назад».

пагинация

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

PHP клиент

Если вы хотите сделать свою жизнь еще проще при работе с Instagram API, есть библиотека PHP Instagram-PHP-API, которая предоставляет удобные методы. Чтобы установить его, запустите composer require cosenary/instagram .

Как только это будет сделано, вы можете использовать его, добавив следующий код:

 use   MetzWeb \Instagram\Instagram ; $instagram =   new   Instagram ( array ( 
     'apiKey'   =>  CLIENT_ID , 
     'apiSecret'   =>  CLIENT_SECRET , 
     'apiCallback'   =>  REDIRECT_URL )); 

Вот несколько примеров.

Получение URL для входа

 $instagram -> getLoginUrl ( array ( 'basic' ,   'relationships' )); 

Аргумент массива является необязательным. Он содержит области, которые вы хотите использовать.

Получение токена доступа

Практически так же, как мы делали ранее, используя Guzzle, только в этот раз мы вызываем методы, и данные, которые нам нужны, становятся легко доступными.

 $app -> get ( '/login2' ,   function   ()   use   ( $app ,  $instagram )   { $login_url =  $instagram -> getLoginUrl ( array ( 'basic' ,   'likes' )); 

     if (! empty ( $_GET [ 'code' ])){ $code =  $_GET [ 'code' ]; $data =  $instagram -> getOAuthToken ( $code );   //get access token using the authorization code $instagram -> setAccessToken ( $data ); $access_token =  $instagram -> getAccessToken (); 

         //do anything you want with the access token 

     } else { $app -> render ( 'login.php' ,  array ( 'login_url'   =>  $login_url )); 
     } 

 }); 

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

Вы можете получить информацию о пользователе, вызвав метод getUser . $user_id может быть опущен, если вы хотите получить только информацию о пользователе, $user_id в систему.

 $user_data =  $instagram -> getUser ( $user_id ); 

Laravel

Если вы используете Laravel, кто-то также создал Laravel Wrapper, который использует эту библиотеку. Вы можете проверить это здесь .

Вывод

В этом уроке мы узнали, как работать с API Instagram, используя HTTP-клиент Guzzle и клиент Instagram для PHP. Instagram API — это действительно хороший способ взаимодействия с данными пользователей Instagram. С его помощью вы можете создавать действительно интересные приложения.

Вы построили что-нибудь с помощью API? Вы предпочитаете Guzzle или Instagram PHP-библиотеку? Почему? Дайте нам знать об этом в комментариях!