Zimbra REST API Reference:Get Contacts: Difference between revisions
No edit summary |
|||
Line 39: | Line 39: | ||
</li> | </li> | ||
<li><code>meta</code>. Optional. If format is <code>tar</code> or <code>tgz</code>, optionally select the CSV type which include. Use <code>meta=1</code> to include meta files, <code>meta=0</code> to not include meta files. If omitted, defaults to <code>meta=1</code>.</li> | <li><code>meta</code>. Optional. If format is <code>tar</code> or <code>tgz</code>, optionally select the CSV type which include. Use <code>meta=1</code> to include meta files, <code>meta=0</code> to not include meta files. If omitted, defaults to <code>meta=1</code>.</li> | ||
<li><code>query</code>. Optional. A query | <li><code>query</code>. Optional. A query string.</li> | ||
</ul> | </ul> | ||
Line 60: | Line 60: | ||
<pre> | <pre> | ||
http://localhost:7070/home/john.doe/contacts?fmt=json | http://localhost:7070/home/john.doe/contacts?fmt=json | ||
</pre> | |||
Retrieve the contacts with the string "martha" in JSON format: | |||
<pre> | |||
http://localhost:7070/home/john.doe/contacts?fmt=json&query=martha | |||
</pre> | </pre> | ||
Revision as of 17:22, 19 January 2010
<< Back to Zimbra REST API Reference
REST API Method: Get Contacts
Gets the contacts in the designated folder. The default folder is "contacts" but user-defined folders are also supported.
HTTP Method
GET
URL
http://localhost:7070/home/john.doe/contacts?{params}
Formats
csv,json,xml,tgz,zip
(Go to Response Formats)
Note: the ZIP format includes the contacts as individual vCard .vcf
files
Requires Authentication
true
(Go to Authentication)
Parameters
fmt
. Optional. The response format. Defaults tocsv
.csvfmt
. Optional. If format iscsv
, optionally select the CSV type which include:- zimbra-csv
- yahoo-csv
- thunderbird-csv
- outlook-2000-csv
- outlook-2003-csv
meta
. Optional. If format istar
ortgz
, optionally select the CSV type which include. Usemeta=1
to include meta files,meta=0
to not include meta files. If omitted, defaults tometa=1
.query
. Optional. A query string.
Usage Examples
Download the contacts as a CSV file:
http://localhost:7070/home/john.doe/contacts
http://localhost:7070/home/john.doe/contacts?fmt=csv
Retrieve the contacts in XML format:
http://localhost:7070/home/john.doe/contacts?fmt=xml
Retrieve the contacts in JSON format:
http://localhost:7070/home/john.doe/contacts?fmt=json
Retrieve the contacts with the string "martha" in JSON format:
http://localhost:7070/home/john.doe/contacts?fmt=json&query=martha
Download the contacts as a ZIP file:
http://localhost:7070/home/john.doe/contacts?fmt=zip
Retrieve the contacts from the used-defined folder "Contacts > MyBusinessContacts" as JSON format:
http://localhost:7070/home/john.doe/contacts/mybusinescontacts?fmt=json
Retrieve the contacts from the used-defined folder "SalesContacts" as XML format:
http://localhost:7070/home/john.doe/salescontacts?fmt=xml