Rest Issues » History » Version 43
Jean-Philippe Lang, 2013-01-30 21:59
1 | 1 | Jean-Philippe Lang | h1. Issues |
---|---|---|---|
2 | 1 | Jean-Philippe Lang | |
3 | 28 | Jean-Philippe Lang | {{>toc}} |
4 | 28 | Jean-Philippe Lang | |
5 | 1 | Jean-Philippe Lang | h2. Listing issues |
6 | 1 | Jean-Philippe Lang | |
7 | 1 | Jean-Philippe Lang | GET /issues.xml |
8 | 1 | Jean-Philippe Lang | |
9 | 2 | Jean-Philippe Lang | Returns a paginated list of issues. By default, it returns open issues only. |
10 | 1 | Jean-Philippe Lang | |
11 | 1 | Jean-Philippe Lang | +Parameters+: |
12 | 26 | Etienne Massip | |
13 | 21 | Alex Last | * @offset@: skip this number of issues in response (optional) |
14 | 21 | Alex Last | * @limit@: number of issues per page (optional) |
15 | 36 | Emmanuel Bourgerie | * @sort@: column to sort with. Append @:desc@ to invert the order. |
16 | 23 | Alex Last | |
17 | 2 | Jean-Philippe Lang | Optional filters: |
18 | 2 | Jean-Philippe Lang | |
19 | 30 | Ilya Kulakov | * @project_id@: get issues from the project with the given id, where id is either project id or project identifier |
20 | 40 | Matthias Lamoureux | * @subproject_id@: get issues from the subproject with the given id. You can use @project_id=XXX&subproject_id=!*@ to get only the issues of a given project and none of its subprojects. |
21 | 2 | Jean-Philippe Lang | * @tracker_id@: get issues from the tracker with the given id |
22 | 33 | Ilya Kulakov | * @status_id@: get issues with the given status id only. Possible values: @open@, @closed@, @*@ to get open and closed issues, status id |
23 | 29 | Michael Fuchs | * @assigned_to_id@: get issues which are assigned to the given user id |
24 | 25 | John Manktelow | * @cf_x@: get issues with the given value for custom field with an ID of @x@. (Custom field must have 'used as a filter' checked.) |
25 | 2 | Jean-Philippe Lang | * ... |
26 | 2 | Jean-Philippe Lang | |
27 | 2 | Jean-Philippe Lang | +Examples+: |
28 | 2 | Jean-Philippe Lang | |
29 | 2 | Jean-Philippe Lang | <pre> |
30 | 2 | Jean-Philippe Lang | GET /issues.xml |
31 | 2 | Jean-Philippe Lang | GET /issues.xml?project_id=2 |
32 | 1 | Jean-Philippe Lang | GET /issues.xml?project_id=2&tracker_id=1 |
33 | 29 | Michael Fuchs | GET /issues.xml?assigned_to_id=6 |
34 | 12 | Robert Palmer | GET /issues.xml?status_id=closed |
35 | 1 | Jean-Philippe Lang | GET /issues.xml?status_id=* |
36 | 25 | John Manktelow | GET /issues.xml?cf_1=abcdef |
37 | 21 | Alex Last | |
38 | 21 | Alex Last | Paging example: |
39 | 21 | Alex Last | GET /issues.xml?project_id=testproject&query_id=2&offset=0&limit=100 |
40 | 21 | Alex Last | GET /issues.xml?project_id=testproject&query_id=2&offset=50&limit=100 |
41 | 39 | Sridhar P | |
42 | 39 | Sridhar P | To fetch issues for a date range: |
43 | 39 | Sridhar P | GET /issues.xml?created_on=><2012-03-01|2012-03-07 |
44 | 2 | Jean-Philippe Lang | </pre> |
45 | 12 | Robert Palmer | |
46 | 12 | Robert Palmer | |
47 | 1 | Jean-Philippe Lang | |
48 | 1 | Jean-Philippe Lang | +Response+: |
49 | 1 | Jean-Philippe Lang | |
50 | 1 | Jean-Philippe Lang | <pre> |
51 | 1 | Jean-Philippe Lang | <?xml version="1.0" encoding="UTF-8"?> |
52 | 1 | Jean-Philippe Lang | <issues type="array" count="1640"> |
53 | 3 | Christoph Witzany | <issue> |
54 | 3 | Christoph Witzany | <id>4326</id> |
55 | 1 | Jean-Philippe Lang | <project name="Redmine" id="1"/> |
56 | 1 | Jean-Philippe Lang | <tracker name="Feature" id="2"/> |
57 | 1 | Jean-Philippe Lang | <status name="New" id="1"/> |
58 | 1 | Jean-Philippe Lang | <priority name="Normal" id="4"/> |
59 | 1 | Jean-Philippe Lang | <author name="John Smith" id="10106"/> |
60 | 1 | Jean-Philippe Lang | <category name="Email notifications" id="9"/> |
61 | 1 | Jean-Philippe Lang | <subject> |
62 | 1 | Jean-Philippe Lang | Aggregate Multiple Issue Changes for Email Notifications |
63 | 1 | Jean-Philippe Lang | </subject> |
64 | 1 | Jean-Philippe Lang | <description> |
65 | 1 | Jean-Philippe Lang | This is not to be confused with another useful proposed feature that |
66 | 1 | Jean-Philippe Lang | would do digest emails for notifications. |
67 | 1 | Jean-Philippe Lang | </description> |
68 | 1 | Jean-Philippe Lang | <start_date>2009-12-03</start_date> |
69 | 1 | Jean-Philippe Lang | <due_date></due_date> |
70 | 1 | Jean-Philippe Lang | <done_ratio>0</done_ratio> |
71 | 1 | Jean-Philippe Lang | <estimated_hours></estimated_hours> |
72 | 1 | Jean-Philippe Lang | <custom_fields> |
73 | 1 | Jean-Philippe Lang | <custom_field name="Resolution" id="2">Duplicate</custom_field> |
74 | 1 | Jean-Philippe Lang | <custom_field name="Texte" id="5">Test</custom_field> |
75 | 1 | Jean-Philippe Lang | <custom_field name="Boolean" id="6">1</custom_field> |
76 | 1 | Jean-Philippe Lang | <custom_field name="Date" id="7">2010-01-12</custom_field> |
77 | 1 | Jean-Philippe Lang | </custom_fields> |
78 | 1 | Jean-Philippe Lang | <created_on>Thu Dec 03 15:02:12 +0100 2009</created_on> |
79 | 1 | Jean-Philippe Lang | <updated_on>Sun Jan 03 12:08:41 +0100 2010</updated_on> |
80 | 1 | Jean-Philippe Lang | </issue> |
81 | 3 | Christoph Witzany | <issue> |
82 | 3 | Christoph Witzany | <id>4325</id> |
83 | 1 | Jean-Philippe Lang | ... |
84 | 1 | Jean-Philippe Lang | </issue> |
85 | 1 | Jean-Philippe Lang | </issues> |
86 | 1 | Jean-Philippe Lang | </pre> |
87 | 1 | Jean-Philippe Lang | |
88 | 1 | Jean-Philippe Lang | h2. Showing an issue |
89 | 1 | Jean-Philippe Lang | |
90 | 31 | Ilya Kulakov | <pre> |
91 | 43 | Jean-Philippe Lang | GET /issues/[id].[format] |
92 | 31 | Ilya Kulakov | </pre> |
93 | 31 | Ilya Kulakov | |
94 | 43 | Jean-Philippe Lang | +Parameters+: |
95 | 1 | Jean-Philippe Lang | |
96 | 43 | Jean-Philippe Lang | * @include@: fetch associated data (optional, use comma to fetch multiple associations). Possible values: |
97 | 1 | Jean-Philippe Lang | |
98 | 43 | Jean-Philippe Lang | * @children@ |
99 | 43 | Jean-Philippe Lang | * @attachments@ |
100 | 43 | Jean-Philippe Lang | * @relations@ |
101 | 43 | Jean-Philippe Lang | * @changesets@ |
102 | 43 | Jean-Philippe Lang | * @journals@ - See [[Rest_IssueJournals|Issue journals]] for more information. |
103 | 43 | Jean-Philippe Lang | * @watchers@ - Since 2.3.0 |
104 | 1 | Jean-Philippe Lang | |
105 | 43 | Jean-Philippe Lang | +Examples+: |
106 | 43 | Jean-Philippe Lang | |
107 | 43 | Jean-Philippe Lang | <pre> |
108 | 43 | Jean-Philippe Lang | GET /issues/2.xml |
109 | 43 | Jean-Philippe Lang | GET /issues/2.json |
110 | 43 | Jean-Philippe Lang | |
111 | 43 | Jean-Philippe Lang | GET /issues/2.xml |
112 | 43 | Jean-Philippe Lang | GET /issues/2.xml?include=attachments |
113 | 43 | Jean-Philippe Lang | GET /issues/2.xml?include=attachments,journals |
114 | 43 | Jean-Philippe Lang | </pre> |
115 | 1 | Jean-Philippe Lang | |
116 | 1 | Jean-Philippe Lang | h2. Creating an issue |
117 | 1 | Jean-Philippe Lang | |
118 | 5 | Damien Churchill | h3. Using XML |
119 | 5 | Damien Churchill | |
120 | 1 | Jean-Philippe Lang | <pre> |
121 | 10 | Robert Palmer | POST /issues.xml |
122 | 1 | Jean-Philippe Lang | <?xml version="1.0"?> |
123 | 9 | Robert Palmer | <issue> |
124 | 9 | Robert Palmer | <subject>Example</subject> |
125 | 11 | Robert Palmer | <project_id>1</project_id> |
126 | 9 | Robert Palmer | <priority_id>4</priority_id> |
127 | 9 | Robert Palmer | </issue> |
128 | 9 | Robert Palmer | </pre> |
129 | 7 | Robert Palmer | |
130 | 16 | Ian Epperson | Other available tags: |
131 | 15 | Ian Epperson | * description |
132 | 15 | Ian Epperson | * category_id |
133 | 1 | Jean-Philippe Lang | * assigned_to_id - ID of the user to assign the issue to (currently no mechanism to assign by name) |
134 | 16 | Ian Epperson | * status_id |
135 | 37 | Charles Shapiro | * parent_issue_id - ID of the parent issue |
136 | 41 | Jean-Philippe Lang | * watcher_user_ids - Array of user ids to add as watchers (since 2.3.0) |
137 | 5 | Damien Churchill | |
138 | 38 | Jean-Philippe Lang | Attachments can be added when you create an issue, see [[Rest_api#Attaching-files|Attaching files]]. |
139 | 38 | Jean-Philippe Lang | |
140 | 5 | Damien Churchill | h3. Using JSON |
141 | 5 | Damien Churchill | |
142 | 5 | Damien Churchill | POST /issues.json |
143 | 5 | Damien Churchill | { |
144 | 5 | Damien Churchill | "issue": { |
145 | 5 | Damien Churchill | "project_id": "example", |
146 | 27 | Stéphane Schoorens | "subject": "Test issue", |
147 | 27 | Stéphane Schoorens | "custom_field_values":{ |
148 | 27 | Stéphane Schoorens | "1":"1.1.3" #the affected version field |
149 | 27 | Stéphane Schoorens | } |
150 | 5 | Damien Churchill | } |
151 | 5 | Damien Churchill | } |
152 | 5 | Damien Churchill | |
153 | 1 | Jean-Philippe Lang | |
154 | 1 | Jean-Philippe Lang | h2. Updating an issue |
155 | 38 | Jean-Philippe Lang | |
156 | 38 | Jean-Philippe Lang | Attachments can be added when you update an issue, see [[Rest_api#Attaching-files|Attaching files]]. |
157 | 5 | Damien Churchill | |
158 | 5 | Damien Churchill | h3. Using XML |
159 | 1 | Jean-Philippe Lang | |
160 | 5 | Damien Churchill | PUT /issues/[id].xml |
161 | 5 | Damien Churchill | |
162 | 5 | Damien Churchill | h3. Using JSON |
163 | 6 | Robert Palmer | |
164 | 5 | Damien Churchill | PUT /issues/[id].json |
165 | 5 | Damien Churchill | { |
166 | 5 | Damien Churchill | "issue": { |
167 | 20 | Jean-Philippe Lang | "subject": "Example issue (was: Test issue)", |
168 | 20 | Jean-Philippe Lang | "notes": "Changing the subject" |
169 | 20 | Jean-Philippe Lang | } |
170 | 5 | Damien Churchill | } |
171 | 1 | Jean-Philippe Lang | |
172 | 1 | Jean-Philippe Lang | |
173 | 1 | Jean-Philippe Lang | h2. Deleting an issue |
174 | 1 | Jean-Philippe Lang | |
175 | 4 | Ryan Lovelett | DELETE /issues/[id].xml |