โทเค็นการเข้าถึงระยะยาว

โดยค่าเริ่มต้นแล้ว โทเค็นการเข้าถึงผู้ใช้ Threads จะมีอายุการใช้งานสั้นและใช้งานได้ 1 ชั่วโมง แต่คุณสามารถนำโทเค็นระยะสั้นไปแลกเป็นโทเค็นระยะยาวได้

โทเค็นระยะยาวจะใช้งานได้เป็นเวลา 60 วัน และสามารถรีเฟรชได้หากโทเค็นมีอายุอย่างน้อย 24 ชั่วโมงแต่ยังไม่หมดอายุ และผู้ใช้แอพได้มอบสิทธิ์การอนุญาต threads_basic แก่แอพของคุณไว้ โทเค็นที่รีเฟรชแล้วจะใช้งานได้เป็นเวลา 60 วันนับตั้งแต่วันที่ทำการรีเฟรช ส่วนโทเค็นที่ไม่ได้รีเฟรชภายใน 60 วันจะหมดอายุและไม่สามารถรีเฟรชได้อีก

ตอนนี้คุณสามารถรีเฟรชโทเค็นการเข้าถึงระยะยาวสำหรับโปรไฟล์ Threads แบบส่วนตัวได้แล้ว นอกจากนี้ สิทธิ์การอนุญาตที่แอพได้รับจากผู้ใช้แอพที่มีโปรไฟล์แบบส่วนตัวจะใช้งานได้เป็นเวลา 90 วัน

ข้อจำกัด

โทเค็นระยะสั้นที่หมดอายุแล้วจะไม่สามารถแลกเป็นโทเค็นระยะยาวได้ หากโทเค็นของผู้ใช้หมดอายุ ให้รับโทเค็นใหม่ก่อน จากนั้นนำไปแลกเป็นโทเค็นระยะยาว
คำขอรับโทเค็นระยะยาวจะมีข้อมูลลับของแอพรวมอยู่ด้วย ดังนั้นควรส่งคำขอในโค้ดฝั่งเซิร์ฟเวอร์เท่านั้น ห้ามส่งคำขอในโค้ดฝั่งไคลเอ็นต์หรือในไบนารีของแอพที่สามารถแยกส่วนได้ ห้ามแชร์ข้อมูลลับของแอพคุณกับใครก็ตาม รวมถึงห้ามเปิดเผยในรูปแบบของโค้ด ส่งไปที่ไคลเอ็นต์ หรือเก็บไว้ในอุปกรณ์

รับโทเค็นระยะยาว

ใช้ตำแหน่งข้อมูล GET /access_token เพื่อแลกโทเค็นการเข้าถึงผู้ใช้ Threads ระยะสั้นเป็นโทเค็นระยะยาว เมื่อได้โทเค็นระยะยาวมาแล้ว คุณสามารถนำไปใช้ในคำขอฝั่งเซิร์ฟเวอร์หรือส่งให้ไคลเอ็นต์นำไปใช้งานได้

คำขอของคุณต้องส่งมาจากฝั่งเซิร์ฟเวอร์และมีสิ่งต่อไปนี้

โทเค็นการเข้าถึงผู้ใช้ Threads ระยะสั้นที่ใช้งานได้ (ยังไม่หมดอายุ)
ข้อมูลลับของแอพ Threads ของคุณ (แดชบอร์ดของแอพ > การตั้งค่าแอพ > พื้นฐาน > ข้อมูลลับของแอพ Threads)

พารามิเตอร์

เพิ่มพารามิเตอร์สตริงการสืบค้นต่อไปนี้เพื่อเสริมคำขอ

ชื่อ	คำอธิบาย
`client_secret` สตริง	จำเป็นต้องระบุ ข้อมูลลับของแอพ Threads ของคุณ ซึ่งแสดงอยู่ในแดชบอร์ดของแอพ > การตั้งค่าแอพ > พื้นฐาน > ช่องข้อมูลลับของแอพ Threads
`grant_type` สตริง	จำเป็นต้องระบุ ตั้งเป็น `th_exchange_token`
`access_token` สตริง	จำเป็นต้องระบุ โทเค็นการเข้าถึงผู้ใช้ Threads ระยะสั้นที่ใช้งานได้ (ยังไม่หมดอายุ) ที่คุณต้องการนำมาแลกเป็นโทเค็นแบบระยะยาว

ตัวอย่างคำขอ

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>"

ตัวอย่างการตอบกลับ

{
  "access_token": "<LONG_LIVED_USER_ACCESS_TOKEN>",
  "token_type": "bearer",
  "expires_in": 5183944  // number of seconds until token expires
}

รีเฟรชโทเค็นระยะยาว

ใช้ตำแหน่งข้อมูล GET /refresh_access_token เพื่อรีเฟรชโทเค็นการเข้าถึงผู้ใช้ Threads ระยะยาวที่ยังไม่หมดอายุ การรีเฟรชโทเค็นระยะยาวจะทำให้โทเค็นใช้งานต่อไปได้อีก 60 วัน โทเค็นระยะยาวที่ไม่ได้รีเฟรชภายใน 60 วันจะหมดอายุ

คำขอของคุณต้องมีสิ่งต่อไปนี้

โทเค็นการเข้าถึงผู้ใช้ Threads ระยะยาวที่ใช้งานได้ (ยังไม่หมดอายุ)

พารามิเตอร์

ชื่อ	คำอธิบาย
`grant_type` สตริง	จำเป็นต้องระบุ ตั้งเป็น `th_refresh_token`
`access_token` สตริง	จำเป็นต้องระบุ โทเค็นการเข้าถึงผู้ใช้ Threads ระยะยาวที่ใช้งานได้ (ยังไม่หมดอายุ) ที่คุณต้องการรีเฟรช

ตัวอย่างคำขอ

curl -i -X GET "https://graph.threads.net/refresh_access_token
  ?grant_type=th_refresh_token
  &access_token=<LONG_LIVED_ACCESS_TOKEN>"

ตัวอย่างการตอบกลับ

{
  "access_token": "<LONG_LIVED_USER_ACCESS_TOKEN>",
  "token_type": "bearer",
  "expires_in": 5183944 // number of seconds until token expires
}