プロジェクト

全般

プロフィール

redmine.org の Rest_TimeEntries の日本語訳です。

REST 作業時間の記録

作業時間データの一覧

GET /time_entries.xml

作業時間データのリストを取得します。

作業時間データの表示

GET /time_entries/[id].xml

ID で指定した作業時間データを取得します。

作業時間データの作成(作業時間の記録)

POST /time_entries.xml

作業時間データを作成します。

要素:

  • time_entry (必須): 以下の子要素を持ちます。
    • issue_id or project_id (一方だけを必ず指定): 作業時間の対象となるチケットまたはプロジェクトの ID
    • spent_on: 作業した時の日付 (デフォルトでは今日の日付)
    • hours (必須): 作業時間(時間単位)
    • activity_id: 作業分類の ID。 このパラメーターはデフォルトの作業分類が指定されていなければ必須です。
    • comments: 作業に対するコメント。(255 文字以内)

レスポンス:

  • 201 Created: 作業時間データは作成されました。
  • 422 Unprocessable Entity: 妥当性の検証でエラーが発生し、作業時間データの作成に失敗しました。
    (レスポンスの中身はエラーメッセージです。)

作業時間の更新

PUT /time_entries/[id].xml

指定した ID の作業時間データを更新します。

要素:

  • time_entry (必須): 作成時と同じ子要素を持ちます。

Response:

  • 201 OK: 作業時間データは更新されました。
  • 422 Unprocessable Entity: 妥当性の検証でエラーが発生し、作業時間データの更新に失敗しました。
    (レスポンスの中身はエラーメッセージです。)

作業時間データの削除

DELETE /time_entries/[id].xml

指定した ID の作業時間データを削除します。