section-contact: Flickcurl Flickr API Manual

section-contact

Functions

flickcurl_contact **	flickcurl_contacts_getList ()
flickcurl_contact **	flickcurl_contacts_getListRecentlyUploaded ()
flickcurl_contact **	flickcurl_contacts_getPublicList ()
flickcurl_contact **	flickcurl_contacts_getTaggingSuggestions ()
void	flickcurl_free_contact ()
void	flickcurl_free_contacts ()

Types and Values

flickcurl_contact

Description

Functions

flickcurl_contacts_getList ()

flickcurl_contact **
flickcurl_contacts_getList (flickcurl *fc,
                            const char *filter,
                            int page,
                            int per_page);

Get a list of contacts for the calling user.

Implements flickr.contacts.getList (0.11)

Parameters

fc	flickcurl context
filter	An optional filter of the results. The following values are valid: friends, family, both or neither (or NULL)
page	The page of results to return. If this argument is omitted, it defaults to 1. (or NULL)
per_page	Number of photos to return per page. If this argument is omitted, it defaults to 1000. The maximum allowed value is 1000. (or NULL)

Returns

NULL on failure

flickcurl_contacts_getListRecentlyUploaded ()

flickcurl_contact **
flickcurl_contacts_getListRecentlyUploaded
                               (flickcurl *fc,
                                int date_lastupload,
                                const char *filter);

Return a list of contacts for a user who have recently uploaded photos along with the total count of photos uploaded.

This API added 2009-01-14 as announced in http://tech.groups.yahoo.com/group/yws-flickr/message/4668

Implements flickr.contacts.getListRecentlyUploaded (1.8)

Parameters

fc	flickcurl context
date_lastupload	Limits the results to contacts that have uploaded photos since this date (in the form of a Unix timestamp). The default, and maximum, offset is 1 hour. (or < 0)
filter	Limit the result set to all contacts or only those who are friends or family. Valid options are: ff: friends and family, all: all your contacts. Default value is "all". (or NULL)

Returns

NULL on failure

flickcurl_contacts_getPublicList ()

flickcurl_contact **
flickcurl_contacts_getPublicList (flickcurl *fc,
                                  const char *user_id,
                                  int page,
                                  int per_page);

Get the contact list for a user.

Implements flickr.contacts.getPublicList (0.11)

Parameters

fc	flickcurl context
user_id	The NSID of the user to fetch the contact list for.
page	The page of results to return. If this argument is omitted, it defaults to 1. (or NULL)
per_page	Number of photos to return per page. If this argument is omitted, it defaults to 1000. The maximum allowed value is 1000. (or NULL)

Returns

list of contacts or NULL on failure

flickcurl_contacts_getTaggingSuggestions ()

flickcurl_contact **
flickcurl_contacts_getTaggingSuggestions
                               (flickcurl *fc,
                                const char *include_self,
                                const char *include_address_book,
                                int page,
                                int per_page);

Get suggestions for tagging people in photos based on the calling user's contacts.

Implements flickr.contacts.getTaggingSuggestions (1.25)

NOTE: Parameter order is page , per_page like all other flickr.contacts.* calls, NOT per_page , page like in the API docs.

Parameters

fc	flickcurl context
include_self	Return calling user in the list of suggestions. Default: true. (or NULL)
include_address_book	Include suggestions from the user's address book. Default: false (or NULL)
page	The page of results to return. If this argument is omitted, it defaults to 1. (or < 0)
per_page	Number of contacts to return per page. If this argument is omitted, all contacts will be returned. (or < 0)

Returns

list of contacts or NULL on failure

flickcurl_free_contact ()

void
flickcurl_free_contact (flickcurl_contact *contact_object);

Destructor for contact object

Parameters

contact_object

contact object

flickcurl_free_contacts ()

void
flickcurl_free_contacts (flickcurl_contact **contacts_object);

Destructor for array of contact object

Parameters

contacts_object

contact object array

Types and Values

flickcurl_contact

typedef struct {
  char *nsid;
  char *username;
  int iconserver;
  char *realname;
  int is_friend;
  int is_family;
  int ignored;
  int uploaded;
} flickcurl_contact;

A contact.

Members

char *`nsid`;	NSID
char *`username`;	user name
int `iconserver`;	icon server
char *`realname`;	real name
int `is_friend`;	is friend boolean
int `is_family`;	is family boolean
int `ignored`;	ignored
int `uploaded`;	count of number of photos uploaded (for `flickcurl_contacts_getListRecentlyUploaded()` )