获取屏幕使用时间状态

返回 `sessionId` 当前的屏幕使用时间状态：家长设定的规则、当天的使用量，以及此刻平台是否可以允许游玩。平台会在会话开始时，以及收到 `Screentime.LimitWarning`、`Screentime.LimitReached`、`Screentime.QuietHoursWarning` 或 `Screentime.QuietHoursReached` webhook 后调用本接口，以刷新自身保存的状态。当家长尚未为该会话配置屏幕使用时间，或已配置但停用了限制执行时，返回 `{ "enabled": false }`。

Authorization

api-key

AuthorizationBearer <token>

In: header

Query Parameters

sessionId*string

Formatuuid

Response Body

`application/json`

curl -X GET "https://example.com/screentime/get-state?sessionId=497f6eca-6276-4993-bfeb-53cbbbba6f08"

{  "enabled": true,  "access": {    "allowed": true  },  "state": {    "timeUsedTodayMinutes": 75,    "continuousUsageMinutes": 30,    "timeLimitTodayMinutes": 120,    "timeRemainingTodayMinutes": 45,    "dayResetsAt": "2026-06-25T00:00:00Z"  },  "schedule": {    "timezone": "UTC",    "breakReminderIntervalMinutes": 45,    "dailyLimits": [      {        "day": "mon",        "limitMinutes": 120      },      {        "day": "tue",        "limitMinutes": 120      },      {        "day": "wed",        "limitMinutes": 120      },      {        "day": "thu",        "limitMinutes": 120      },      {        "day": "fri",        "limitMinutes": 120      },      {        "day": "sat",        "limitMinutes": 180      },      {        "day": "sun",        "limitMinutes": 180      }    ],    "quietHours": [      {        "name": "Bedtime",        "days": [          "mon",          "tue",          "wed",          "thu",          "fri"        ],        "start": "21:00",        "end": "07:00"      }    ]  }}

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

获取屏幕使用时间状态

Authorization

Query Parameters

Response Body

200application/json

400application/json

`application/json`

`application/json`