Dokumen ini sudah diperbarui.
Terjemahan ke Bahasa Indonesia belum selesai.
Bahasa Inggris diperbarui: 3 Jul 2021

Token Akses Berdurasi Lama

Secara default, Token Akses Pengguna Instagram berdurasi singkat dan berlaku selama satu jam. Namun, token berdurasi singkat dapat ditukarkan dengan token berdurasi lama.

Token berdurasi lama berlaku selama 60 hari dan dapat diperbarui setidaknya setelah 24 jam tetapi belum kedaluwarsa, dan pengguna aplikasi telah memberi aplikasi Anda izin instagram_graph_user_profile. Token yang diperbarui valid selama 60 hari dari tanggal pembaruan. Token berdurasi lama yang belum diperbarui dalam 60 hari akan kedaluwarsa dan tidak bisa diperbarui.

Token akses berdurasi lama untuk akun Instagram pribadi sekarang dapat diperbarui. Selain itu, izin yang diberikan kepada aplikasi oleh pengguna aplikasi dengan akun pribadi sekarang berlaku selama 90 hari.

Batasan

  • Token berdurasi singkat tidak dapat ditukarkan dengan token berdurasi lama. Jika token pengguna telah kedaluwarsa, dapatkan yang baru sebelum menukarkannya dengan token berdurasi lama.
  • Permintaan untuk token berdurasi lama melibatkan rahasia aplikasi Anda, maka hanya boleh dilakukan dalam kode sisi server, jangan dalam kode sisi klien, atau dalam biner aplikasi yang dapat didekompilasi. Jangan membagikan rahasia aplikasi Anda dengan siapa pun, mengungkapkannya dalam kode, mengirimkannya ke klien, atau menyimpannya di perangkat.

Mendapatkan Token Berdurasi Lama

Gunakan endpoint GET /access_token untuk menukarkan Token Akses Pengguna Instagram berdurasi singkat dengan token berdurasi lama. Setelah memiliki token berdurasi lama, Anda dapat menggunakannya dalam permintaan sisi server atau mengirimkannya ke klien untuk digunakan di sana.

Permintaan Anda harus dibuat di sisi server dan menyertakan:

  • Token Akses Pengguna Instagram berdurasi singkat yang valid (belum kedaluwarsa).
  • Rahasia Aplikasi Instagram Anda (Dasbor Aplikasi > Produk > Instagram > Tampilan Dasar > Rahasia Aplikasi Instagram)

Baca referensi GET /access_token untuk informasi tambahan.

Contoh Permintaan

curl -i -X GET "https://graph.instagram.com/access_token
  ?grant_type=ig_exchange_token
  &client_secret={instagram-app-secret}
  &access_token={short-lived-access-token}"

Contoh Tanggapan

{
  "access_token":"{long-lived-user-access-token}",
  "token_type": "bearer",
  "expires_in": 5183944  // Number of seconds until token expires
}

Memperbarui Token Berdurasi Lama

Gunakan endpoint GET /refresh_access_token untuk memperbarui token Akses Pengguna Instagram berdurasi lama yang belum kedaluwarsa. Memperbarui token berdurasi lama akan membuatnya valid selama 60 hari lagi. Token berdurasi lama yang belum diperbarui dalam 60 hari akan kedaluwarsa.

Permintaan Anda harus menyertakan:

  • Token Akses Pengguna Instagram berdurasi lama yang valid (belum kedaluwarsa)

Baca referensi GET /refresh_access_token untuk informasi tambahan.

Contoh Permintaan

curl -i -X GET "https://graph.instagram.com/refresh_access_token
  ?grant_type=ig_refresh_token
  &access_token={long-lived-access-token}"

Contoh Tanggapan

{
  "access_token":"{long-lived-user-access-token}",
  "token_type": "bearer",
  "expires_in": 5183944 // Number of seconds until token expires
}