Zimbra REST API Reference:Get Contacts: Difference between revisions
(→URL) |
Malte Stretz (talk | contribs) (Remove old ZCS_6.0 prefixes) |
||
(8 intermediate revisions by 3 users not shown) | |||
Line 1: | Line 1: | ||
[[ZCS_6.0:Zimbra_REST_API_Reference|<< Back to Zimbra REST API Reference]] | {{Template:TabHeader}} | ||
{{Template:Tab2|[[Zimbra_REST_API_Reference|Introduction]]}} | |||
{{Template:Tab2|[[Zimbra_REST_API_Reference:Get_Folder|Method: Get Folder]]}} | |||
{{Template:Tab2|[[Zimbra_REST_API_Reference:Import_Message|Method: Import Message]]}} | |||
{{Template:Tab1|[[Zimbra_REST_API_Reference:Get_Contacts|Method: Get Contacts]]}} | |||
{{Template:Tab2|[[Zimbra_REST_API_Reference:Import_Contacts|Method: Import Contacts]]}} | |||
{{Template:Tab2|[[Zimbra_REST_API_Reference:Get_Calendar|Method: Get Calendar]]}} | |||
{{Template:Tab2|[[Zimbra_REST_API_Reference:Get_FreeBusy|Method: Get FreeBusy]]}} | |||
{{Template:Tab2|[[Zimbra_REST_API_Reference:Import_Appointments|Method: Import Appointments]]}} | |||
{{Template:Tab2|[[Zimbra_REST_API_Reference:Get_Tasks|Method: Get Tasks]]}} | |||
{{Template:Tab2|[[Zimbra_REST_API_Reference:Get_Item|Method: Get Item]]}} | |||
{{Template:Tab2|[[Zimbra_REST_API_Reference:Get_Briefcase|Method: Get Briefcase]]}} | |||
{{Template:Tab2|[[Zimbra_REST_API_Reference:Get_Briefcase_Item|Method: Get Briefcase Item]]}} | |||
{{Template:Tab2|[[Zimbra_REST_API_Reference:Export_Mailbox|Method: Export Mailbox]]}} | |||
{{Template:TabFooter}} | |||
{{Article Infobox|{{devel}}|{{ZCS 8.0}}|{{ZCS 7.0}}|{{ZCS 6.0}}|}}[[ZCS_6.0:Zimbra_REST_API_Reference|<< Back to Zimbra REST API Reference]] | |||
== REST API Method: Get Contacts == | == REST API Method: Get Contacts == | ||
Gets the contacts in the designated folder. The default folder is "contacts" but user-defined folders are also supported. | Gets the contacts in the designated folder. The default folder is "contacts" but user-defined folders are also supported. | ||
=== URL === | === URL === | ||
Line 16: | Line 28: | ||
Go to [[ZCS_6.0:Zimbra_REST_API_Reference#Command_Format|Command Format]] | Go to [[ZCS_6.0:Zimbra_REST_API_Reference#Command_Format|Command Format]] | ||
=== HTTP Method === | |||
<code>GET</code> | |||
=== Formats === | === Formats === | ||
Line 86: | Line 102: | ||
{{Article Footer|Zimbra Collaboration | {{Article Footer|Zimbra Collaboration Server 7.0|01/16/2010}} | ||
[[Category:REST]] | [[Category:REST]] | ||
[[Category:ZCS 7.0]] | |||
[[Category:ZCS 6.0]] | [[Category:ZCS 6.0]] | ||
[[Category:Developers]] |
Latest revision as of 17:22, 5 August 2014
Article Information |
---|
This article applies to the following ZCS versions. |
<< 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.
URL
http://localhost:7070/home/john.doe/contacts?{params}
Go to Command Format
HTTP Method
GET
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