Zimbra REST API Reference: Difference between revisions
Line 36: | Line 36: | ||
|The user. To load an explicit user account, specify the user in one of the following formats: | |The user. To load an explicit user account, specify the user in one of the following formats: | ||
<ul> | <ul> | ||
<li>john.doe</li> | <li>john.doe | ||
<pre> | |||
http://localhost:7070/home/john.doe/inbox.rss | |||
</pre> | |||
</li> | |||
<li>john.doe@mydomain.com</li> | <li>john.doe@mydomain.com</li> | ||
<pre> | |||
http://localhost:7070/home/john.doe@mydomain.com/inbox.rss | |||
</pre> | |||
</ul> | </ul> | ||
You can also use "~" as shortcut to the currently authenticated user. For example: | |||
<pre> | <pre> | ||
http://localhost:7070/home/~/inbox.rss | http://localhost:7070/home/~/inbox.rss |
Revision as of 18:52, 16 January 2010
Zimbra exposes its data via a REST API. This document is the reference for that functionality.
REST (REpresentational State Transfer) is an approach for building application services that make resources available via a URL. For example, the following REST command retrieves all inbox items as a simple RSS feed:
http://localhost:7070/home/user1/inbox.rss
Learn more about REST at the Wikipedia article Representational State Transfer.
Command Format
The format of a Zimbra REST command is:
{protocol}://{host}:{port}/home/{user}/{object}?{query-params}
The following describes the components of the REST command:
Component | Description |
protocol
|
The transport protocol, for example, http .
|
host
|
The host name or IP address of the Zimbra Collaboration Suite server |
port
|
The port number, for example, 7070. |
user
|
The user. To load an explicit user account, specify the user in one of the following formats:
http://localhost:7070/home/john.doe@mydomain.com/inbox.rss You can also use "~" as shortcut to the currently authenticated user. For example: http://localhost:7070/home/~/inbox.rss |
object
|
|
query-params
|
Common Parameters
Methods
The API supports the following methods to retrieve Zimbra data.