Rest TimeEntries » History » Version 1
Jean-Philippe Lang, 2011-01-02 13:01
| 1 | 1 | Jean-Philippe Lang | h1. Time Entries |
|---|---|---|---|
| 2 | |||
| 3 | h2. Listing time entries |
||
| 4 | |||
| 5 | GET /time_entries.xml |
||
| 6 | |||
| 7 | Returns time entries. |
||
| 8 | |||
| 9 | h2. Showing a time entry |
||
| 10 | |||
| 11 | GET /time_entries/[id].xml |
||
| 12 | |||
| 13 | Returns the time entry of given id. |
||
| 14 | |||
| 15 | h2. Creating a time entry |
||
| 16 | |||
| 17 | POST /time_entries.xml |
||
| 18 | |||
| 19 | Creates a time entry. |
||
| 20 | |||
| 21 | +Parameters+: |
||
| 22 | |||
| 23 | * @time_entry@ (required): a hash of the time entry attributes, including: |
||
| 24 | |||
| 25 | * @issue_id@ or @project_id@ (only one is required): the issue id or project id to log time on |
||
| 26 | * @spent_on@: the date the time was spent (default to the current date) |
||
| 27 | * @hours@ (required): the number of spent hours |
||
| 28 | * @activity_id@: the id of the time activity. This parameter is required unless a default activity is defined in Redmine. |
||
| 29 | * @comments@: short description for the entry (255 characters max) |
||
| 30 | |||
| 31 | +Response+: |
||
| 32 | |||
| 33 | * @201 Created@: time entry was created |
||
| 34 | * @422 Unprocessable Entity@: time entry was not created due to validation failures (response body contains the error messages) |
||
| 35 | |||
| 36 | h2. Updating a time entry |
||
| 37 | |||
| 38 | PUT /time_entries/[id].xml |
||
| 39 | |||
| 40 | Updates the time entry of given id. |
||
| 41 | |||
| 42 | +Parameters+: |
||
| 43 | |||
| 44 | * @time_entry@ (required): a hash of the time entry attributes (same as above) |
||
| 45 | |||
| 46 | +Response+: |
||
| 47 | |||
| 48 | * @200 OK@: time entry was updated |
||
| 49 | * @422 Unprocessable Entity@: time entry was not updated due to validation failures (response body contains the error messages) |
||
| 50 | |||
| 51 | h2. Deleting a time entry |
||
| 52 | |||
| 53 | DELETE /time_entries/[id].xml |
||
| 54 | |||
| 55 | Deletes the time entry of given id. |