Flickcurl Flickr API Manual | ||||
---|---|---|---|---|
Top | Description |
flickcurl_location; flickcurl_perms; flickcurl_size; void flickcurl_free_size (flickcurl_size *size
); void flickcurl_free_sizes (flickcurl_size **sizes_object
); void flickcurl_free_location (flickcurl_location *location
); void flickcurl_free_perms (flickcurl_perms *perms
); const char * flickcurl_get_field_value_type_label (flickcurl_field_value_type datatype
); const char * flickcurl_get_location_accuracy_label (int accuracy
); flickcurl_photo ** flickcurl_interestingness_getList (flickcurl *fc
,const char *date
,const char *extras
,int per_page
,int page
); flickcurl_photos_list * flickcurl_interestingness_getList_params (flickcurl *fc
,const char *date
,flickcurl_photos_list_params *list_params
); flickcurl_license; const char * flickcurl_get_content_type_label (int content_type
); int flickcurl_get_content_type_from_string (const char *content_type_string
); const char * flickcurl_get_hidden_label (int hidden
); int flickcurl_get_hidden_from_string (const char *hidden_string
); const char * flickcurl_get_safety_level_label (int safety_level
); int flickcurl_get_safety_level_from_string (const char *safety_level_string
); char * flickcurl_user_icon_uri (int farm
,int server
,char *nsid
);
typedef struct { double latitude; double longitude; int accuracy; } flickcurl_location;
A Location in the world with an optional accuracy
typedef struct { int is_public; int is_contact; int is_friend; int is_family; int perm_comment; int perm_addmeta; } flickcurl_perms;
Permissions as used by flickcurl_photos_getPerms()
and
flickcurl_photos_setPerms()
which use public, friend, family,
perm_comment and perm-addmeta. flickcurl_photos_geo_setPerms()
uses
public, contact, friend and family.
A Photo permission.
non-0 to set the photo to public else private | |
non-0 to make the photo visible to contacts when private | |
non-0 to make the photo visible to friends when private | |
non-0 to make the photo visible to family when private | |
who can add comments to the photo and it's notes. one of: 0 nobody, 1 friends & family, 2 contacts, 3 everybody | |
who can add notes and tags to the photo. one of: 0 nobody / just the owner, 1 friends & family, 2 contacts, 3 everybody |
typedef struct { char *label; int width; int height; char *source; char *url; char* media; } flickcurl_size;
A photo at a size.
Supported sizes and their letter suffixes used in the source
and
the url
fields are as follows:
s: small square 75x75. q: large square 150x150 (2011-03-12 or later). t: thumbnail, 100 on longest side. m: small, 240 on longest side. n: small, 320 on longest side (2011-03-12 or later). -: medium, 500 on longest side. z: medium 640, 640 on longest side. b: large, 1024 on longest side*. o: original image, either a jpg, gif or png, depending on source format.
The 'q' and 'n' sizes were announced 2011-03-12 in http://tech.groups.yahoo.com/group/yws-flickr/message/7483
void flickcurl_free_size (flickcurl_size *size
);
Destructor for size object
|
size object |
void flickcurl_free_sizes (flickcurl_size **sizes_object
);
Destructor for array of size objects
|
size object array |
void flickcurl_free_location (flickcurl_location *location
);
Destructor for location object
|
location object |
void flickcurl_free_perms (flickcurl_perms *perms
);
Destructor for perms object
|
perms object |
const char * flickcurl_get_field_value_type_label
(flickcurl_field_value_type datatype
);
Get label for datatype
|
datatype enum |
Returns : |
label string or NULL if none valid |
const char * flickcurl_get_location_accuracy_label
(int accuracy
);
Get label for an accuracy
|
accuracy |
Returns : |
label string or NULL if none valid |
flickcurl_photo ** flickcurl_interestingness_getList (flickcurl *fc
,const char *date
,const char *extras
,int per_page
,int page
);
Returns the list of interesting photos for the most recent day or a user-specified date.
See flickcurl_interestingness_getList()
for full description of arguments.
Implements flickr.interestingness.getList (0.13)
|
flickcurl context |
|
A specific date, formatted as YYYY-MM-DD, to return interesting photos for. (or NULL) |
|
A comma-delimited list of extra information to fetch for each returned record. See flickcurl_photos_list_params for the full list (or NULL) |
|
Number of photos to return per page default 100, max 500 |
|
The page of results to return, default 1 |
Returns : |
non-0 on failure |
flickcurl_photos_list * flickcurl_interestingness_getList_params (flickcurl *fc
,const char *date
,flickcurl_photos_list_params *list_params
);
Returns the list of interesting photos for the most recent day or a user-specified date.
Optional extra type 'media' that will return an extra media = VALUE for VALUE "photo" or "video". API addition 2008-04-07.
|
flickcurl context |
|
A specific date, formatted as YYYY-MM-DD, to return interesting photos for. (or NULL) |
|
flickcurl_photos_list_params result parameters (or NULL) |
Returns : |
non-0 on failure |
typedef struct { /* license id */ int id; /* license url or NULL if none */ char *url; /* license name */ char *name; } flickcurl_license;
A photo license.
const char * flickcurl_get_content_type_label (int content_type
);
Get label for a content type.
|
safety level index |
Returns : |
pointer to shared string label for content type or "unknown" |
int flickcurl_get_content_type_from_string
(const char *content_type_string
);
Get the enumeration value for a content type string.
Parses the string value into a content type either from an integer form like '1' or a label like 'photo'.
|
string |
Returns : |
content type enumeration value or <0 on error |
const char * flickcurl_get_hidden_label (int hidden
);
Get label for a hidden status
|
safety level index |
Returns : |
pointer to shared string label for hidden status or "unknown" |
int flickcurl_get_hidden_from_string (const char *hidden_string
);
Get the enumeration value for a hidden status string.
Parses the string value into a safety level either from an integer form like '1' or a label like 'hidden'.
|
string |
Returns : |
safety level enumeration value or <0 on error |
const char * flickcurl_get_safety_level_label (int safety_level
);
Get label for a safety level.
|
safety level index |
Returns : |
pointer to shared string label for safety level or "unknown" |
int flickcurl_get_safety_level_from_string
(const char *safety_level_string
);
Get the enumeration value for a safety level string.
Parses the string value into a safety level either from an integer form like '1' or a label like 'safe'.
|
string |
Returns : |
safety level enumeration value or <0 on error |
char * flickcurl_user_icon_uri (int farm
,int server
,char *nsid
);
Get the user's icon URI
The icon URI returned is always a 48x48 pixel JPEG.
If server
is 0 (or the other fields are NULL), the default icon URI of
https://www.flickr.com/images/buddyicon.jpg is returned.
Defined by https://www.flickr.com/services/api/misc.buddyicons.html
|
user icon farm |
|
user icon server or 0 |
|
user nsid |
Returns : |
new icon URI string or NULL on failure |