指南
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 生效)status:all|active|revokedpage、pageSize(pageSize最大 100)
隱私規則(務必遵守):
- active:只回傳該用戶在此 App 授權允許的欄位(依
grantedFields投影) - revoked:一律
masked=true並遮蔽個資(email/displayName會是null) - 無授權:不會出現在列表

