结束屏幕使用时间
结束先前通过 `/screentime/start` 开始的活动屏幕使用时间。该时长会计入当天的屏幕使用量；若跨越当地午夜，则按日程所在时区拆分到相应日期。 状态含义： * `accepted` - 与 `id` 匹配的屏幕使用时间已结束，或对已结束的屏幕使用时间的重试被幂等处理。 当 `sessionId` 没有处于活动状态的屏幕使用时间，或本次请求中的 `id` 与开启该活动屏幕使用时间的 `id` 不一致时，返回 `NOT_FOUND` 错误码。
Authorization
api-key In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
curl -X POST "https://example.com/screentime/end" \ -H "Content-Type: application/json" \ -d '{ "sessionId": "b1a6482d-5242-4b4a-aa88-3fa52595a672", "id": "3f8c1d24-6b5e-4a07-9c2f-8d1e7a4b6c90", "timestamp": "2026-06-24T16:30:00Z" }'{ "sessionId": "b1a6482d-5242-4b4a-aa88-3fa52595a672", "id": "3f8c1d24-6b5e-4a07-9c2f-8d1e7a4b6c90", "status": "accepted", "screentime": { "counter": { "timeUsedTodayMinutes": 75, "timeLimitTodayMinutes": 120, "timeRemainingTodayMinutes": 45, "dayResetsAt": "2026-06-25T00:00:00Z" } }}{ "error": "INVALID_INPUT", "errorMessage": "The request was missing a sessionId parameter."}推送会话的活动记录 POST
针对产品声明的活动类型批量提交活动记录。记录逐条校验，响应中包含每条记录的状态（`accepted`，或带原因的 `rejected`）。重复提交 `id` 已被接受的记录是安全的空操作——它会再次计为 `accepted`，不会被重复存储。若会话不存在或已被撤销，则整批请求被拒绝。
获取屏幕使用时间状态 GET
返回 `sessionId` 当前的屏幕使用时间状态：家长设定的规则、当天的使用量，以及此刻平台是否可以允许游玩。平台会在会话开始时，以及收到 `Screentime.LimitWarning`、`Screentime.LimitReached`、`Screentime.QuietHoursWarning` 或 `Screentime.QuietHoursReached` webhook 后调用本接口，以刷新自身保存的状态。 当家长尚未为该会话配置屏幕使用时间，或已配置但停用了限制执行时，返回 `{ "enabled": false }`。