Project

General

Profile

Rest api » History » Version 18

Javier Hernandez, 2010-11-09 09:56

1 1 Jean-Philippe Lang
h1. Redmine API
2
3
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
5
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
7 8 Ryan Lovelett
-_At the time of writing, the API is only available in trunk (see r3310, r3313)._-
8 1 Jean-Philippe Lang
9 8 Ryan Lovelett
At the time of writing, the API is available in _both_ the trunk and the stable-1.0 branch. See [[CheckingoutRedmine]]
10
11 1 Jean-Philippe Lang
h2. API Description
12
13 15 Eric Davis
Status legend:
14
15
* Stable - feature complete, no major changes planned
16
* Beta - usable for integrations with some bugs or missing minor functionality
17
* Alpha - major functionality in place, needs feedback from API users and integrators
18
* Prototype - very rough implementation, possible major breaking changes mid-version. *Not recommended for integration*
19
* Planned - planned in a future version, depending on developer availability
20
* Unplanned - no plans for an api in a near version.
21
22
23
|*Resource*                     | *Status*    | *Notes*  |
24
|[[Rest_Issues|Issues]]         | Beta        | Usable with some bugs and rough edges.  |
25
|[[Rest_Projects|Projects]]     | Beta        | Usable with some bugs and rough edges.  |
26
|[[Rest_Users|Users]]           | Planned 1.1 | |
27
|[[Rest_WikiPages|Wiki Pages]]  | Planned 1.1 | |
28
|[[Rest_Files|Files]]           | Planned 1.1 | |
29
|[[Rest_News|News]]             | Prototype, Planned 1.1 | Prototype implementation for @index@ only |
30
|[[Rest_AuthSources|Auth Sources]]           | Unplanned | |
31
|[[Rest_Boards|Boards]]           | Unplanned | Forums. See Messages for actual threads and posts |
32
|[[Rest_Documents|Documents]]           | Unplanned | Might be merged with Files |
33
|[[Rest_Enumerations|Enumerations]]           | Unplanned | |
34
|[[Rest_Groups|Groups]]           | Unplanned | |
35
|[[Rest_IssueCategories|Issue Categories]]           | Unplanned | |
36
|[[Rest_IssueRelations|Issue Relations]]           | Unplanned | |
37
|[[Rest_IssueStatuses|Issue Statuses]]           | Unplanned | |
38
|[[Rest_Journals|Journals]]           | Unplanned | Issue notes and updates (history) |
39
|[[Rest_Members|Members]]           | Unplanned | |
40
|[[Rest_Messages|Messages]]           | Unplanned | Forum posts|
41
|[[Rest_Query|Query]]           | Unplanned | Custom issue queries |
42
|[[Rest_Repositories|Repositories]]           | Unplanned | |
43
|[[Rest_Roles|Roles]]           | Unplanned | |
44
|[[Rest_Settings|Settings]]           | Unplanned | |
45
|[[Rest_TimeEntries|TimeEntries]]           | Unplanned | |
46
|[[Rest_Trackers|Trackers]]           | Unplanned | |
47
|[[Rest_Versions|Versions]]           | Unplanned | |
48
|[[Rest_WikiContents|WikiContents]]           | Unplanned | History of a wiki page. May be merged into the main Wiki API|
49 1 Jean-Philippe Lang
50
h2. API Usage
51
52 5 Jean-Philippe Lang
* [[Rest_api_with_ruby|Ruby]]
53 1 Jean-Philippe Lang
* [[Rest_api_with_php|PHP]]
54 18 Javier Hernandez
* [[Rest_api_with_python|Python]]
55 16 Ian Epperson
* "Python library":http://code.google.com/p/pyredminews/