เอกสารนี้นี้ได้รับการอัพเดตแล้ว
คำแปลเป็น ภาษาไทย ยังไม่เสร็จสมบูรณ์
ภาษาอังกฤษที่อัพเดต: 8 ก.ค. 2021

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

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

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

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

ข้อจำกัด

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

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

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

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

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

ดูข้อมูลเพิ่มเติมได้ในข้อมูลอ้างอิงของ GET /access_token

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

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

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

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

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

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

คำขอของคุณต้องประกอบด้วย:

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

ดูข้อมูลเพิ่มเติมได้ในข้อมูลอ้างอิงของ GET /refresh_access_token

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

curl -i -X GET "https://graph.instagram.com/refresh_access_token
  ?grant_type=ig_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
}