時間登録画面で利用できるタイマーを開始または停止します。
タイマーは、同時に1つのタスクにのみ、割り当てることができます。
メソッドとURI
POST /api/v1/timer
リクエストパラメーター
Content-Type:application/x-www-form-urlencoded
| パラメーター | 型 | 内容 |
| action* | 文字列 | 制御内容。 “start”: タイマーを開始する “stop”: 稼働中のタイマーを停止する |
| projectId | 数値 | タイマーを開始するタスクのプロジェクトID ※action=startの場合に必須 |
| taskId | 数値 | タイマーを開始するタスクのタスクID ※action=startの場合に必須 |
*は必須。
レスポンス
{
"timer": {
"project_id": 1,
"project_name": "「東京の魅力発信プロジェクト」の第2回目の提案",
"task_id": 1,
"task_name": "調査と報告",
"minute": 1,
"record_minute": 1,
}
}
| キー | 型 | 内容 |
| timer | — | タイマー情報。 |
| timer.project_id | 数値 | プロジェクトID |
| timer.project_name | 文字列 | プロジェクト名 |
| timer.task_id | 数値 | タスクID |
| timer.task_name | 文字列 | タスク名 |
| timer.minute | 数値 | 実績時間（分） ※action=stopの場合、タイマーによって追加された時間を含む、最終的な実績時間となる。 |
| timer.record_minute | 数値 | タイマーによって追加された時間（分） ※action=stopの場合に設定される。startの場合は本データなし。 |
タイマーのデーターがレスポンスされます。
権限
制限付きユーザ 一般ユーザ 特権ユーザ システム管理者