Tài liệu này đã được cập nhật.
Bản dịch sang Tiếng Việt chưa hoàn tất.
Cập nhật bằng tiếng Anh: 5 tháng 7, 2021

Mã truy cập dài hạn

Theo mặc định, Mã truy cập của người dùng Instagram là mã ngắn hạn và có giá trị trong một giờ. Tuy nhiên, bạn có thể đổi các mã ngắn hạn lấy mã dài hạn.

Mã truy cập dài hạn sẽ có giá trị trong 60 ngày và có thể làm mới, với điều kiện đã tồn tại trong 24 giờ trở lên mà chưa hết hạn, đồng thời người dùng ứng dụng đã cấp cho ứng dụng của bạn quyền instagram_graph_user_profile. Mã truy cập đã được làm mới sẽ có hiệu lực trong 60 ngày kể từ ngày làm mới. Các mã chưa được làm mới sau 60 ngày sẽ hết hạn và không thể làm mới nữa.

Mã truy cập dài hạn cho tài khoản Instagram riêng tư hiện có thể được làm mới. Ngoài ra, những quyền mà người dùng cấp cho các ứng dụng có tài khoản riêng tư hiện có hiệu lực trong 90 ngày.

Các giới hạn

  • Không thể đổi các mã ngắn hạn đã hết hạn lấy mã dài hạn. Nếu mã truy cập của người dùng đã hết hạn, hãy lấy một mã mới trước khi đổi lấy mã truy cập dài hạn.
  • Vì các yêu cầu mã truy cập dài hạn có chứa khóa bí mật của ứng dụng nên bạn chỉ được thực hiện các yêu cầu này bằng mã phía máy chủ, không được thực hiện bằng mã phía máy khách hay bằng mã nhị phân của ứng dụng có thể bị dịch ngược. Không chia sẻ khóa bí mật của ứng dụng với bất kỳ ai, cũng như không hiển thị khóa này trong mã, gửi đến máy khách hay lưu trữ trên thiết bị.

Lấy mã truy cập dài hạn

Sử dụng điểm cuối GET /access_token để đổi Mã truy cập ngắn hạn của người dùng Instagram lấy mã dài hạn. Sau khi có mã dài hạn, bạn có thể dùng mã đó trong yêu cầu phía máy chủ hoặc gửi đến máy khách để sử dụng tại đó.

Yêu cầu của bạn phải được thực hiện bên phía máy chủ và bao gồm:

  • Mã truy cập ngắn hạn hợp lệ (chưa hết hạn) của người dùng Instagram
  • Khóa bí mật của ứng dụng trên Instagram của bạn (Bảng điều khiển ứng dụng > Sản phẩm > Instagram > Basic Display > Khóa bí mật của ứng dụng trên Instagram)

Xem tài liệu tham khảo về GET /access_token để biết thêm thông tin.

Ví dụ về yêu cầu

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

Ví dụ về phản hồi

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

Làm mới mã dài hạn

Sử dụng điểm cuối GET /refresh_access_token để làm mới Mã truy cập dài hạn (chưa hết hạn) của người dùng Instagram. Khi được làm mới, mã truy cập dài hạn sẽ có giá trị thêm 60 ngày. Các mã truy cập dài hạn chưa được làm mới trong sau 60 ngày sẽ hết hạn.

Yêu cầu của bạn phải bao gồm:

  • Mã truy cập dài hạn hợp lệ (chưa hết hạn) của người dùng Instagram

Xem tài liệu tham khảo về GET /refresh_access_token để biết thêm thông tin.

Ví dụ về yêu cầu

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

Ví dụ về phản hồi

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