开始屏幕使用时间

标记本产品上活动屏幕使用时间的开始。在屏幕使用时间处于活动状态期间，k-ID 会发送实时 webhook——`Screentime.BreakReminder`、`Screentime.LimitWarning` 和 `Screentime.LimitReached`——它们在越过阈值的那一刻触发，而不仅仅在使用结束时触发。 状态含义： * `accepted` - 屏幕使用时间已开始，或对已处于活动状态的会话的重试被幂等处理。 * `replaced` - 该 `sessionId` 的屏幕使用时间已处于活动状态时又传入了不同的 `id`；先前的屏幕使用时间被自动结束，其时长计入当天的屏幕使用量。当先前的屏幕使用时间从未被显式结束时（例如应用或设备重启后），可借此恢复。 每个 `sessionId` 同一时间只支持一段活动屏幕使用时间。调用必须实时进行——`timestamp` 的值不得早于 5 分钟前。

curl -X POST "https://example.com/screentime/start" \  -H "Content-Type: application/json" \  -d '{    "sessionId": "b1a6482d-5242-4b4a-aa88-3fa52595a672",    "id": "3f8c1d24-6b5e-4a07-9c2f-8d1e7a4b6c90",    "timestamp": "2026-06-24T16:00:00Z"  }'

{  "sessionId": "b1a6482d-5242-4b4a-aa88-3fa52595a672",  "id": "3f8c1d24-6b5e-4a07-9c2f-8d1e7a4b6c90",  "status": "accepted",  "screentime": {    "counter": {      "timeUsedTodayMinutes": 45,      "timeLimitTodayMinutes": 120,      "timeRemainingTodayMinutes": 75,      "dayResetsAt": "2026-06-25T00:00:00Z"    }  }}

{  "error": "INVALID_INPUT",  "errorMessage": "The request was missing a sessionId parameter."}