스크린타임 시작
이 제품에서 활성 스크린타임의 시작을 기록합니다. 스크린타임이 활성인 동안 k-ID는 실시간 웹훅(`Screentime.BreakReminder`, `Screentime.LimitWarning`, `Screentime.LimitReached`)을 전달합니다. 이 웹훅은 사용이 끝날 때만이 아니라 임계값을 넘는 시점에 발생합니다. 상태 의미: * `accepted` - 스크린타임이 시작되었거나, 이미 활성인 세션에 대한 재시도가 멱등적으로 처리되었습니다. * `replaced` - 이 `sessionId`에서 스크린타임이 이미 활성인 상태로 다른 `id`가 전송되었습니다. 이전 스크린타임은 자동으로 종료되고 그 시간은 당일 스크린타임 사용량에 반영되었습니다. 이전 스크린타임이 명시적으로 종료되지 않은 경우(앱이나 기기 재시작 등)를 복구하는 데 사용할 수 있습니다. 하나의 `sessionId`에는 동시에 하나의 활성 스크린타임만 지원됩니다. 호출은 실시간으로 이루어져야 하며, `timestamp` 값은 5분보다 이전일 수 없습니다.
Authorization
api-key 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" } }}{ "error": "INVALID_INPUT", "errorMessage": "The request was missing a sessionId parameter."}스크린타임 예외 요청 POST
아이가 오늘 시간을 더 쓰고 싶거나 적용 중인 조용한 시간(quiet hours)을 넘기고 싶을 때, 아이를 대신해 예외 요청을 전송합니다. k-ID는 요청을 기록하고 승인 또는 거부를 위해 보호자에게 알립니다. 아이별로 멱등적이며, 같은 아이의 다른 요청이 아직 보류 중일 때 호출하면 두 번째 요청을 만들지 않고 그 보류 중인 요청을 그대로 반환합니다. 결정 결과는 `status: "granted" | "denied" | "expired"`를 담은 단일 `Screentime.OverrideResult` 웹훅으로 비동기적으로 전달됩니다. 웹훅 본문은 `state` 아래에 `GET /screentime/get-state`와 동일한 형식을 담고 있어, 플랫폼이 추가 조회 없이 보관 중인 상태를 바로 갱신할 수 있습니다. 24시간 내에 해결되지 않은 요청은 `status: "expired"`로 웹훅을 발생시킵니다.
기록상 판매자의 결제 정보를 표준 형식으로 정규화 POST
기록상 판매자(merchant of record)로부터 받은 원본 결제 페이로드를 공급자에 종속되지 않는 표준 형식으로 정규화합니다. 이를 통해 이후의 트랜잭션 API가 각 공급자의 형식을 알 필요가 없어집니다. `provider`에 기록상 판매자를 지정하고 `data`에 원본 페이로드를 전달하십시오. Xsolla의 경우 해당 페이로드는 `payment` 웹훅 본문이며, 카드 BIN이 반드시 포함되어야 합니다.