跳到主要内容

提交会话已完成的屏幕时间使用片段

POST 
/screentime/push

为一个 k-ID 会话提交一个或多个已完成的屏幕时间使用片段。每个事件记录一段使用何时开始以及持续了多久。当使用量只能事后得知时使用此端点，例如缓冲片段并定期上传的后端，或在关闭时报告会话总计的游戏引擎。

每个被接受片段的 durationSeconds 会累加到玩家的每日屏幕时间总计。如果某个片段在父母配置的时区中跨过午夜，则会拆分到两个日期，使每天的总计反映当天实际发生的使用量。

事件会被独立处理。响应中包含每个事件的状态：

  • accepted - 片段已记录并累加到每日总计。重新提交 id 已被接受的事件是安全的无操作：它会再次计为 accepted 且不会重复累加，因此网络故障后的重试不会重复计数。
  • rejected - 片段未通过校验；reason 指明是哪条规则。

当会话不存在或已被吊销时，整个批次都会被拒绝。

实时限制信号（Screentime.LimitWarning、Screentime.LimitReached、Screentime.BreakReminder）不会从此端点触发。如果集成需要这些 Webhook 在跨过阈值的那一刻触发，请使用/screentime/start 和 /screentime/end。

Request​

Responses​

批次已处理。每个事件的状态表示是否被接受。