Mulai

Tutorial ini menunjukkan kepada Anda cara mengonfigurasi aplikasi dalam Dasbor Aplikasi, mendapatkan Token Akses Pengguna Instagramberdurasi singkat, kemudian menggunakan token untuk mengkueri API untuk profil pengguna Instagram. Setelah menyelesaikan tutorial, Anda akan memiliki pemahaman dasar tentang cara mendapatkan token akses dan izin dari pengguna aplikasi Anda, serta cara melakukan kueri dasar dengan API.

Tutorial berasumsi Anda dapat melakukan permintaan cURL dasar dengan fitur baris perintah atau aplikasi seperti Postman.

Sebelum Memulai

Anda memerlukan:

• Akun Developer Facebook.
• Akun Instagram dengan media.
• Situs web publik yang Anda miliki. Ini dapat berupa situs web generik gratis seperti Halaman GitHub atau aplikasi web Heroku, atau situs web Anda sendiri.
• Fitur baris perintah seperti Terminal atau aplikasi seperti Postman yang dapat melakukan permintaan cURL.

Langkah 1: Buat Aplikasi Facebook

Buka developers.facebook.com, klik Aplikasi Saya, dan buat aplikasi baru, pilih jenis aplikasiPelanggan atau Tidak Ada.

Setelah Anda membuat aplikasi dan membuka Dasbor Aplikasi, buka Pengaturan > Dasar, gulir ke bawah halaman, dan klik Tambahkan Platform.

Pilih Situs Web, tambahkan URL situs web Anda, dan simpan perubahan. Anda dapat mengubah platform nanti jika ingin, tetapi untuk tutorial ini, gunakan Situs Web.

Langkah 2: Konfigurasi Tampilan Dasar Instagram

Klik Produk, temukan produk Tampilan Dasar Instagram, dan klik Siapkan untuk menambahkannya ke aplikasi Anda.

Gulir ke bawah halaman dan klik Buat Aplikasi Baru.

Dalam formulir yang ditampilkan, selesaikan setiap bagian menurut pedoman di bawah ini.

Nama Tampilan

Masukkan nama aplikasi Facebook yang baru saja Anda buat.

URI Pengarahan Ulang OAuth yang Valid

Masukkan URL situs web Anda. Biasanya ini adalah URI khusus yang dapat menangkap parameter string kueri, tetapi untuk tutorial ini, URL situs web Anda dapat digunakan.

Contoh: https://socialsizzle.heroku.com/auth/

Setelah Anda memasukkan URL, simpan perubahan dan periksa ulang URL itu. Kami mungkin menambahkan garis miring terbalik di belakangnya, tergantung struktur URL Anda. Salin URL secara lengkap di tempat lain karena Anda akan membutuhkannya nanti untuk mendapatkan kode otorisasi dan token akses.

URL Callback Deotorisasi

Masukkan lagi URL situs web Anda. Nantinya Anda akan harus mengganti ini dengan URL yang bisa menangani notifikasi deotorisasi, tetapi untuk tutorial ini URL situs web Anda dapat digunakan lagi.

URL Callback Permintaan Penghapusan Data

Sekali lagi, masukkan URL situs web Anda. Sama seperti URL Callback Deotorisasi, nantinya Anda akan harus mengganti ini dengan URL yang bisa menangani permintaan penghapusan data, tetapi untuk sementara ini URL situs web Anda dapat digunakan.

Tinjauan Aplikasi

Lewati bagian ini untuk sementara karena Anda tidak akan mengalihkan aplikasi ke Mode Terbit selama tutorial.

Langkah 3: Tambahkan Pengguna Uji Instagram

Buka Peran > Peran dan gulir ke bawah hingga bagian Penguji Instagram. Klik Tambahkan Penguji Instagram dan masukkan nama pengguna akun Instagram Anda lalu kirimkan undangan.

Buka browser web baru dan buka www.instagram.com, lalu masuk ke akun Instagram yang baru saja Anda undang. Buka (Ikon Profil) > Edit Profil > Aplikasi dan Situs Web > Undangan Penguji dan terima undangan.

Akun Instagram Anda sekarang dapat diakses oleh aplikasi Facebook Anda saat dalam Mode Pengembangan.

Langkah 4: Autentikasi Pengguna Uji

Buat URL Jendela Otorisasi di bawah, dengan mengganti {app-id} dengan ID aplikasi Instagram Anda (dari Dasbor Aplikasi > Produk > Instagram > Tampilan Dasar > kolom ID Aplikasi Instagram) dan {redirect-uri} dengan URL situs web yang Anda berikan pada Langkah 2 ("URI Pengarahan Ulang OAuth yang Valid"). URL harus persis sama.

