This is the REST API for managing and retrieving email addresses for people.
The URLs all follow pattern:
/<version>/<resource>/<optional resource_id>?<optional_args>
TODO: explain once authentication is implemented.
Only JSON is supported. The is reflected by an HTTP header of Content-Type: application/json. As per rfc4627, JSON is always encoded Unicode with a default encoding of UTF-8. So it is fine to include non-ASCII in the messages.
For maximum compatibility, normalize to http://unicode.org/reports/tr15 (Unicode Normalization Form C) (NFC) before UTF-8 encoding.
All dates passed to and from the API are strings in the following format:
2012-02-09 15:06 +00:00
2012-02-09 15:06:31 +01:00
2012-02-09 15:06:31.428 -03:00
Errors are indicated using standard HTTP error codes. Additional information is usually included in the returned JSON. Specific meanings for the error codes are given below.
TODO: list them