Skip to main content
GET
此端點會取得目前驗證使用者或 User Profile 的詳細資訊,包括:
  • 所有已連結社群媒體帳號的完整清單
  • 社群媒體使用者名稱與個人檔案資訊
  • 帳號狀態與用量指標
回傳的資料反映的是上次重新整理時已連結社群網路的狀態,並在使用者連結或解除連結社群媒體帳號時更新。
回應快取。 回應會被快取最多 60 秒lastUpdatednextUpdate 欄位描述的就是這段快取視窗:lastUpdated 是建立這份快照的時間,nextUpdate 則是它過期的時間。nextUpdate快取到期標記,並非就緒訊號。 它會標示在每一次的回應上,即使該回應的 displayNames 尚未列出你剛收到通知的帳號也不例外,因此它無法告訴你新連結的帳號何時完成傳播。若你正在對應一個針對全新連結的 social webhook,請持續輪詢,直到你預期的帳號實際出現在 displayNames 中——不要把單一回應,或 nextUpdate 的到來,視為該連結不存在或已完成的確認。
若未連結任何社群帳號,則不會回傳 activeSocialAccounts 若要取得特定 User Profile 的資料,請在標頭中加入 Profile-Key
  • 若你的業務需要一次取得所有 User Profile 的資料,請改用 /user/batch 端點
  • 若你需要在使用者連結或解除連結社群帳號時收到通知,請參閱 /webhooks 端點

標頭參數

Query 參數

boolean
默认值:false
回傳額外的 Instagram 詳細資訊,例如帳號類型(business 或 creator)及已使用配額。 除非你需要這些額外資料,否則不建議使用,因為會拖慢回應時間。