본문으로 건너뛰기

스크린 타임 시작

POST 
/screentime/start

이 제품에서 활성 스크린 타임의 시작을 기록합니다. 스크린 타임이 활성인 동안 k-ID는 실시간 Webhook(Screentime.BreakReminder, Screentime.LimitWarning, Screentime.LimitReached)을 전달합니다. 이들은 사용이 끝날 때만이 아니라 임계값을 넘는 순간에 발생합니다.

상태 의미:

  • accepted - 스크린 타임이 시작되었거나, 이미 활성인 세션에 대한 재시도 호출이 멱등하게 처리된 경우입니다.
  • replaced - 이 sessionId에 스크린 타임이 이미 활성인 상태에서 다른 id가 전송된 경우입니다. 이전 스크린 타임은 자동으로 종료되고 그 시간은 오늘의 스크린 타임 사용량에 반영됩니다. 이전 스크린 타임이 명시적으로 종료되지 않은 경우(앱 또는 기기 재시작 후 등) 복구에 사용하세요.

sessionId당 동시에 활성인 스크린 타임은 하나만 지원됩니다. 호출은 실시간으로 이루어져야 하며 timestamp 값은 5분보다 이전일 수 없습니다.

Request​

Responses​

스크린 타임 시작이 수락되었거나 대체되었습니다.