Skip to main content
GET
此端点用于获取当前已认证用户或 user profile 的详细信息,包括:
  • 所有已关联社交媒体账户的完整列表
  • 社交媒体用户名和 profile 信息
  • 账户状态和使用指标
返回的数据反映截至上次刷新时已连接社交网络的状态,并会在用户连接或断开其社交媒体账户时更新。
响应缓存。 响应最多缓存 60 秒lastUpdatednextUpdate 字段描述该缓存窗口:lastUpdated 是构建快照的时间,nextUpdate 是快照过期的时间。nextUpdate缓存过期标记,而不是就绪信号。 它会在每次响应中标注,包括那些 displayNames 中尚未列出你刚刚收到通知的账户的响应,因此它无法告诉你新关联的账户何时完成传播。如果你正在对新关联对应的 social webhook 进行核对,请持续轮询,直到你预期的账户真正出现在 displayNames 中——不要将单次响应或 nextUpdate 的到来视为该关联缺失或完成的确认。
若未关联任何社交账户,则不会返回 activeSocialAccounts 若要获取特定 User Profile 的数据,请在 header 中添加 Profile-Key
  • 如果你的业务需要一次性收集所有 user profile 数据,请使用 /user/batch 端点
  • 如果你希望在用户关联或解绑社交账户时收到通知,请参阅 /webhooks 端点

Header 参数

Query 参数

boolean
默认值:false
返回额外的 Instagram 详情,例如账户类型(business 或 creator)和已用配额。 除非你确实需要这些附加数据,否则不建议启用,因为会拖慢响应时间。