结束屏幕时间
POST/screentime/end
结束先前用 /screentime/start 开始的活跃屏幕时间。该时长计入今天的屏幕时间使用量;当屏幕时间跨过当地午夜时,会按日程时区在日期边界处拆分。
状态语义:
accepted- 与id匹配的屏幕时间已结束,或者针对已结束的屏幕时间的重试调用被幂等地吸收。
当 sessionId 没有活跃的屏幕时间,或此请求中的 id 与开始该活跃屏幕时间的 id 不匹配时,会返回 NOT_FOUND 代码。
Request
Responses
- 200
- 400
屏幕时间结束已接受。
无效请求。响应正文的 error 字段包含具体的代码(例如INVALID_INPUT、NOT_FOUND、FEATURE_DISABLED)。