Labs/Contacts/ContentAPI: Difference between revisions

update warnings to indicate different scopes of efforts / related work
(update warnings to indicate different scopes of efforts / related work)
 
(2 intermediate revisions by 2 users not shown)
Line 1: Line 1:
== WARNING ==
'''WARNING: the content of this page is over a year old and may be out-of-date / inaccurate with respect to current Contacts / ContentAPI thinking.'''
Please see:
* The [[WebAPI/ContactsAPI|ContactsAPI]] for current device-centric WebAPI for accessing device contacts.
There are still use-cases for a higher-level more "appy" Contacts API that allows web apps to both access contacts and be a provider for contacts, for that see work on:
* [[WebActions]]
* [[WebActvities]]
- [[User:Tantek|Tantek]]
== Summary ==
The Contacts add-on adds a database of contact data to the browser, and allows web pages to request data from this database to use in web content.
The Contacts add-on adds a database of contact data to the browser, and allows web pages to request data from this database to use in web content.


Line 35: Line 48:


== Contact Schema ==
== Contact Schema ==
'''WARNING: this section as well as Portable Contacts are out-of-date as of 2012 with the latest converged web contacts schemas.'''
See [[vCard4]] and [[WebAPI/ContactsAPI]]. - [[User:Tantek|Tantek]] 17:37, 10 January 2012 (PST)
----


The schema for Contacts is [http://portablecontacts.net/draft-spec.html| Portable Contacts version 1.0].
The schema for Contacts is [http://portablecontacts.net/draft-spec.html| Portable Contacts version 1.0].
Line 66: Line 84:
The implementation of these services is variable, depending on the web service involved, but the names and APIs of the service methods are designed to allow for a degree of interoperability and automatic discovery of a person's "social API".
The implementation of these services is variable, depending on the web service involved, but the names and APIs of the service methods are designed to allow for a degree of interoperability and automatic discovery of a person's "social API".


To enable this API, set "extensions.mozillalabs.contacts.allowServices" to true in about:config.
'''To enable this API, set "extensions.mozillalabs.contacts.allowServices" to "true" in about:config.'''


At present, the services API includes the following methods:
At present, the services API includes the following methods:
canmove, Confirmed users
2,848

edits