Rest api » History » Version 20

Jean-Philippe Lang, 2010-12-03 23:26
Availability column added and misc updates

1 1 Jean-Philippe Lang
h1. Redmine API
2 1 Jean-Philippe Lang
3 1 Jean-Philippe Lang
Redmine exposes some of its data through a REST API. This API provides access and basic CRUD operations (create, update, delete) for the resources described below.
4 1 Jean-Philippe Lang
5 1 Jean-Philippe Lang
Most of the time, the API requires authentication. This is done via HTTP Basic authentication using the regular Redmine accounts. To enable this API-style authentication, check *Enable REST API* in Administration -> Settings -> Authentication.
6 1 Jean-Philippe Lang
7 1 Jean-Philippe Lang
h2. API Description
8 1 Jean-Philippe Lang
9 15 Eric Davis
Status legend:
10 15 Eric Davis
11 15 Eric Davis
* Stable - feature complete, no major changes planned
12 15 Eric Davis
* Beta - usable for integrations with some bugs or missing minor functionality
13 15 Eric Davis
* Alpha - major functionality in place, needs feedback from API users and integrators
14 15 Eric Davis
* Prototype - very rough implementation, possible major breaking changes mid-version. *Not recommended for integration*
15 1 Jean-Philippe Lang
* Planned - planned in a future version, depending on developer availability
16 1 Jean-Philippe Lang
* Unplanned - no plans for an api in a near version.
17 1 Jean-Philippe Lang
18 1 Jean-Philippe Lang
19 20 Jean-Philippe Lang
|_.Resource                     |_.Status     |_.Notes  |_.Availability|
20 20 Jean-Philippe Lang
|[[Rest_Issues|Issues]]         | Beta        | Usable with some bugs and rough edges.  | 1.0 |
21 20 Jean-Philippe Lang
|[[Rest_Projects|Projects]]     | Beta        | Usable with some bugs and rough edges.  | 1.0 |
22 20 Jean-Philippe Lang
|[[Rest_Users|Users]]           | Planned | | 1.1 |
23 20 Jean-Philippe Lang
|[[Rest_TimeEntries|TimeEntries]]           | Planned | | 1.1 |
24 20 Jean-Philippe Lang
|[[Rest_WikiPages|Wiki Pages]]  | Planned | | |
25 20 Jean-Philippe Lang
|[[Rest_Files|Files]]           | Planned | | |
26 20 Jean-Philippe Lang
|[[Rest_News|News]]             | Prototype, Planned | Prototype implementation for @index@ only | |
27 20 Jean-Philippe Lang
|[[Rest_AuthSources|Auth Sources]]           | Unplanned | | |
28 20 Jean-Philippe Lang
|[[Rest_Boards|Boards]]           | Unplanned | Forums. See Messages for actual threads and posts | |
29 20 Jean-Philippe Lang
|[[Rest_Documents|Documents]]           | Unplanned | Might be merged with Files | |
30 20 Jean-Philippe Lang
|[[Rest_Enumerations|Enumerations]]           | Unplanned | | |
31 20 Jean-Philippe Lang
|[[Rest_Groups|Groups]]           | Unplanned | | |
32 20 Jean-Philippe Lang
|[[Rest_IssueCategories|Issue Categories]]           | Unplanned | | |
33 20 Jean-Philippe Lang
|[[Rest_IssueRelations|Issue Relations]]           | Unplanned | | |
34 20 Jean-Philippe Lang
|[[Rest_IssueStatuses|Issue Statuses]]           | Unplanned | | |
35 20 Jean-Philippe Lang
|[[Rest_Journals|Journals]]           | Unplanned | Issue notes and updates (history) | |
36 20 Jean-Philippe Lang
|[[Rest_Members|Members]]           | Unplanned | | |
37 20 Jean-Philippe Lang
|[[Rest_Messages|Messages]]           | Unplanned | Forum posts| |
38 20 Jean-Philippe Lang
|[[Rest_Query|Query]]           | Unplanned | Custom issue queries | |
39 20 Jean-Philippe Lang
|[[Rest_Repositories|Repositories]]           | Unplanned | | |
40 20 Jean-Philippe Lang
|[[Rest_Roles|Roles]]           | Unplanned | | |
41 20 Jean-Philippe Lang
|[[Rest_Settings|Settings]]           | Unplanned | | |
42 20 Jean-Philippe Lang
|[[Rest_Trackers|Trackers]]           | Unplanned | | |
43 20 Jean-Philippe Lang
|[[Rest_Versions|Versions]]           | Unplanned | | |
44 20 Jean-Philippe Lang
|[[Rest_WikiContents|WikiContents]]           | Unplanned | History of a wiki page. May be merged into the main Wiki API| |
45 1 Jean-Philippe Lang
46 20 Jean-Philippe Lang
h2. API Usage in various languages
47 1 Jean-Philippe Lang
48 5 Jean-Philippe Lang
* [[Rest_api_with_ruby|Ruby]]
49 1 Jean-Philippe Lang
* [[Rest_api_with_php|PHP]]
50 18 Javier Hernandez
* [[Rest_api_with_python|Python]]