跳转到主要内容
POST
获取用户页面分析数据

概览

获取团队页面上显示的用户活动统计信息,包括用户名、电子邮件、最近活动时间、活跃天数以及已使用的提示额度。

请求

service_key
string
必填
具有“Teams 只读”权限的服务密钥
group_name
string
将结果筛选为特定组中的用户 (可选)
start_timestamp
string
开始时间,采用 RFC 3339 格式 (例如:2023-01-01T00:00:00Z) 。仅影响 activeDays 的计算。 如果未提供,则默认为 1 年前。
end_timestamp
string
结束时间,采用 RFC 3339 格式 (例如:2023-12-31T23:59:59Z) 。仅影响 activeDays 的计算。 如果未提供,则默认为当前时间。

请求示例

响应

userTableStats
array
用户统计对象数组
billingCycleStart
string
当前账单周期的开始时间,采用 RFC 3339 格式。userTableStats 中的 promptCreditsUsed 值对应此账单周期内的用量。
billingCycleEnd
string
当前账单周期的结束时间,采用 RFC 3339 格式。userTableStats 中的 promptCreditsUsed 值对应此账单周期内的用量。

响应示例

错误响应

error
string
说明出错原因的错误消息
常见错误情况:
  • 服务密钥无效或权限不足
  • 时间戳格式无效
  • 未找到组
  • 超出速率限制