指南

App 用戶列表(Users API)

App 用戶列表(Users API)

HSystem 的終端用戶是全球身份:同一個人跨不同 App 共用同一個 userId。但每個 App 對個資的可見範圍,仍必須遵守該 App 的授權(granted_fields)與撤銷狀態。

Console UI

控制台提供 /dev/apps/{{app_id}}/users 直接查看列表(搜尋/篩選/分頁),並已內建隱私遮蔽。

API:列出 App 用戶

GET {{api_base}}/v1/dev/apps/{{app_id}}/users

查詢參數:

  • q:搜尋(email / display_name;僅在 active/all 生效)
  • statusallactiverevoked
  • pagepageSizepageSize 最大 100)

隱私規則(務必遵守):

  • active:只回傳該用戶在此 App 授權允許的欄位(依 grantedFields 投影)
  • revoked:一律 masked=true 並遮蔽個資(email/displayName 會是 null
  • 無授權:不會出現在列表