├── fake_database.txt
├── config.php.sample
├── readme
    ├── api_config_setup.png
    └── fake_instagram.png
├── index.php
├── callback.php
├── view.php
├── README.md
├── http.php
└── settings-functions.php


/fake_database.txt:
--------------------------------------------------------------------------------
1 | 


--------------------------------------------------------------------------------
/config.php.sample:
--------------------------------------------------------------------------------
1 | <?php
2 | define('IG_APP_ID', '');
3 | define('IG_APP_SECRET', '');
4 | define('IG_APP_CALLBACK', '');


--------------------------------------------------------------------------------
/readme/api_config_setup.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/christinabranson/Instagram-Basic-Display-API-Simple-Integration/HEAD/readme/api_config_setup.png


--------------------------------------------------------------------------------
/readme/fake_instagram.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/christinabranson/Instagram-Basic-Display-API-Simple-Integration/HEAD/readme/fake_instagram.png


--------------------------------------------------------------------------------
/index.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | require_once 'settings-functions.php';
 4 | 
 5 | echo "<h1>Instagram Basic Display Test</h1>";
 6 | 
 7 | $login_url = getLoginURL();
 8 | 
 9 | echo "<a href=\"$login_url\">$login_url</a>";
10 | 


--------------------------------------------------------------------------------
/callback.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | require_once 'settings-functions.php';
 4 | 
 5 | if (isset($_GET['code'])) {
 6 |     $code = $_GET['code'];
 7 |     getOauthToken($code);
 8 | }
 9 | 
10 | // now let's see if we can read in our user
11 | $userData = file_get_contents('fake_database.txt');
12 | 
13 | var_dump($userData["ig_user_id"]);
14 | 
15 | getMedia($userData["ig_user_id"], $userData["ig_access_token"]);
16 | 
17 | 
18 | 


--------------------------------------------------------------------------------
/view.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | require_once 'settings-functions.php';
 3 | 
 4 | echo "<link href=\"https://stackpath.bootstrapcdn.com/bootstrap/4.4.1/css/bootstrap.min.css\" rel=\"stylesheet\" integrity=\"sha384-Vkoo8x4CGsO3+Hhxv8T/Q5PaXtkKtu6ug5TOeNV6gBiFeWPGFN9MuhOf23Q9Ifjh\" crossorigin=\"anonymous\">";
 5 | 
 6 | // now let's see if we can read in our user
 7 | $userData = file_get_contents('fake_database.txt');
 8 | 
 9 | $userData = json_decode($userData, true);
10 | 
11 | // easier to just ensure that this exists
12 | if (!isset($userData["posts"])) {
13 |     $userData["posts"] = array();
14 | }
15 | 
16 | $media = getMedia($userData["ig_access_token"], $userData["posts"]);
17 | 
18 | // now let's save our "user" to the database
19 | $fake_user_data_array = array();
20 | $fake_user_data_array["ig_user_id"] = $userData["ig_user_id"];
21 | $fake_user_data_array["ig_access_token"] = $userData["ig_access_token"];
22 | $fake_user_data_array["ig_access_token_last_updated"] = time();
23 | $fake_user_data_array["posts"] = $media;
24 | writeJsonToFile($fake_user_data_array);
25 | 
26 | foreach ($media as $media_item) {
27 |     echo "
28 |     
29 |     <div class=\"card m-2\" style=\"width: 18rem;\">
30 |   <img src=\"".$media_item["media_url"]."\" class=\"card-img-top\" alt=\"...\">
31 |   <div class=\"card-body\">
32 |     <p class=\"card-text\">".$media_item["caption"]."</p>
33 |   </div>
34 | </div>
35 | 
36 |     ";
37 | }


