스크린 타임 예외 요청

POST 
/screentime/request-override

자녀가 오늘 시간을 더 원하거나 활성 조용한 시간을 우회하려 할 때 자녀를 대신해 예외 요청을 제출합니다. k-ID는 요청을 기록하고 부모에게 승인 또는 거부하도록 알립니다. 자녀별로 멱등입니다. 같은 자녀의 다른 요청이 아직 대기 중인 상태에서 호출하면 두 번째 요청을 만들지 않고 그 대기 중인 요청을 그대로 반환합니다.

결과는 status: "granted" | "denied" | "expired"를 담은 하나의 Screentime.OverrideResult Webhook으로 비동기적으로 도착합니다. Webhook 본문의 state는 GET /screentime/get-state와 동일한 형태를 가지므로, 플랫폼은 추가 조회 없이 보유한 상태를 바로 업데이트할 수 있습니다. 24시간 내에 해결되지 않은 요청은 status: "expired"로 Webhook을 발생시킵니다.

Request

Responses

200

예외 요청이 수락되었습니다.

400

잘못된 요청입니다. 응답 본문의 error 필드에 구체적인 코드 (INVALID_INPUT, NOT_FOUND, FEATURE_DISABLED 등)가 담깁니다.