Người dùng

Biểu thị trang cá nhân của người dùng Instagram.

Chúng tôi đã ra mắt ID người dùng trong ứng dụng (ASID) với API phiên bản 11.0. Bạn có thể tiếp tục truy vấn người dùng theo ID người dùng chưa xử lý hoặc ASID tương đương của người dùng. Tuy nhiên, các lệnh gọi phiên bản 11.0 trở lên sẽ nhận được ASID.

ASID sẽ thay thế ID người dùng chưa xử lý trong khoảng 2 năm đến khi ngừng sử dụng phiên bản 10.0. Do đó, bạn nên bắt đầu đối ghép người dùng ứng dụng với ASID tương đương.

Tạo

Thao tác này không được hỗ trợ.

Đọc

GET /{user-id}

Lấy các trường và cạnh từ Người dùng.

Các giới hạn

Không hỗ trợ ID người dùng API cũ trên Instagram.

Yêu cầu

Loại	Yêu cầu
Mã truy cập	Người dùng Instagram
Quyền	`instagram_graph_user_profile`. Trường`media_count` cũng cần có `instagram_graph_user_media`.

Cú pháp yêu cầu

GET https://graph.instagram.com/{api-version}/{user-id}
  ?fields={fields}
  &access_token={access-token}

Thông số đường dẫn

Phần giữ chỗ	Giá trị
`{api-version}` Chuỗi	Phiên bản API.
`{user-id}` Bắt buộc Chuỗi	ID người dùng trong ứng dụng của người dùng ứng dụng (phiên bản 11.0 trở lên) hoặc ID người dùng chưa xử lý (tất cả các phiên bản).

Thông số chuỗi truy vấn

Thêm các thông số chuỗi truy vấn sau đây vào yêu cầu.

Khóa	Giá trị
`access_token` Bắt buộc Chuỗi	Mã truy cập người dùng Instagram của người dùng ứng dụng.
`fields` Danh sách được phân tách bằng dấu phẩy	Danh sách được phân tách bằng dấu phẩy bao gồm các trường và cạnh mà bạn muốn nhận được. Nếu bỏ qua, các trường mặc định sẽ được trả về.

Trường

Bạn có thể sử dụng thông số chuỗi truy vấn fields để yêu cầu các trường sau đây từ Người dùng.

Tên trường	Mô tả
`account_type`	Loại tài khoản của Người dùng. Có thể là `BUSINESS`, `MEDIA_CREATOR` hoặc `PERSONAL`.
`id`	ID người dùng trong ứng dụng của người dùng ứng dụng (phiên bản 11.0 trở lên) hoặc ID người dùng chưa xử lý (phiên bản 10.0 trở lên).
`media_count`	Số File phương tiện của Người dùng. Đối với trường này, bạn cần có quyền `instagram_graph_user_media`.
`username`	Tên người dùng của Người dùng.

Cạnh

Bạn có thể yêu cầu các cạnh sau đây ở dạng thông số đường dẫn hoặc bằng cách sử dụng thông số chuỗi truy vấn fields.

Cạnh	Mô tả
`media`	Lấy danh sách File phương tiện từ Người dùng.

Phản hồi

Một đối tượng ở định dạng JSON chứa các trường và cạnh mặc định cũng như theo yêu cầu.

{
  "{field}":"{value}",
  ...
}

Ví dụ về cURL

Yêu cầu

curl -X GET \
  'https://graph.instagram.com/v19.0/10218560180051171?fields=id,username&access_token=IGQVJ...'

Phản hồi

{
  "id": "17841405793187218",
  "username": "jayposiris"
}

Cập nhật

Thao tác này không được hỗ trợ.

Xóa

Thao tác này không được hỗ trợ.