The Faves del.icio.us API provides a simple way to leverage existing tools built atop the del.icio.us v1 API.
Faves works a bit differently from del.icio.us in certain areas.
URL path syntax is compatible, but the host name is different. Thus, the call to:
https://api.del.icio.us/v1/tags/get
maps to:
https://secure.faves.com/v1/tags/get
Faves does not support tag bundling, so the Bundles section of the del.icio.us API is not supported.
Faves supports multi-word tags, and multi-tag strings are separated by commas. In del.icio.us, tags are space-delimited and must be single words. By default, results from the Faves del.icio.us API are modified to be space delimited (spaces in individual tags are replaced with underscores). Thus, the tag string "harvey danger, digital music" would become "harvey_danger digital_music" (this applies to both /posts and /tags).
The default behavior allows existing tag parsing functions in API clients to be used without modification. However, this may also ambiguate certain tags. To return results in their original comma-delimited format, simply add the querystring tags=full to any tag-returing API call. For example:
https://secure.faves.com/v1/posts/recent?tags=full
Faves allows multiple Faves for a single URL, while del.icio.us limits to one per user. Thus, the same URL may be returned multiple times in a given result. Similarly, calling /posts/delete may result in more than one Fave being removed.
If your tool needs to generate URLs from returned API data (for example, to open a browser window with a full Fave listing for a given Fave or tag), it will need to include some Faves-specific code. Here are the patterns for common URLs:
Single Fave page (with comments):
http://faves.com/users/[username]/dot/[dotid]
Tag search:
http://faves.com/users/[username]?st=tag%3a[tag]
Multi-tag search:
http://faves.com/users/[username]?st=tag%3a[tag0]+tag%3a[tagn]
Faves allows you to associate an image with your Fave by specifying an optional image argument:
https://secure.faves.com/v1/posts/add?image=[imageUrl].