--------------------------------------------------------------------------------
/README.md:
--------------------------------------------------------------------------------
 1 | # Instagram Basic Display API Simple Integration
 2 | 
 3 | A simple PHP implementation of the [Instagram Basic Display API](https://developers.facebook.com/docs/instagram-basic-display-api)
 4 | 
 5 | This implementation does the following:
 6 | 
 7 | 1. index.php provides a link to authorize the implementation
 8 | 2. If authorizes, we'll be taken back to /callback.php with an attached Oauth code
 9 | 3. We then exchange the code, with a short-lived access token, then in the same step, we exchange that short-lived access token with a long-lived access token
10 | 4. Once we have our access tokens, we write a fake "user" to a very fake "database"
11 | 5. We redirect to view.php, where we look for new posts then display them
12 | 
13 | ## File Structure
14 | 
15 | 
16 | | File        | Description     |
17 | | :------------- |:-------------|
18 | | callback.php      | Part of Step 2, this function receieves the authorization code and starts the process of getting a long-lived token we can use to fetch the fun stuff|
19 | | config.php      | This is where your APP ID, APP Secret, and Callback URLS are defined. See config.php.sample for example |
20 | | config.php.sample      |  ^ |
21 | | fake_database.txt      |  We're literally just writing JSON to a file. Like I said, it's a *very* simple integration  |
22 | | http.php      |  Utility class to handle curl GET and POST requests. I re-use this class a lot  |
23 | | index.php      |  Part of Step 1, this page provides the authorization URL to get started |
24 | | settings-functions.php     |  This is the beef of the program. Defines our API endpoints, make sure our configuration is intact, makes all API calls, and adds a few helper functions |
25 | | view.php     | Part of Step 5, this would be like the "logged in" view and shows the retrieved users posts |
26 | 
27 | 
28 | 
29 | ## Screenshots
30 | 
31 | ### Config
32 | 
33 | Set up config.php with variables from API setup
34 | 
35 | ![alt text](https://raw.githubusercontent.com/christinabranson/Instagram-Basic-Display-API-Simple-Integration/master/readme/api_config_setup.png "Screenshot showing up to set up config.php")
36 | 
37 | The final result
38 | 
39 | ![alt text](https://raw.githubusercontent.com/christinabranson/Instagram-Basic-Display-API-Simple-Integration/master/readme/fake_instagram.png "Screenshot showing the final result")


--------------------------------------------------------------------------------
/http.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | require_once 'settings-functions.php';
 4 | 
 5 | /**
 6 |  * Class http
 7 |  *
 8 |  * Helper class for curl functions
 9 |  *
10 |  */
11 | class http {
12 | 
13 |     /**
14 |      * Makes a GET request with URL variables
15 |      *
16 |      * @param string $url
17 |      * @param array $data
18 |      * @param array $headers
19 |      * @return string
20 |      */
21 |     public static function get($url, $data, $headers = []) {
22 |         // build the url with the data
23 |         if (!empty($data)) {
24 |             $url .= "?" . http_build_query($data);
25 |         }
26 | 
27 |         $curl = curl_init($url);
28 |         curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1);
29 |         if (!empty($headers)) {
30 |             curl_setopt($curl, CURLOPT_HTTPHEADER, $headers);
31 |         }
32 |         curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, false);
33 | 
34 |         $response = curl_exec($curl);
35 | 
36 |         if (isJson($response)) {
37 |             $response = json_decode($response, true);
38 |         }
39 | 
40 |         return $response;
41 |     }
42 | 
43 |     /**
44 |      * Makes a GET request with URL variables
45 |      *
46 |      * @param string $url
47 |      * @param array $data
48 |      * @param array $headers
49 |      * @return string
50 |      */
51 |     public static function post($url, $data, $headers = []) {
52 |         try {
53 |             $curl = curl_init($url);
54 |             curl_setopt($curl, CURLOPT_HEADER, false);
55 |             curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, false);
56 |             curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
57 |             curl_setopt($curl, CURLOPT_FAILONERROR, false);
58 |             curl_setopt($curl, CURLOPT_HTTPHEADER, $headers);
59 |             curl_setopt($curl, CURLOPT_POST, true);
60 |             if (!empty($data)) {
61 |                 curl_setopt($curl, CURLOPT_POSTFIELDS, $data);
62 |             }
63 |             $response = curl_exec($curl);
64 | 
65 |             $status = curl_getinfo($curl, CURLINFO_HTTP_CODE);
66 |             if ($status != 200) {
67 |                 die(curl_error($curl));
68 |             }
69 |             curl_close($curl);
70 | 
71 |             $response = json_decode($response, true);
72 | 
73 |             return $response;
74 |         } catch (Exception $e) {
75 |             die($e->getMessage());
76 |         }
77 |     }
78 | }


