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)及已使用配額。 除非你需要這些額外資料,否則不建議使用,因為會拖慢回應時間。