Favorites

Favorites — Favorite photos.

Synopsis




int                 flickcurl_favorites_add             (flickcurl *fc,
                                                         const char *photo_id);
flickcurl_photo**   flickcurl_favorites_getList         (flickcurl *fc,
                                                         const char *user_id,
                                                         const char *extras,
                                                         int per_page,
                                                         int page);
flickcurl_photo**   flickcurl_favorites_getPublicList   (flickcurl *fc,
                                                         const char *user_id,
                                                         const char *extras,
                                                         int per_page,
                                                         int page);
int                 flickcurl_favorites_remove          (flickcurl *fc,
                                                         const char *photo_id);

Description

Favorite photos.

Details

flickcurl_favorites_add ()

int                 flickcurl_favorites_add             (flickcurl *fc,
                                                         const char *photo_id);

Adds a photo to a user's favorites list.

Implements flickr.favorites.add (1.0)

fc :

flickcurl context

photo_id :

The id of the photo to add to the user's favorites.

Returns :

non-0 on failure

flickcurl_favorites_getList ()

flickcurl_photo**   flickcurl_favorites_getList         (flickcurl *fc,
                                                         const char *user_id,
                                                         const char *extras,
                                                         int per_page,
                                                         int page);

Returns a list of the user's favorite photos.

Only photos which the calling user has permission to see are returned.

Implements flickr.favorites.getList (1.0)

fc :

flickcurl context

user_id :

The NSID of the user to fetch the favorites list for. If this argument is omitted, the favorites list for the calling user is returned. (or NULL)

extras :

A comma-delimited list of extra information to fetch for each returned record. Currently supported fields are: license, date_upload, date_taken, owner_name, icon_server, original_format, last_update, geo, tags, machine_tags. (or NULL)

per_page :

Number of photos to return per page. If this argument is omitted, it defaults to 100. The maximum allowed value is 500. (or NULL)

page :

The page of results to return. If this argument is omitted, it defaults to 1. (or NULL)

Returns :

non-0 on failure

flickcurl_favorites_getPublicList ()

flickcurl_photo**   flickcurl_favorites_getPublicList   (flickcurl *fc,
                                                         const char *user_id,
                                                         const char *extras,
                                                         int per_page,
                                                         int page);

Returns a list of favorite public photos for the given user.

Implements flickr.favorites.getPublicList (1.0)

fc :

flickcurl context

user_id :

The user to fetch the favorites list for.

extras :

A comma-delimited list of extra information to fetch for each returned record. Currently supported fields are: license, date_upload, date_taken, owner_name, icon_server, original_format, last_update, geo, tags, machine_tags. (or NULL)

per_page :

Number of photos to return per page. If this argument is omitted, it defaults to 100. The maximum allowed value is 500. (or NULL)

page :

The page of results to return. If this argument is omitted, it defaults to 1. (or NULL)

Returns :

non-0 on failure

flickcurl_favorites_remove ()

int                 flickcurl_favorites_remove          (flickcurl *fc,
                                                         const char *photo_id);

Removes a photo from a user's favorites list.

Implements flickr.favorites.remove (1.0)

fc :

flickcurl context

photo_id :

The id of the photo to remove from the user's favorites.

Returns :

non-0 on failure