스크린타임 상태 조회

`sessionId`의 현재 스크린타임 상태를 반환합니다. 보호자가 설정한 규칙, 오늘의 사용량, 그리고 지금 플레이를 허용해도 되는지 여부가 포함됩니다. 플랫폼은 세션 시작 시점과 `Screentime.LimitWarning`, `Screentime.LimitReached`, `Screentime.QuietHoursWarning`, `Screentime.QuietHoursReached` 웹훅을 받은 뒤에 보관 중인 상태를 갱신하기 위해 이 API를 호출합니다. 보호자가 해당 세션에 스크린타임을 설정하지 않았거나, 설정했더라도 적용을 비활성화한 경우에는 `{ "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`