Ringkasan

API Tampilan Dasar Instagram adalah API berbasis HTTP yang dapat digunakan aplikasi untuk mendapatkan profil pengguna, gambar, video, dan album Instagram.

Komponen

URL Dasar

• api.instagram.com — untuk mendapatkan Token Akses Pengguna Instagram
• graph.instagram.com — untuk mendapatkan profil pengguna dan media Instagram

Versi

API mendukung protokol versi dan siklus rilis yang sama dengan Graph API Facebook. Versi baru dirilis kira-kira setiap 3 bulan dan setiap versi akan tersedia selama kurang lebih 2 tahun sebelum dihentikan.

Untuk membuat kueri versi API tertentu, sertakan nomor versi di jalur kueri setelah URL dasar. Contoh:

https://graph.instagram.com/v11.0/10218560180051171/media

Jika Anda menghilangkan nomor versi dari permintaan Anda, permintaan akan diselesaikan ke versi yang ditentukan di bagian Dasbor Aplikasi > Pengaturan > Lanjutan > Tingkatkan Versi API.

Jendela Otorisasi

Jendela Otorisasi mengizinkan aplikasi Anda mendapatkan Kode Otorisasi dan izin dari pengguna aplikasi. Kode Otorisasi dapat ditukarkan untuk Token Akses Pengguna Instagram, yang harus disertakan saat meng-kueri profil pengguna aplikasi atau media mereka.

Untuk menerapkan Jendela Otorisasi, buka panduan Mendapatkan Token Akses.

Kode Otorisasi

Kode Otorisasi dapat ditukarkan dengan Token Akses Pengguna Instagram berdurasi singkat. Untuk mendapatkan Kode Otorisasi, terapkan Jendela Otorisasi pada aplikasi Anda. Setelah pengguna aplikasi mengautentikasi identitasnya melalui jendela, dan memberi aplikasi Anda semua izin yang diperlukan, kami akan mengarahkan pengguna kembali ke aplikasi Anda dan menyertakan Kode Otorisasi. Kemudian Anda dapat menggunakan API untuk menukarkan kode dengan Token Akses Pengguna Instagram berdurasi singkat.

Kode Otorisasi berdurasi singkat dan hanya berlaku 1 jam.

Token Akses Pengguna Instagram

Autentikasi API ditangani oleh Token Akses Pengguna Instagram yang sesuai dengan protokol OAuth 2.0. Token akses memiliki lingkup aplikasi (unik untuk pasangan aplikasi dan pengguna) dan bisa berdurasi singkat atau lama. Permintaan API yang meng-kueri pengguna Instagram atau medianya harus menyertakan Token Akses Pengguna Instagram.

Token Akses Berdurasi Singkat

Token akses berdurasi singkat berlaku 1 jam, tetapi bisa ditukarkan dengan token berdurasi lama. Untuk mendapatkan token akses berdurasi singkat, terapkan Jendela Otorisasi pada aplikasi Anda. Setelah pengguna aplikasi mengautentikasi identitasnya melalui jendela, kami akan mengarahkan pengguna tersebut kembali ke aplikasi Anda dan menyertakan Kode Otorisasi, yang kemudian dapat ditukarkan dengan token akses berdurasi singkat.

Token Akses Berdurasi Lama

Token berdurasi singkat yang belum kedaluwarsa dapat ditukarkan dengan token akses berdurasi lama yang berlaku selama 60 hari. Token berdurasi lama dapat diperbarui sebelum kedaluwarsa dengan membuat kueri endpoint GET /refresh_access_token.

Izin

Otorisasi akses data dikontrol oleh pengguna aplikasi Anda melalui penggunaan izin yang tercantum di bawah ini. Pengguna harus memberi aplikasi Anda izin ini melalui Jendela Otorisasi sebelum aplikasi Anda dapat mengakses datanya.

• instagram_graph_user_profile — mengizinkan aplikasi Anda untuk membaca node Pengguna, yang mewakili pengguna Instagram tersebut, dan edge node tersebut.
• instagram_graph_user_media — mengizinkan aplikasi Anda untuk membaca node Media, yang mewakili sebuah gambar, video, atau album, dan edge node tersebut.

Penguji Instagram dapat memberikan izin ini kepada aplikasi Anda kapan saja. Agar pengguna aplikasi tanpa peran di aplikasi Anda dapat memberikan izin ini kepada aplikasi Anda, setiap izin harus disetujui terlebih dahulu untuk Akses Lanjutan melalui proses Tinjauan Aplikasi, dan aplikasi Anda harus dalam Mode live.

Pemberian izin yang dilakukan oleh pengguna aplikasi dengan akun publik berlaku selama 90 hari. Memperbaruitoken akses berdurasi lama pengguna aplikasi akan memperpanjang pemberian izin selama 90 hari lagi jika pengguna aplikasi yang memberikan token memiliki akun publik. Namun, jika akun pengguna aplikasi privat, pemberian izin tidak dapat diperpanjang dan pengguna aplikasi harus kembali memberikan izin yang kedaluwarsa tersebut ke aplikasi Anda.

Penguji Instagram

Untuk menguji aplikasi Anda dengan seorang Pengguna Instagram, Anda harus terlebih dulu mengirimkan undangan ke akun Pengguna Instagram tersebut dan pengguna menerimanya. Undangan bisa dikirim dari bagian Penguji Instagram di tab Dasbor Aplikasi > Peran > Peran.