https://api.instagram.com/oauth/authorize
  ?client_id={app-id}
  &redirect_uri={redirect-uri}
  &scope=user_profile,user_media
  &response_type=code

Contoh:

https://api.instagram.com/oauth/authorize
  ?client_id=684477648739411
  &redirect_uri=https://socialsizzle.herokuapp.com/auth/
  &scope=user_profile,user_media
  &response_type=code

Buka jendela browser yang baru dan muat URL Jendela Otorisasi. Halaman akan terbuka dan menampilkan nama pengguna Instagram Anda, nama aplikasi Anda, dan deskripsi izin yang diminta aplikasi Anda.

Autentikasi pengguna uji Instagram dengan masuk ke Jendela Otorisasi, lalu klik Otorisasi untuk memberi aplikasi Anda akses ke data profil Anda. Setelah berhasil, halaman akan mengarahkan Anda ke URI pengarahan ulang yang Anda masukkan pada langkah sebelumnya dan menambahkan Kode Otorisasi. Contoh:

https://socialsizzle.herokuapp.com/auth/?code=AQDp3TtBQQ...#_

Harap diketahui bahwa #_ telah ditambahkan ke akhir URI pengarahan ulang, tetapi itu bukan bagian dari kode itu sendiri. Salin kode (tanpa #_ portion) agar Anda bisa menggunakannya di langkah berikutnya.

Langkah 5: Tukarkan Kode dengan Token

Buka fitur baris perintah Anda atau aplikasi yang mendukung permintaan cURL dan kirimkan permintaan POST berikut ini ke API.

curl -X POST \
  https://api.instagram.com/oauth/access_token \
  -F client_id={app-id} \
  -F client_secret={app-secret} \
  -F grant_type=authorization_code \
  -F redirect_uri={redirect-uri} \
  -F code={code}

Ganti {app-id}, {app-secret}, {redirect-uri}, dan {code} dengan ID aplikasi Instagram Anda, kunci rahasia aplikasi Instagram, URI pengarahan ulang, dan kode yang kami kirimkan kepada Anda. Pastikan bahwa URI pengarahan ulang Anda sama persis dengan yang Anda berikan pada langkah sebelumnya, termasuk garis miring di belakang jika Dasbor Aplikasi menambahkannya saat Anda mengonfigurasi aplikasi Instagram.

Contoh:

curl -X POST \
  https://api.instagram.com/oauth/access_token \
  -F client_id=684477648739411 \
  -F client_secret=eb8c7... \
  -F grant_type=authorization_code \
  -F redirect_uri=https://socialsizzle.herokuapp.com/auth/ \
  -F code=AQDp3TtBQQ...

Setelah berhasil, API akan mengembalikan objek berenkode JSON yang berisi Token Akses Pengguna Instagram berdurasi singkat, valid untuk 1 jam, dan ID pengguna uji Instagram:

{
  "access_token": "IGQVJ...",
  "user_id": 17841405793187218
}

Salin token akses dan ID pengguna agar Anda dapat menggunakannya pada langkah berikutnya.

Langkah 6: Buat Kueri untuk Node Pengguna

Gunakan fitur baris perintah atau aplikasi Anda dan permintaan cURL di bawah ini untuk mengkueri node Pengguna untuk ID dan nama pengguna milik pengguna Anda. Ganti {user-id} dan {access-token} dengan ID dan token akses yang Anda terima pada langkah sebelumnya.

curl -X GET \
  'https://graph.instagram.com/{user-id}?fields=id,username&access_token={access-token}'

Contoh:

curl -X GET \
  'https://graph.instagram.com/17841405793187218?fields=id,username&access_token=IGQVJ...'

Atau, Anda dapat mengkueri node Saya, yang akan memeriksa token Anda, menentukan ID pengguna Instagram yang memberikan token itu, dan mengkueri Pengguna tersebut. Contoh:

curl -X GET \
  'https://graph.instagram.com/me?fields=id,username&access_token=IGQVJ...'

Setelah berhasil, API akan menanggapi dengan ID pengguna dan nama pengguna Instagram Anda:

{
  "id": "17841405793187218",
  "username": "jayposiris"
}

Langkah Berikutnya

Sekarang setelah Anda mengetahui cara mendapatkan token dan melakukan kueri dasar, bacalah panduan kami untuk mempelajari lebih lanjut tentang hal-hal yang dapat Anda lakukan dengan API.