Zimbra REST API Reference:Get Contacts: Difference between revisions
No edit summary |
(Adding categories) |
||
Line 85: | Line 85: | ||
{{Article Footer|Zimbra Collaboration Suite 6.0|01/16/2010}} | {{Article Footer|Zimbra Collaboration Suite 6.0|01/16/2010}} | ||
[[Category:REST]] | |||
[[Category:ZCS 6.0]] |
Revision as of 19:00, 21 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