Instagram, dengan platform yang berfokus pada visual, telah menjadi alat yang ampuh bagi bisnis, pengembang, dan kreator. Untuk meningkatkan pengalaman pengguna dan memfasilitasi integrasi yang lancar, Instagram menyediakan dua alat penting: Instagram Graph API dan Instagram Basic Display API. Dalam artikel ini, kita akan fokus pada kemampuan Instagram Basic Display API dan bagaimana ia dapat dimanfaatkan untuk mengoptimalkan kehadiran Instagram Anda.
Instagram Basic Display API
Instagram Basic Display API adalah alat yang disediakan oleh Instagram (anak perusahaan Facebook) yang memungkinkan pengembang untuk mengakses informasi pengguna dasar, konten media, dan data lain dari akun Instagram. API ini dirancang khusus untuk skenario di mana akses hanya-baca ke data pengguna diperlukan, sehingga cocok untuk aplikasi yang berfokus pada menampilkan konten Instagram atau memberikan pengalaman yang dipersonalisasi.
Pengaturan sebelum mengakses API
Persyaratan:
1. Akun pengembang Facebook.
2. Akun Instagram penguji.
3. Halaman web (URL) untuk pengalihan, untuk memberikan izin bagi aplikasi untuk mengakses Instagram.
Langkah-langkah pengaturan:
- Di halaman pengembang, klik Buat Aplikasi. Pilih Lainnya untuk melanjutkan.
2. pilih pelanggan sebagai jenis aplikasi untuk Instagram basic display API
Selanjutnya, isi informasi Anda (Nama Aplikasi, email kontak) dan lanjutkan
3. Atur URL platform. Buka pengaturan > dasar, klik tambahkan platform di bagian bawah dan masukkan URL Anda (Halaman web yang disebutkan dalam persyaratan).
4. Atur Instagram Basic API di dasbor
Setelah aplikasi dibuat, formulir akan muncul dengan beberapa hal yang perlu disimpan dan diisi.
ID Aplikasi dan rahasia akan dibutuhkan nanti.
5. Masukkan URL yang sama seperti sebelumnya di Valid OAuth redirect URI, Deauthorization callback URL dan data deletion request karena aplikasi ini untuk tujuan pengujian.
Tambahkan penguji ke dalam formulir, misalnya, jika Alice ingin mengambil informasi Bob, maka masukkan nama pengguna akun Bob.
Setelah menambahkan pengguna, status pengguna akan tertunda karena otorisasi dari pengguna diperlukan. Disarankan untuk menggunakan akun penguji.
6. Masuk ke akun Instagram penguji Anda, buka pengaturan> izin situs web> Aplikasi dan Situs Web> Undangan Penguji. Terima undangan pengujian.
Pengaturan dasar selesai!
Bagaimana cara meminta otorisasi?
Kode otorisasi diperlukan sebelum menggunakan API, waktu bertahan kode otorisasi ini adalah 1 jam. Untuk mendapatkan kode, masukkan URL dalam formulir ini:
https://api.instagram.com/oauth/authorize?client_id={app-id}&redirect_uri={redirect-uri}
&scope=user_profile,user_media
&response_type=codePenjelasan untuk atribut:
App-id: Id aplikasi adalah app-id, ini dapat ditemukan di tampilan dasar di bawah aplikasi Instagram basic display.
redirect_uri: URL yang sama dengan valid OAuth redirect URI.
Ingat untuk tidak meninggalkan spasi untuk seluruh URL.
Setelah klik enter, itu akan pergi ke halaman untuk mengizinkan otorisasi.
Setelah mengizinkan semua akses, itu akan mengarahkan ke url Anda sendiri, dengan parameter kode yang dilampirkan ke url, terlihat seperti
https://www.example.com/?code=ABCD......#_
Kode otorisasi adalah yang setelah code=, ingat untuk menghapus #_ karena ini bukan bagian dari kode otorisasi.
Bagaimana cara menggunakan Apidog untuk menukar kode ke token akses?
Apidog adalah platform pengembangan API All-in-one yang memungkinkan Anda untuk dengan mudah mendesain, menguji, dan mendokumentasikan API Anda. Bagi yang ingin menguji Instagram API, menggunakan Apidog selalu menjadi solusi termudah.
Konversi kode otorisasi ke token akses
Ubah metode ke POST, masukkan URL:
https://api.instagram.com/oauth/access_token
Tambahkan parameter yang dibutuhkan ini:
- client_id = ID Aplikasi Instagram
- client_secret = Rahasia Aplikasi Instagram
- code = Kode otorisasi yang diperoleh
- grant_type = authorization_code (Nilai ini diatur)
- redirect_uri = URI Anda sendiri
Klik kirim, token akses akan dikembalikan dalam bentuk file JSON, terlihat seperti:
{
"access_token": "IGQWR9......",
"user_id": 7666070400110123
}Catatan: token juga berlaku selama 1 jam
Bagaimana cara menggunakan token akses dan ID pengguna untuk menanyakan informasi akun?
Ada banyak fitur yang dapat diambil menggunakan Instagram Display Basic API, di bawah ini adalah dua contoh pengambilan informasi.
- mengakses informasi dasar akun
Contoh permintaan menggunakan curl:
curl -X GET \ 'https://graph.instagram.com/{user-id}?fields=id,username&access_token={access-token}'Penjelasan parameter:
- User_id: dapatkan dari langkah sebelumnya
- Access_token: dari langkah sebelumnya
- Fields: dapat bersifat opsional sebagian. Ada 4 jenis bidang yang tersedia:
1. Account_type: jenis akun
2. Id: user_id
3. Media_count: jumlah postingan
4. Username: nama akunJika Anda ingin mendapatkan keempatnya, masukkan semuanya dipisahkan dengan koma (,)
Hasil kembalian:
2. Mengambil informasi postingan pengguna
Contoh permintaan:
curl -X GET \
'https://graph.instagram.com/me/media?fields=id,caption&access_token=IGQVJ...'Pengaturan di Apidog:
Untuk fitur lainnya dengan Instagram display API, lihat:
Kesimpulan
Sebagai kesimpulan, Instagram API membuka dunia kemungkinan bagi pengembang untuk berinteraksi dengan platform Instagram dan membuat aplikasi inovatif. Dari mengakses informasi pengguna dan konten media hingga memposting foto dan video baru, beragam endpoint memungkinkan pengembang untuk menyesuaikan aplikasi mereka dengan kebutuhan spesifik.
