（備註：對於某些版本的 Redmine，您可能需要使用 /time_entries.xml 路徑的其他擴展名，例如 2.5 版可以使用 *.json https://redmine.dev.org.tw/boards/2/topics/48933?r=48934#message-48934，有時在插件中它根本沒有任何擴展名）

時間記錄¶

• 目錄
• 時間記錄
  • 列出時間記錄
    • project_id 過濾器
    • spent_on 過濾器
  • 顯示時間記錄
  • 建立時間記錄
  • 更新時間記錄
  • 刪除時間記錄

列出時間記錄¶

GET /time_entries.xml

傳回時間記錄。

參數:

• offset
• limit
• user_id
• project_id
• spent_on
• ...

project_id 過濾器¶

使用專案 ID 進行過濾時，您可以使用專案的數字 ID 或其字串識別碼，例如：

...&project_id=123

...&project_id=my-custom-project

spent_on 過濾器¶

使用日期過濾時，您可以使用自訂語法要求最小/最大日期

/time_entries.json?project_id=338&from=2019-01-01&to=2019-01-03&limit=100 

顯示時間記錄¶

GET /time_entries/[id].xml

傳回指定 ID 的時間記錄。

建立時間記錄¶

POST /time_entries.xml

建立時間記錄。

參數:

• time_entry（必填）：時間記錄屬性的雜湊，包括
  • issue_id 或 project_id（僅需要其中一個）：要記錄時間的議題 ID 或專案 ID（兩者都是整數）；請注意，專案 ID 只能使用 API 找到（例如在 /projects.json 中）
  • spent_on：花費時間的日期（預設為當前日期）；格式例如 2020-12-24
  • hours（必填）：花費的小時數
  • activity_id：時間活動的 ID。除非在 Redmine 中定義了預設活動，否則此參數為必填。
  • comments：記錄的簡短描述（最多 255 個字元）
  • user_id：需要代表另一個使用者發布時間時要指定的使用者 ID

回應:

• 201 Created：時間記錄已建立
• 422 Unprocessable Entity：由於驗證失敗，未建立時間記錄（回應主體包含錯誤訊息）

更新時間記錄¶

PUT /time_entries/[id].xml

更新指定 ID 的時間記錄。

參數:

• time_entry（必填）：時間記錄屬性的雜湊（與上述相同）

回應:

• 204 No Content：時間記錄已更新
• 422 Unprocessable Entity：由於驗證失敗，未更新時間記錄（回應主體包含錯誤訊息）

刪除時間記錄¶

DELETE /time_entries/[id].xml

刪除指定 ID 的時間記錄。