Endpoints스크린타임

스크린타임 시작

이 제품에서 활성 스크린타임의 시작을 기록합니다. 스크린타임이 활성인 동안 k-ID는 실시간 웹훅(`Screentime.BreakReminder`, `Screentime.LimitWarning`, `Screentime.LimitReached`)을 전달합니다. 이 웹훅은 사용이 끝날 때만이 아니라 임계값을 넘는 시점에 발생합니다. 상태 의미: * `accepted` - 스크린타임이 시작되었거나, 이미 활성인 세션에 대한 재시도가 멱등적으로 처리되었습니다. * `replaced` - 이 `sessionId`에서 스크린타임이 이미 활성인 상태로 다른 `id`가 전송되었습니다. 이전 스크린타임은 자동으로 종료되고 그 시간은 당일 스크린타임 사용량에 반영되었습니다. 이전 스크린타임이 명시적으로 종료되지 않은 경우(앱이나 기기 재시작 등)를 복구하는 데 사용할 수 있습니다. 하나의 `sessionId`에는 동시에 하나의 활성 스크린타임만 지원됩니다. 호출은 실시간으로 이루어져야 하며, `timestamp` 값은 5분보다 이전일 수 없습니다.

POST
/screentime/start
AuthorizationBearer <token>

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/start" \  -H "Content-Type: application/json" \  -d '{    "sessionId": "b1a6482d-5242-4b4a-aa88-3fa52595a672",    "id": "3f8c1d24-6b5e-4a07-9c2f-8d1e7a4b6c90",    "timestamp": "2026-06-24T16:00:00Z"  }'
{  "sessionId": "b1a6482d-5242-4b4a-aa88-3fa52595a672",  "id": "3f8c1d24-6b5e-4a07-9c2f-8d1e7a4b6c90",  "status": "accepted",  "screentime": {    "counter": {      "timeUsedTodayMinutes": 45,      "timeLimitTodayMinutes": 120,      "timeRemainingTodayMinutes": 75,      "dayResetsAt": "2026-06-25T00:00:00Z"    }  }}