Undangan bisa diterima oleh Pengguna Instagram di bagian (Ikon Profil) > Edit Profil > Aplikasi dan Situs Web > Undangan Penguji pada situs web atau aplikasi seluler Instagram setelah login ke akunnya.

Sumber Informasi

Data dalam API terdiri dari pengguna Instagram dan media mereka (gambar, video, dan album). Semua data dilindungi oleh izin; agar aplikasi Anda dapat mengakses data seorang pengguna, pengguna tersebut harus memberi aplikasi Anda izin untuk melakukannya melalui Jendela Otorisasi.

Pengguna

Pengguna Instagram dan profil mereka diwakili oleh node Pengguna. Harap diketahui bahwa ID Pengguna API Legasi Instagram tidak kompatibel dengan API Tampilan Dasar Instagram.

Media

Foto, video, dan album diwakili oleh node Media dan dibuat di masing-masing Pengguna.

Batas Laju

Semua permintaan endpoint tunduk pada Pembatasan Laju Platform dalam Graph API.

Anda dapat melihat konsumsi jumlah panggilan aplikasi Anda saat ini di tab Dasbor Aplikasi > Instagram > Pembatasan Laju Tampilan Dasar setelah menambahkan produk Instagram ke aplikasi Anda.

Jenis Aplikasi

Aplikasi yang dirancang sebagai aplikasi Bisnis tidak didukung. Jika aplikasi Anda adalah aplikasi Bisnis, gunakan Instagram Graph API, atau buatlah aplikasi nonbisnis baru.

Tinjauan Aplikasi

Penguji Instagram dapat memberikan izin Instagram kepada aplikasi Anda kapan saja. Agar pengguna aplikasi tanpa peran di aplikasi Anda dapat memberikan izin instagram kepada aplikasi Anda, setiap izin harus disetujui terlebih dahulu untuk Akses Lanjutan melalui proses Tinjauan Aplikasi, dan aplikasi Anda harus dalam Mode live.

Ketika Anda telah menyelesaikan pengembangan aplikasi dan siap untuk mengalihkan aplikasi Anda ke Mode Live, tinjau dokumentasi Tinjauan Aplikasi kami, Contoh Pengajuan, dan Alasan Penolakan Umum untuk mempelajari tentang proses Tinjauan Aplikasi. Setelah familier dengan proses, Anda dapat meminta persetujuan untuk izin API Tampilan Dasar Instagram melalui tab Dasbor Aplikasi > Produk > Instagram > Tampilan Dasar.

Jika Anda membuat aplikasi semata-mata untuk menghasilkan token akses dengan Generator Token Pengguna, Anda tidak perlu mengirim aplikasi Anda untuk Tinjauan Aplikasi. Pembuat Token Pengguna tidak memerlukan izin apa pun dan dapat digunakan saat aplikasi dalam Mode Pengembangan.

Verifikasi Bisnis

Selama aplikasi Anda dalam Mode Pengembangan, aplikasi ini hanya akan dapat mengakses data di akun Penguji Instagram. Sebelum bisa mengalihkan aplikasi Anda ke Mode Live dan mengakses data di akun non-penguji, Anda harus menyelesaikan Verifikasi Bisnis terlebih dahulu.

Cara Kerjanya

Untuk menggunakan API, pertama-tama dapatkan Jendela Otorisasi dan sajikan kepada pengguna aplikasi. Pengguna aplikasi mengautentikasi identitasnya melalui jendela dan mengotorisasi aplikasi Anda untuk mengakses data mereka dengan memberi izin tertentu kepada aplikasi Anda. Setelah diautentikasi, jendela mengarah kembali ke aplikasi Anda dan menyertakan Kode Otorisasi. Catat kode dan tukarkan dengan Token Akses Pengguna Instagram berdurasi singkat. Setelah memiliki token berdurasi singkat, Anda dapat menggunakannya untuk meng-kueri endpoint Pengguna dan Media untuk data yang sudah pengguna izinkan untuk diakses aplikasi Anda, atau tukarkan dengan token berdurasi lama.

Fitur

Pembuat Token Pengguna

Generator Token Pengguna Instagram adalah fitur yang bisa Anda gunakan untuk membuat Token Akses Pengguna Instagram berdurasi panjang dengan cepat untuk akun Instagram publik Anda. Ini berguna jika Anda menguji aplikasi dan tidak ingin menerapkan Jendela Otorisasi, atau jika Anda menggunakan kode yang bisa disalin dari layanan pihak ketiga (misalnya, untuk menampilkan data Instagram Anda di situs web Anda).

Fitur ini bekerja dengan memicu Jendela Otorisasi, yang dapat Anda masuki dengan login menggunakan akun Instagram publik yang telah Anda tetapkan sebagai akun penguji. Setelah login, fitur ini akan menghasilkan token akses berdurasi lama yang bisa Anda salin dan tempelkan. Harap diketahui bahwa token hanya bisa dibuat untuk akun Instagram publik.

Anda dapat mengakses pembuat token di tab Dasbor Aplikasi > Produk > Instagram > Tampilan Dasar.

Jika Anda membuat aplikasi semata-mata untuk menghasilkan token akses dengan Generator Token Pengguna, Anda tidak perlu mengirim aplikasi Anda untuk Tinjauan Aplikasi. Pembuat Token Pengguna tidak memerlukan izin apa pun dan dapat digunakan saat aplikasi dalam Mode Pengembangan.

Langkah Berikutnya

Ikuti panduan Memulai kami untuk mempelajari cara menyiapkan aplikasi dan melakukan permintaan API sederhana.