Chapter 1. Introduction
Overview
The Address Book API is a Web Service API that allows developers to integrate their applications with the Yahoo! Address Book. Developers both on and off the network can add, edit and retrieve the addresses of Address Book contacts. Requests and Results are sent and returned, respectively, in either XML or JavaScript Object Notation (JSON).
The Yahoo! Address Book API provides the following methods :
- searchContacts
Retrieves a subset of the Address Book given a search criteria. In absence of search criteria this method retrieves the complete Address Book.
- getCategories
Retrieves the list of categories present in the Address Book.
- addContacts
Adds new information to the Address Book. If the contact already exists in the system, Address Book merges the information with the existing contact; otherwise, it creates a new contact.
- synchronize
Retrieves recent changes from the Address Book and optionally propagates updates.
The next section describes how to send Address Book Requests.