--------------------------------------------------------------------------------
/settings-functions.php:
--------------------------------------------------------------------------------
  1 | <?php
  2 | 
  3 | require_once 'config.php';
  4 | require_once 'http.php';
  5 | define('IG_API_URL', 'https://graph.instagram.com/');
  6 | define('IG_OAUTH_URL', 'https://api.instagram.com/oauth/authorize');
  7 | define('IG_OAUTH_GET_TOKEN_URL', 'https://api.instagram.com/oauth/access_token');
  8 | define('IG_OAUTH_EXCHANGE_TOKEN_URL', 'https://graph.instagram.com/access_token');
  9 | define('IG_OAUTH_REFRESH_TOKEN_URL', 'https://api.instagram.com/refresh_access_token');
 10 | 
 11 | function confirmConfig() {
 12 |     if (!strlen(IG_APP_ID)) {
 13 |         die("IG_APP_ID must be defined");
 14 |     }
 15 | 
 16 |     if (!strlen(IG_APP_SECRET)) {
 17 |         die("IG_APP_SECRET must be defined");
 18 |     }
 19 | 
 20 |     if (!strlen(IG_APP_CALLBACK)) {
 21 |         die("IG_APP_CALLBACK must be defined");
 22 |     }
 23 | }
 24 | 
 25 | /**
 26 |  *      From https://developers.facebook.com/docs/instagram-basic-display-api/guides/getting-access-tokens-and-permissions
 27 |         https://api.instagram.com/oauth/authorize
 28 |         ?client_id={instagram-app-id}
 29 |         &redirect_uri={redirect-uri}
 30 |         &scope={scope}
 31 |         &response_type=code
 32 |         &state={state}        //Optional
 33 |  *
 34 |  * @return string
 35 |  */
 36 | function getLoginURL() {
 37 |     confirmConfig();
 38 |     $url = IG_OAUTH_URL;
 39 |     $url .= "?client_id=" . IG_APP_ID;
 40 |     $url .= "&redirect_uri=" . IG_APP_CALLBACK;
 41 |     $url .= "&scope=user_profile,user_media";
 42 |     $url .= "&response_type=code";
 43 |     return $url;
 44 | }
 45 | 
 46 | function getOauthToken($code) {
 47 |     $postData = array();
 48 |     $postData["client_id"] = IG_APP_ID;
 49 |     $postData["client_secret"] = IG_APP_SECRET;
 50 |     $postData["code"] = $code;
 51 |     $postData["grant_type"] = "authorization_code";
 52 |     $postData["redirect_uri"] = IG_APP_CALLBACK;
 53 | 
 54 |     $headers = array("Content-Type: multipart/form-data;");
 55 | 
 56 |     $url = IG_OAUTH_GET_TOKEN_URL;
 57 |     $response = http::post($url, $postData, $headers);
 58 | 
 59 |     if (isset($response["user_id"])) {
 60 |         // yay we got a response
 61 |         $ig_user_id = $response["user_id"];
 62 |         $ig_short_access_token = $response["access_token"];
 63 |         $ig_long_access_token = getLongOauthToken($ig_short_access_token);
 64 | 
 65 |         // now let's save our "user" to the database
 66 |         $fake_user_data_array = array();
 67 |         $fake_user_data_array["ig_user_id"] = $ig_user_id;
 68 |         $fake_user_data_array["ig_access_token"] = $ig_long_access_token;
 69 |         $fake_user_data_array["ig_access_token_last_updated"] = time();
 70 |         $fake_user_data_array["posts"] = array();
 71 |         writeJsonToFile($fake_user_data_array);
 72 |     }
 73 | }
 74 | 
 75 | function getLongOauthToken($short_access_token) {
 76 |     $getData = array();
 77 |     $getData["client_id"] = IG_APP_ID;
 78 |     $getData["client_secret"] = IG_APP_SECRET;
 79 |     $getData["access_token"] = $short_access_token;
 80 |     $getData["grant_type"] = "ig_exchange_token";
 81 | 
 82 |     $url = IG_OAUTH_EXCHANGE_TOKEN_URL;
 83 | 
 84 |     $response = http::get($url, $getData);
 85 | 
 86 |     if (isset($response["access_token"])) {
 87 |         return $response["access_token"];
 88 |     }
 89 | }
 90 | 
 91 | function getRefreshedOauthToken($log_access_token) {
 92 |     $getData = array();
 93 |     //$getData["client_id"] = IG_APP_ID;
 94 |     //$getData["client_secret"] = IG_APP_SECRET;
 95 |     $getData["access_token"] = $log_access_token;
 96 |     $getData["grant_type"] = "ig_refresh_token";
 97 | 
 98 |     $url = IG_OAUTH_REFRESH_TOKEN_URL;
 99 | 
100 |     $response = http::get($url, $getData);
101 | 
102 |     if (isset($response["access_token"])) {
103 |         return $response["access_token"];
104 |     }
105 | }
106 | 
107 | function getMedia($ig_access_token, $existing_data = []) {
108 |     $media_array = $existing_data;  // start with existing data
109 |     $url = IG_API_URL . "me/media?fields=id,caption&access_token=" . $ig_access_token;
110 |     $response = http::get($url, []);
111 |     if (!empty($response) && isset($response["data"])) {
112 |         foreach ($response["data"] as $post_data) {
113 | 
114 |             $ig_media_id = $post_data["id"];
115 |             if (isset($existing_data[$ig_media_id])) {
116 |                 continue;
117 |             }
118 | 
119 |             $media = getMediaByID($ig_media_id, $ig_access_token);
120 |             //$media["caption"] = $post_data["caption"];
121 |             $media_array[$ig_media_id] = $media;
122 |         }
123 |     }
124 | 
125 |     // todo: should probably add a function to order by timestamp, but that can wait
126 | 
127 |     return $media_array;
128 | }
129 | 
130 | function getMediaByID($ig_media_id, $ig_access_token) {
131 |     $url = IG_API_URL . "$ig_media_id?fields=id,media_type,media_url,username,timestamp,caption&access_token=" . $ig_access_token;
132 |     $response = http::get($url, []);
133 |     return $response;
134 | }
135 | 
136 | 
137 | /**
138 |  * Returns if valid JSON
139 |  *
140 |  * @param $string
141 |  * @return bool
142 |  */
143 | function isJson($string) {
144 |     json_decode($string);
145 |     return (json_last_error() == JSON_ERROR_NONE);
146 | }
147 | 
148 | function writeJsonToFile($jsonArray, $filename='fake_database.txt') {
149 |     try {
150 |         $fp = fopen($filename, 'w');
151 |         fwrite($fp, json_encode($jsonArray, JSON_PRETTY_PRINT));
152 |         fclose($fp);
153 |     } catch (Exception $e) {
154 |         die($e->getMessage());
155 |     }
156 | }


--------------------------------------------------------------------------------