| 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.
char * |
NSID |
char * |
user name |
int |
icon server |
char * |
real name |
int |
is friend boolean |
int |
is family boolean |
int |
ignored |
int |
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 |