Skip to main content
POST
获取用户页面分析数据

概览

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

请求

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

请求示例

响应

对于非 Devin 团队,apiKey 包含的是原始用户 API 密钥,而非哈希值。请将其视为 secrets:在记录日志、导出或共享分析数据之前,请将其移除或脱敏。如果你必须保留未脱敏的响应,请限制访问权限并安全存储。
array
用户统计对象数组
string
团队当前账单周期的开始时间,采用 RFC 3339 格式。此字段与请求的时间范围无关,也不会限制 userTableStats 中 promptCreditsUsed 的用量统计范围。
string
团队当前账单周期的结束时间,采用 RFC 3339 格式。此字段与请求的时间范围无关,也不会限制 userTableStats 中 promptCreditsUsed 的用量统计范围。

响应示例

下方的 apiKey 值仅为示例占位符,并非真实凭据。

错误响应

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