|  |  | Flickcurl Flickr API Manual |  | |
|---|---|---|---|---|
| Top | Description | ||||
flickcurl_contact; flickcurl_contact ** flickcurl_contacts_getList (flickcurl *fc,const char *filter,int page,int per_page); flickcurl_contact ** flickcurl_contacts_getListRecentlyUploaded (flickcurl *fc,int date_lastupload,const char *filter); flickcurl_contact ** flickcurl_contacts_getPublicList (flickcurl *fc,const char *user_id,int page,int per_page); flickcurl_contact ** flickcurl_contacts_getTaggingSuggestions (flickcurl *fc,const char *include_self,const char *include_address_book,int page,int per_page); void flickcurl_free_contact (flickcurl_contact *contact_object); void flickcurl_free_contacts (flickcurl_contact **contacts_object);
typedef struct {
  char *nsid;
  char *username;
  int iconserver;
  char *realname;
  int is_friend;
  int is_family;
  int ignored;
  int uploaded;
} flickcurl_contact;
A contact.
| NSID | |
| user name | |
| icon server | |
| real name | |
| is friend boolean | |
| is family boolean | |
| ignored | |
| count of number of photos uploaded (for flickcurl_contacts_getListRecentlyUploaded()) | 
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)
| 
 | flickcurl context | 
| 
 | An optional filter of the results. The following values are valid: friends, family, both or neither (or NULL) | 
| 
 | The page of results to return. If this argument is omitted, it defaults to 1. (or NULL) | 
| 
 | 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_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)
| 
 | flickcurl context | 
| 
 | 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) | 
| 
 | 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_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)
| 
 | flickcurl context | 
| 
 | The NSID of the user to fetch the contact list for. | 
| 
 | The page of results to return. If this argument is omitted, it defaults to 1. (or NULL) | 
| 
 | 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_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.
| 
 | flickcurl context | 
| 
 | Return calling user in the list of suggestions. Default: true. (or NULL) | 
| 
 | Include suggestions from the user's address book. Default: false (or NULL) | 
| 
 | The page of results to return. If this argument is omitted, it defaults to 1. (or < 0) | 
| 
 | 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 | 
void                flickcurl_free_contact              (flickcurl_contact *contact_object);
Destructor for contact object
| 
 | contact object | 
void                flickcurl_free_contacts             (flickcurl_contact **contacts_object);
Destructor for array of contact object
| 
 | contact object array |