Token Akses Berdurasi Lama

Secara default, token akses pengguna Threads 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 asalkan berusia minimal 24 jam, tetapi belum kedaluwarsa, dan pengguna aplikasi telah memberikan izin threads_basic kepada aplikasi Anda. 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 profil Threads privat sekarang dapat diperbarui. Selain itu, izin yang diberikan kepada aplikasi oleh pengguna aplikasi dengan profil privat sekarang berlaku selama 90 hari.

Batasan

• Token berdurasi singkat tidak dapat ditukarkan dengan token berdurasi lama. Jika token pengguna telah kedaluwarsa, dapatkan token baru sebelum menukarnya 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 Threads 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 Threads berdurasi singkat yang valid (belum kedaluwarsa).
• Rahasia aplikasi Threads Anda (Dasbor Aplikasi > Pengaturan aplikasi > Dasar > Rahasia Aplikasi Threads).

Parameter

Sertakan parameter string kueri berikut untuk ditambahkan ke permintaan.

Contoh Permintaan

curl -i -X GET "https://graph.threads.net/access_token
  ?grant_type=th_exchange_token
  &client_secret=<THREADS_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 Threads 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 Threads berdurasi lama yang valid (belum kedaluwarsa).

Parameter

Contoh Permintaan

curl -i -X GET "https://graph.threads.net/refresh_access_token
  ?grant_type=th_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
}