跳到主要内容

开始屏幕时间

POST 
/screentime/start

标记此产品上活跃屏幕时间的开始。屏幕时间处于活跃状态时，k-ID 会投递实时 Webhook（Screentime.BreakReminder、Screentime.LimitWarning和 Screentime.LimitReached），它们在跨过阈值的那一刻触发，而不只是在使用结束时触发。

状态语义：

  • accepted - 屏幕时间已开始，或者针对已处于活跃状态的会话的重试调用被幂等地吸收。
  • replaced - 此 sessionId 的屏幕时间已处于活跃状态时又发送了另一个id；先前的屏幕时间已自动结束，其时长计入今天的屏幕时间使用量。当先前的屏幕时间从未被显式结束时（例如应用或设备重启后），可用它来恢复。

每个 sessionId 同时只支持一个活跃的屏幕时间。调用必须实时进行，timestamp 的值不能早于 5 分钟前。

Request​

Responses​

屏幕时间开始已接受或已替换。