본문으로 건너뛰기

세션의 완료된 스크린 타임 사용 구간 제출

POST 
/screentime/push

k-ID 세션에 대해 완료된 스크린 타임 사용 구간을 하나 이상 제출합니다. 각 이벤트는 사용 구간이 시작된 시점과 지속 시간을 기록합니다. 사용량을 사후에만 알 수 있는 경우 이 엔드포인트를 사용하세요. 예를 들어 구간을 버퍼링해 주기적으로 업로드하는 백엔드나, 종료 시 세션 합계를 보고하는 게임 엔진입니다.

수락된 각 구간의 durationSeconds는 플레이어의 일일 스크린 타임 합계에 더해집니다. 구간이 부모가 설정한 시간대에서 자정을 넘으면 두 날짜로 분할되어 각 날짜의 합계가 실제로 그 날짜에 발생한 사용량을 반영합니다.

이벤트는 개별적으로 처리됩니다. 응답에는 이벤트별 상태가 담깁니다.

  • accepted - 구간이 기록되어 일일 합계에 더해졌습니다. 이미 수락된 id의 이벤트를 다시 제출해도 안전한 무작업입니다. 다시 accepted로 집계되며 두 번 더해지지 않으므로, 네트워크 장애 후의 재시도로 중복 집계되지 않습니다.
  • rejected - 구간이 검증에 실패했습니다. reason이 어떤 규칙에 걸렸는지 알려줍니다.

세션이 존재하지 않거나 취소된 경우에는 배치 전체가 거부됩니다.

실시간 제한 신호(Screentime.LimitWarning, Screentime.LimitReached, Screentime.BreakReminder)는 이 엔드포인트에서 발생하지 않습니다. 임계값을 넘는 순간에 이러한 Webhook이 발생해야 하는 통합에서는 /screentime/start와 /screentime/end를 사용하세요.

Request​

Responses​

배치를 처리했습니다. 이벤트별 상태가 수락 여부를 나타냅니다.