Skip to main content
GET
Endpoint này truy xuất thông tin chi tiết về người dùng đã xác thực hoặc user profile, bao gồm:
  • Danh sách đầy đủ tất cả các social media account đã liên kết
  • Tên người dùng mạng xã hội và thông tin profile
  • Trạng thái tài khoản và các chỉ số sử dụng
Dữ liệu trả về phản ánh trạng thái của các mạng xã hội đã kết nối tính đến lần làm mới gần nhất và được cập nhật bất cứ khi nào người dùng kết nối hoặc ngắt kết nối các social media account của họ.
Bộ nhớ đệm phản hồi. Các phản hồi được lưu trong bộ nhớ đệm trong tối đa 60 giây. Các trường lastUpdatednextUpdate mô tả khoảng thời gian của bộ nhớ đệm đó: lastUpdated là thời điểm ảnh chụp được tạo, còn nextUpdate là thời điểm nó hết hạn.nextUpdate là một dấu mốc hết hạn bộ nhớ đệm, không phải tín hiệu sẵn sàng. Nó được đóng dấu trên mọi phản hồi, kể cả phản hồi mà displayNames chưa liệt kê một tài khoản bạn vừa được thông báo, nên nó không thể cho bạn biết khi nào một tài khoản vừa được liên kết đã hoàn tất lan truyền.Nếu bạn đang đối soát một webhook social cho một liên kết hoàn toàn mới, hãy polling cho đến khi tài khoản bạn mong đợi thực sự xuất hiện trong displayNames — đừng coi một phản hồi đơn lẻ, hay sự xuất hiện của nextUpdate, là xác nhận rằng liên kết đã vắng mặt hoặc đã hoàn tất.
Nếu không có social account nào được liên kết, activeSocialAccounts sẽ không được trả về. Lấy dữ liệu cho một User Profile cụ thể bằng cách thêm Profile-Key trong header.
  • Nếu doanh nghiệp của bạn cần thu thập tất cả dữ liệu user profile cùng một lúc, vui lòng sử dụng endpoint /user/batch.
  • Nếu bạn cần thông báo khi người dùng liên kết và hủy liên kết một social account, vui lòng xem endpoint /webhooks.

Tham số Header

Tham số Query

boolean
mặc định:false
Trả về các chi tiết Instagram bổ sung như loại tài khoản (business hoặc creator) và hạn mức đã sử dụng. Không khuyến nghị trừ khi bạn cần dữ liệu bổ sung vì nó sẽ làm chậm thời gian phản hồi.