| 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); 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 : |
non-0 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 |