Rest api with curl » History » Version 5

Version 4 (Terence Mill, 2011-12-12 11:22) → Version 5/10 (Jean-Philippe Lang, 2012-02-23 11:43)

h1. Using the REST API with cURL

"curl":http://curl.haxx.se/ is a command-line tool for transferring data using various protocols. It can be used to interact with the Redmine REST API.

h2. Using JSON

Here is a simple example of a command that can be used to update an issue:

<pre>
curl -v -H "Content-Type: application/json" -X PUT --data "@388.json" -u login:password http://redmine/issues/388.json
curl -v -H "Content-Type: application/json" -X PUT --data "@388.json" -H "X-Redmine-API-Key: xxxx" http://redmine/issues/388.json
</pre>

The file that contains the data sent to Redmine (388.json in the example above) would look like this:

<pre>
{
"issue": {
"subject": "subject123",
"notes": "Changing the subject"
}
}
</pre>

Note: it's required to set the @Content-Type@ header according to the format of the data you are sending. It must be set to one the following values:
* @application/json@
* @application/xml@

h2. Using XML

Here is a simple example of a command that can be used to create an issue with custom fields:

<pre>
curl -v -H "Content-Type: application/xml" -X POST --data "@issue.xml" -u login:password http://redmine/issues.xml
curl -v -H "Content-Type: application/xml" -X POST --data "@issue.xml" -H "X-Redmine-API-Key: xxxx" http://redmine/issues.xml

</pre>

Where issue.xml content is:

<pre>
<?xml version="1.0" encoding="ISO-8859-1" ?>
<issue>
<subject>API custom fields</subject>
<project_id>1</project_id>
<tracker_id>2</tracker_id>
<custom_fields type="array">
<custom_field>
<id>2</id>
<value>Fixed</value>
</custom_field>
<custom_field>
<id>1</id>
<value>0.8.2</value>
</custom_field>
</custom_fields>
</issue>
</pre>

h2. Attaching files

If you want to create an issue with image.png attached, you need to upload this file first:

<pre>
curl --data-binary "@image.png" -H "Content-Type: application/octet-stream" -X POST -u login:password http://redmine/uploads.xml

# 201 response
<upload>
<token>7167.ed1ccdb093229ca1bd0b043618d88743</token>
</upload>
</pre>

Then, use the token to create the issue:

<pre>
curl -v -H "Content-Type: application/xml" -X POST --data "@issue.xml" -u login:password http://redmine/issues.xml
</pre>

Where issue.xml content is:

<pre>
<?xml version="1.0" encoding="ISO-8859-1" ?>
<issue>
<subject>Issue with attachment</subject>
<project_id>1</project_id>
<uploads type="array">
<upload>
<token>7167.ed1ccdb093229ca1bd0b043618d88743</token>
<filename>image.png</filename>
<content_type>image/png</content_type>
</upload>
</uploads>
</issue>
</pre>