スクリーンタイムの開始
POST/screentime/start
このプロダクトでアクティブなスクリーンタイムの開始を記録します。スクリーンタイムがアクティブな間、k-IDはリアルタイムWebhook(Screentime.BreakReminder、Screentime.LimitWarning、Screentime.LimitReached)を配信します。これらは利用終了時だけでなく、しきい値を超えた瞬間に発火します。
ステータスの意味:
accepted- スクリーンタイムが開始された場合、またはすでにアクティブなセッションへの再試行呼び出しが冪等に吸収された場合。replaced- このsessionIdでスクリーンタイムがすでにアクティブな状態で別のidが送信された場合。直前のスクリーンタイムは自動的に終了され、その時間は本日のスクリーンタイム使用量に加算されます。直前のスクリーンタイムが明示的に終了されなかった場合(アプリやデバイスの再起動後など)の復旧に使用します。
1つのsessionIdにつき、同時にアクティブなスクリーンタイムは1つだけです。呼び出しはリアルタイムで行う必要があり、timestampの値は5分より前にすることはできません。
Request
Responses
- 200
- 400
スクリーンタイムの開始が受理または置き換えられました。
無効なリクエスト。レスポンスボディのerrorフィールドに具体的なコード(INVALID_INPUT、NOT_FOUND、FEATURE_DISABLEDなど)が含まれます。