|
|
Flickcurl Flickr API Manual | |
|
|---|---|---|---|---|
flickcurl_photo;
void flickcurl_free_photo (flickcurl_photo *photo);
void flickcurl_free_photos (flickcurl_photo **photos);
const char* flickcurl_get_photo_field_label (flickcurl_photo_field_type field);
char* flickcurl_photo_as_source_uri (flickcurl_photo *photo,
const char c);
flickcurl_photo_field;
enum flickcurl_photo_field_type;
enum flickcurl_field_value_type;
int flickcurl_photos_addTags (flickcurl *fc,
const char *photo_id,
const char *tags);
char* flickcurl_photos_comments_addComment
(flickcurl *fc,
const char *photo_id,
const char *comment_text);
int flickcurl_photos_comments_deleteComment
(flickcurl *fc,
const char *comment_id);
int flickcurl_photos_comments_editComment
(flickcurl *fc,
const char *comment_id,
const char *comment_text);
flickcurl_comment** flickcurl_photos_comments_getList (flickcurl *fc,
const char *photo_id);
int flickcurl_photos_delete (flickcurl *fc,
const char *photo_id);
flickcurl_location* flickcurl_photos_geo_getLocation (flickcurl *fc,
const char *photo_id);
flickcurl_perms* flickcurl_photos_geo_getPerms (flickcurl *fc,
const char *photo_id);
int flickcurl_photos_geo_removeLocation (flickcurl *fc,
const char *photo_id);
int flickcurl_photos_geo_setLocation (flickcurl *fc,
const char *photo_id,
flickcurl_location *location);
int flickcurl_photos_geo_setPerms (flickcurl *fc,
const char *photo_id,
flickcurl_perms *perms);
flickcurl_context** flickcurl_photos_getAllContexts (flickcurl *fc,
const char *photo_id);
flickcurl_photo** flickcurl_photos_getContactsPhotos (flickcurl *fc,
int contact_count,
int just_friends,
int single_photo,
int include_self,
const char *extras);
flickcurl_photos_list* flickcurl_photos_getContactsPhotos_params
(flickcurl *fc,
int contact_count,
int just_friends,
int single_photo,
int include_self,
flickcurl_photos_list_params *list_params);
flickcurl_photo** flickcurl_photos_getContactsPublicPhotos
(flickcurl *fc,
const char *user_id,
int photo_count,
int just_friends,
int single_photo,
int include_self,
const char *extras);
flickcurl_photos_list* flickcurl_photos_getContactsPublicPhotos_params
(flickcurl *fc,
const char *user_id,
int photo_count,
int just_friends,
int single_photo,
int include_self,
flickcurl_photos_list_params *list_params);
flickcurl_context** flickcurl_photos_getContext (flickcurl *fc,
const char *photo_id);
int** flickcurl_photos_getCounts (flickcurl *fc,
const char **dates_array,
const char **taken_dates_array);
flickcurl_exif** flickcurl_photos_getExif (flickcurl *fc,
const char *photo_id,
const char *secret);
flickcurl_person** flickcurl_photos_getFavorites (flickcurl *fc,
const char *photo_id,
int page,
int per_page);
flickcurl_photo* flickcurl_photos_getInfo (flickcurl *fc,
const char *photo_id);
flickcurl_photo** flickcurl_photos_getNotInSet (flickcurl *fc,
int min_upload_date,
int max_upload_date,
const char *min_taken_date,
const char *max_taken_date,
int privacy_filter,
const char *extras,
int per_page,
int page);
flickcurl_photos_list* flickcurl_photos_getNotInSet_params
(flickcurl *fc,
int min_upload_date,
int max_upload_date,
const char *min_taken_date,
const char *max_taken_date,
int privacy_filter,
flickcurl_photos_list_params *list_params);
flickcurl_perms* flickcurl_photos_getPerms (flickcurl *fc,
const char *photo_id);
flickcurl_photo** flickcurl_photos_getRecent (flickcurl *fc,
const char *extras,
int per_page,
int page);
flickcurl_photos_list* flickcurl_photos_getRecent_params
(flickcurl *fc,
flickcurl_photos_list_params *list_params);
flickcurl_size** flickcurl_photos_getSizes (flickcurl *fc,
const char *photo_id);
flickcurl_photo** flickcurl_photos_getUntagged (flickcurl *fc,
int min_upload_date,
int max_upload_date,
const char *min_taken_date,
const char *max_taken_date,
int privacy_filter,
const char *extras,
int per_page,
int page);
flickcurl_photos_list* flickcurl_photos_getUntagged_params
(flickcurl *fc,
int min_upload_date,
int max_upload_date,
const char *min_taken_date,
const char *max_taken_date,
int privacy_filter,
flickcurl_photos_list_params *list_params);
flickcurl_photo** flickcurl_photos_getWithGeoData (flickcurl *fc,
int min_upload_date,
int max_upload_date,
const char *min_taken_date,
const char *max_taken_date,
int privacy_filter,
const char *extras,
int per_page,
int page);
flickcurl_photos_list* flickcurl_photos_getWithGeoData_params
(flickcurl *fc,
int min_upload_date,
int max_upload_date,
const char *min_taken_date,
const char *max_taken_date,
int privacy_filter,
flickcurl_photos_list_params *list_params);
flickcurl_photo** flickcurl_photos_getWithoutGeoData (flickcurl *fc,
int min_upload_date,
int max_upload_date,
const char *min_taken_date,
const char *max_taken_date,
int privacy_filter,
const char *extras,
int per_page,
int page);
flickcurl_photos_list* flickcurl_photos_getWithoutGeoData_params
(flickcurl *fc,
int min_upload_date,
int max_upload_date,
const char *min_taken_date,
const char *max_taken_date,
int privacy_filter,
flickcurl_photos_list_params *list_params);
flickcurl_license** flickcurl_photos_licenses_getInfo (flickcurl *fc);
flickcurl_license* flickcurl_photos_licenses_getInfo_by_id
(flickcurl *fc,
int id);
int flickcurl_photos_licenses_setLicense
(flickcurl *fc,
const char *photo_id,
int license_id);
char* flickcurl_photos_notes_add (flickcurl *fc,
const char *photo_id,
int note_x,
int note_y,
int note_w,
int note_h,
const char *note_text);
int flickcurl_photos_notes_delete (flickcurl *fc,
const char *note_id);
int flickcurl_photos_notes_edit (flickcurl *fc,
const char *note_id,
int note_x,
int note_y,
int note_w,
int note_h,
const char *note_text);
flickcurl_photo** flickcurl_photos_recentlyUpdated (flickcurl *fc,
int min_date,
const char *extras,
int per_page,
int page);
flickcurl_photos_list* flickcurl_photos_recentlyUpdated_params
(flickcurl *fc,
int min_date,
flickcurl_photos_list_params *list_params);
int flickcurl_photos_removeTag (flickcurl *fc,
const char *tag_id);
flickcurl_upload_status* flickcurl_photos_replace (flickcurl *fc,
const char *photo_file,
const char *photo_id,
int async);
flickcurl_photo** flickcurl_photos_search (flickcurl *fc,
flickcurl_search_params *params);
flickcurl_photos_list* flickcurl_photos_search_params (flickcurl *fc,
flickcurl_search_params *params,
flickcurl_photos_list_params *list_params);
flickcurl_search_params;
int flickcurl_search_params_init (flickcurl_search_params *params);
int flickcurl_photos_setContentType (flickcurl *fc,
const char *photo_id,
int content_type);
int flickcurl_photos_setDates (flickcurl *fc,
const char *photo_id,
int date_posted,
int date_taken,
int date_taken_granularity);
int flickcurl_photos_setMeta (flickcurl *fc,
const char *photo_id,
const char *title,
const char *description);
int flickcurl_photos_setPerms (flickcurl *fc,
const char *photo_id,
flickcurl_perms *perms);
int flickcurl_photos_setSafetyLevel (flickcurl *fc,
const char *photo_id,
int safety_level,
int hidden);
int flickcurl_photos_setTags (flickcurl *fc,
const char *photo_id,
const char *tags);
int flickcurl_photos_transform_rotate (flickcurl *fc,
const char *photo_id,
int degrees);
flickcurl_ticket** flickcurl_photos_upload_checkTickets
(flickcurl *fc,
const char **tickets_ids);
flickcurl_upload_status* flickcurl_photos_upload_params (flickcurl *fc,
flickcurl_upload_params *params);
typedef struct {
char *id;
char *uri;
flickcurl_tag** tags;
int tags_count;
flickcurl_photo_field fields[PHOTO_FIELD_LAST + 1];
flickcurl_place* place;
flickcurl_video* video;
char *media_type;
} flickcurl_photo;
A photo or video.
char * |
photo/video ID |
char * |
photo/video page URI |
flickcurl_tag ** |
array of tags (may be NULL) |
int |
size of tags array |
flickcurl_photo_field |
metadata fields |
flickcurl_place * |
place |
flickcurl_video * |
video (may be NULL) |
char * |
"photo" or "video" |
void flickcurl_free_photo (flickcurl_photo *photo);
Destructor for photo object
|
photo object |
void flickcurl_free_photos (flickcurl_photo **photos);
Destructor for array of photo objects
|
photo object array |
const char* flickcurl_get_photo_field_label (flickcurl_photo_field_type field);
Get label for photo field.
|
field enum |
Returns : |
label string or NULL if none valid |
char* flickcurl_photo_as_source_uri (flickcurl_photo *photo, const char c);
Get a photo's image source URIs
c can be s,m,t,b for sizes, o for original, otherwise default
http://www.flickr.com/services/api/misc.urls.html
|
photo object |
|
size s, m, t or b |
Returns : |
source URI or NULL on failure |
typedef struct {
char* string;
flickcurl_photo_field_type integer;
flickcurl_field_value_type type;
} flickcurl_photo_field;
Field of a photo structure
char * |
string field value |
flickcurl_photo_field_type |
integer field value |
| field type |
typedef enum {
PHOTO_FIELD_none,
PHOTO_FIELD_dateuploaded,
PHOTO_FIELD_farm,
PHOTO_FIELD_isfavorite,
PHOTO_FIELD_license,
PHOTO_FIELD_originalformat,
PHOTO_FIELD_rotation,
PHOTO_FIELD_server,
PHOTO_FIELD_dates_lastupdate,
PHOTO_FIELD_dates_posted,
PHOTO_FIELD_dates_taken,
PHOTO_FIELD_dates_takengranularity,
PHOTO_FIELD_description,
PHOTO_FIELD_editability_canaddmeta,
PHOTO_FIELD_editability_cancomment,
PHOTO_FIELD_geoperms_iscontact,
PHOTO_FIELD_geoperms_isfamily,
PHOTO_FIELD_geoperms_isfriend,
PHOTO_FIELD_geoperms_ispublic,
PHOTO_FIELD_location_accuracy,
PHOTO_FIELD_location_latitude,
PHOTO_FIELD_location_longitude,
PHOTO_FIELD_owner_location,
PHOTO_FIELD_owner_nsid,
PHOTO_FIELD_owner_realname,
PHOTO_FIELD_owner_username,
PHOTO_FIELD_title,
PHOTO_FIELD_visibility_isfamily,
PHOTO_FIELD_visibility_isfriend,
PHOTO_FIELD_visibility_ispublic,
PHOTO_FIELD_secret,
PHOTO_FIELD_originalsecret,
PHOTO_FIELD_location_neighbourhood,
PHOTO_FIELD_location_neighborhood = PHOTO_FIELD_location_neighbourhood,
PHOTO_FIELD_location_locality,
PHOTO_FIELD_location_county,
PHOTO_FIELD_location_region,
PHOTO_FIELD_location_country,
PHOTO_FIELD_location_placeid,
PHOTO_FIELD_neighbourhood_placeid,
PHOTO_FIELD_neighborhood_placeid = PHOTO_FIELD_neighbourhood_placeid,
PHOTO_FIELD_locality_placeid,
PHOTO_FIELD_county_placeid,
PHOTO_FIELD_region_placeid,
PHOTO_FIELD_country_placeid,
PHOTO_FIELD_location_woeid,
PHOTO_FIELD_neighbourhood_woeid,
PHOTO_FIELD_neighborhood_woeid = PHOTO_FIELD_neighbourhood_woeid,
PHOTO_FIELD_locality_woeid,
PHOTO_FIELD_county_woeid,
PHOTO_FIELD_region_woeid,
PHOTO_FIELD_country_woeid,
PHOTO_FIELD_usage_candownload,
PHOTO_FIELD_usage_canblog,
PHOTO_FIELD_usage_canprint,
PHOTO_FIELD_FIRST = PHOTO_FIELD_dateuploaded,
PHOTO_FIELD_LAST = PHOTO_FIELD_usage_canprint
} flickcurl_photo_field_type;
Fields of a flickcurl_photo*
| internal | |
| date uploaded | |
| farm number | |
| is favorite boolean | |
| license | |
| original format | |
| rotation | |
| server | |
| last update date | |
| posted date | |
| taken date | |
| taken granularity | |
| description | |
| can add metadata boolean | |
| can comment boolean | |
| geo perms are for contacts | |
| geo perms are for family | |
| geo perms are for frind | |
| geo perms are for public | |
| location accuracy | |
| location latitude | |
| location longitude | |
| owner location | |
| owner NSID | |
| owner real name | |
| owner user name | |
| title | |
| visibility is for family | |
| visibility is for friend | |
| visibility is for public | |
| photo secret | |
| photo original secret | |
| location neighbourhood | |
| deprecated | |
| location locality | |
| location county | |
| location region | |
| location country | |
| location place ID | |
| neighborhood place ID | |
| dprecated | |
| locality place ID | |
| county place ID | |
| region place ID | |
| country place ID | |
| location WOE ID | |
| neighborhood WOE ID | |
| deprecated | |
| locality WOE ID | |
| county WOE ID | |
| region WOE ID | |
| country WOE ID | |
| can download | |
| can blog | |
| can print | |
| internal offset to first in enum list | |
| internal offset to last in enum list |
typedef enum {
VALUE_TYPE_NONE, /* empty field */
VALUE_TYPE_PHOTO_ID, /* internal */
VALUE_TYPE_PHOTO_URI, /* internal */
VALUE_TYPE_UNIXTIME,
VALUE_TYPE_BOOLEAN,
VALUE_TYPE_DATETIME,
VALUE_TYPE_FLOAT,
VALUE_TYPE_INTEGER,
VALUE_TYPE_STRING,
VALUE_TYPE_URI,
VALUE_TYPE_PERSON_ID, /* internal */
VALUE_TYPE_MEDIA_TYPE, /* internal */
VALUE_TYPE_LAST = VALUE_TYPE_MEDIA_TYPE
} flickcurl_field_value_type;
Field data types
| internal | |
| internal | |
| internal | |
| a unixtime | |
| boolean | |
| date time | |
| floating point number | |
| integer | |
| string | |
| URI | |
| person ID | |
| internal | |
| internal offset to last in enum list |
int flickcurl_photos_addTags (flickcurl *fc, const char *photo_id, const char *tags);
Add tags to a photo.
Implements flickr.photos.addTags (0.9)
|
flickcurl context |
|
photo ID |
|
tags to add as a space-separated list |
Returns : |
non-0 on failure |
char* flickcurl_photos_comments_addComment
(flickcurl *fc,
const char *photo_id,
const char *comment_text);
Add comment to a photo as the currently authenticated user.
Implements flickr.photos.comments.addComment (0.10)
|
flickcurl context |
|
The id of the photo to add a comment to. |
|
Text of the comment |
Returns : |
new comment ID or non-NULL on failure |
int flickcurl_photos_comments_deleteComment
(flickcurl *fc,
const char *comment_id);
Delete a comment as the currently authenticated user.
Implements flickr.photos.comments.deleteComment (0.10)
|
flickcurl context |
|
The id of the comment to edit. |
Returns : |
non-0 on failure |
int flickcurl_photos_comments_editComment
(flickcurl *fc,
const char *comment_id,
const char *comment_text);
Edit the text of a comment as the currently authenticated user.
Implements flickr.photos.comments.editComment (0.10)
|
flickcurl context |
|
The id of the comment to edit. |
|
Update the comment to this text. |
Returns : |
non-0 on failure |
flickcurl_comment** flickcurl_photos_comments_getList (flickcurl *fc, const char *photo_id);
Returns the comments for a photo
Implements flickr.photos.comments.getList (0.10)
|
flickcurl context |
|
The id of the photo to fetch comments for. |
Returns : |
array of comments or NULL on failure |
int flickcurl_photos_delete (flickcurl *fc, const char *photo_id);
Delete a photo.
Implements flickr.photos.delete (0.9)
|
flickcurl context |
|
photo ID |
Returns : |
non-0 on failure |
flickcurl_location* flickcurl_photos_geo_getLocation (flickcurl *fc, const char *photo_id);
Get the geo data (latitude and longitude and the accuracy level) for a photo.
Implements flickr.photos.geo.getLocation (0.12)
|
flickcurl context |
|
The id of the photo you want to retrieve location data for. |
Returns : |
non-0 on failure |
flickcurl_perms* flickcurl_photos_geo_getPerms (flickcurl *fc, const char *photo_id);
Get permissions for who may view geo data for a photo.
Implements flickr.photos.geo.getPerms (0.12)
|
flickcurl context |
|
The id of the photo to get permissions for. |
Returns : |
non-0 on failure |
int flickcurl_photos_geo_removeLocation (flickcurl *fc, const char *photo_id);
Removes the geo data associated with a photo.
Implements flickr.photos.geo.removeLocation (0.12)
|
flickcurl context |
|
The id of the photo you want to remove location data from. |
Returns : |
non-0 on failure |
int flickcurl_photos_geo_setLocation (flickcurl *fc, const char *photo_id, flickcurl_location *location);
Sets the geo data (latitude and longitude and, optionally, the accuracy level) for a photo.
Implements flickr.photos.geo.setLocation (0.12)
|
flickcurl context |
|
The id of the photo to set location data for. |
|
The location |
Returns : |
non-0 on failure |
int flickcurl_photos_geo_setPerms (flickcurl *fc, const char *photo_id, flickcurl_perms *perms);
Set the permission for who may view the geo data associated with a photo.
Implements flickr.photos.geo.setPerms (0.12)
|
flickcurl context |
|
The id of the photo to get permissions for. |
|
Geo permissions |
Returns : |
non-0 on failure |
flickcurl_context** flickcurl_photos_getAllContexts (flickcurl *fc, const char *photo_id);
Get all visible sets and pools the photo belongs to.
Implements flickr.photos.getAllContexts (0.7)
Returns an array of size 3 [prev, next, NULL] flickcurl_context* or NULL on error
|
flickcurl context |
|
photo ID |
Returns : |
prev, next contexts or NULL |
flickcurl_photo** flickcurl_photos_getContactsPhotos (flickcurl *fc, int contact_count, int just_friends, int single_photo, int include_self, const char *extras);
Fetch a list of recent photos from the calling users' contacts.
See flickcurl_photos_getContactsPhotos() for details of parameters.
Implements flickr.photos.getContactsPhotos (0.11)
|
flickcurl context |
|
Number of photos to return (Default 10, maximum 50) |
|
Set to non-0 to only show photos from friends and family (excluding regular contacts). |
|
Set to non-0 to only fetch one photo (the latest) per contact, instead of all photos in chronological order. |
|
Set to non-0 to include photos from the calling user. |
|
A comma-delimited list of extra information to fetch for each returned record (or NULL) |
Returns : |
non-0 on failure |
flickcurl_photos_list* flickcurl_photos_getContactsPhotos_params (flickcurl *fc, int contact_count, int just_friends, int single_photo, int include_self, flickcurl_photos_list_params *list_params);
Fetch a list of recent photos from the calling users' contacts.
Currently supported extras fields are: license, date_upload, date_taken, owner_name, icon_server, original_format, last_update
Optional extra type 'media' that will return an extra media=VALUE for VALUE "photo" or "video". API addition 2008-04-07.
|
flickcurl context |
|
Number of photos to return (Default 10, maximum 50) |
|
Set to non-0 to only show photos from friends and family (excluding regular contacts). |
|
Set to non-0 to only fetch one photo (the latest) per contact, instead of all photos in chronological order. |
|
Set to non-0 to include photos from the calling user. |
|
flickcurl_photos_list_params result parameters (or NULL) |
Returns : |
non-0 on failure |
flickcurl_photo** flickcurl_photos_getContactsPublicPhotos (flickcurl *fc, const char *user_id, int photo_count, int just_friends, int single_photo, int include_self, const char *extras);
Fetch a list of recent public photos from a users' contacts.
See flickcurl_photos_getContactsPublicPhotos() for details of
parameters.
Implements flickr.photos.getContactsPublicPhotos (0.12)
|
flickcurl context |
|
The NSID of the user to fetch photos for. |
|
Number of photos to return (Default 10, maximum 50) |
|
Set to non-0 to only show photos from friends and family (excluding regular contacts) |
|
Set to non-0 to only fetch one photo (the latest) per contact, instead of all photos in chronological order. |
|
Set to non-0 to include photos from the user specified by user_id. |
|
A comma-delimited list of extra information to fetch for each returned record (or NULL) |
Returns : |
a list of photos or NULL on failure |
flickcurl_photos_list* flickcurl_photos_getContactsPublicPhotos_params (flickcurl *fc, const char *user_id, int photo_count, int just_friends, int single_photo, int include_self, flickcurl_photos_list_params *list_params);
Fetch a list of recent public photos from a users' contacts.
Currently supported extras fields are: license, date_upload, date_taken, owner_name, icon_server, original_format, last_update.
Optional extra type 'media' that will return an extra media=VALUE for VALUE "photo" or "video". API addition 2008-04-07.
|
flickcurl context |
|
The NSID of the user to fetch photos for. |
|
Number of photos to return (Default 10, maximum 50) |
|
Set to non-0 to only show photos from friends and family (excluding regular contacts) |
|
Set to non-0 to only fetch one photo (the latest) per contact, instead of all photos in chronological order. |
|
Set to non-0 to include photos from the user specified by user_id. |
|
flickcurl_photos_list_params result parameters (or NULL) |
Returns : |
a list of photos or NULL on failure |
flickcurl_context** flickcurl_photos_getContext (flickcurl *fc, const char *photo_id);
Get next and previous photos for a photo in a photostream.
Implements flickr.photos.getContext (0.7)
Returns an array of size 3 [prev, next, NULL] flickcurl_context* or NULL on error
|
flickcurl context |
|
photo ID |
Returns : |
prev, next contexts or NULL |
int** flickcurl_photos_getCounts (flickcurl *fc, const char **dates_array, const char **taken_dates_array);
Gets a list of photo counts for the given date ranges for the calling user.
Implements flickr.photos.getCounts (0.13)
The return array fields are: [0] count [1] fromdate as unixtime [2] todate as unixtime
|
flickcurl context |
|
A comma delimited list of unix timestamps, denoting the periods to return counts for. They should be specified smallest first. (or NULL) |
|
A comma delimited list of mysql datetimes, denoting the periods to return counts for. They should be specified mallest first. (or NULL) |
Returns : |
array of int[3] or NULL on failure |
flickcurl_exif** flickcurl_photos_getExif (flickcurl *fc, const char *photo_id, const char *secret);
Retrieves a list of EXIF/TIFF/GPS tags for a given photo.
Implements flickr.photos.getExif (0.12)
|
flickcurl context |
|
The id of the photo to fetch information for. |
|
The secret for the photo (or NULL) If the correct secret is passed then permissions checking is skipped. This enables the 'sharing' of individual photos by passing around the id and secret. |
Returns : |
non-0 on failure |
flickcurl_person** flickcurl_photos_getFavorites (flickcurl *fc, const char *photo_id, int page, int per_page);
Returns the list of people who have favorited a given photo.
Implements flickr.photos.getFavorites (0.12)
|
flickcurl context |
|
The ID of the photo to fetch the favoriters list for. |
|
The page of results to return (default 1) |
|
Number of users to return per page (default 10, max 50) |
Returns : |
non-0 on failure |
flickcurl_photo* flickcurl_photos_getInfo (flickcurl *fc, const char *photo_id);
Get information about a photo
Implements flickr.photos.getInfo (0.5)
|
flickcurl context |
|
photo ID |
Returns : |
flickcurl_photo or NULL on failure |
flickcurl_photo** flickcurl_photos_getNotInSet (flickcurl *fc, int min_upload_date, int max_upload_date, const char *min_taken_date, const char *max_taken_date, int privacy_filter, const char *extras, int per_page, int page);
Returns a list of your photos that are not part of any sets.
See flickcurl_photos_getNotInSet_params() for details of parameters.
Implements flickr.photos.getNotInSet (0.12)
|
flickcurl context |
|
Minimum upload date. |
|
Maximum upload date. |
|
Minimum taken date (or NULL). |
|
Maximum taken date (or NULL). |
|
Return photos only matching a certain privacy level. Valid privacy values are: 1 public, 2 friends, 3 family, 4 friends and family, 5 private |
|
A comma-delimited list of extra information to fetch for each returned record (or NULL) |
|
Number of photos to return per page (default 100, max 500). |
|
The page of results to return (default 1). |
Returns : |
a list of photos or NULL on failure |
flickcurl_photos_list* flickcurl_photos_getNotInSet_params (flickcurl *fc, int min_upload_date, int max_upload_date, const char *min_taken_date, const char *max_taken_date, int privacy_filter, flickcurl_photos_list_params *list_params);
Returns a list of your photos that are not part of any sets.
Currently supported extras fields are: license, date_upload, date_taken, owner_name, icon_server, original_format, last_update, geo, tags, machine_tags.
|
flickcurl context |
|
Minimum upload date. |
|
Maximum upload date. |
|
Minimum taken date (or NULL). |
|
Maximum taken date (or NULL). |
|
Return photos only matching a certain privacy level. |
|
flickcurl_photos_list_params result parameters (or NULL) |
Returns : |
a list of photos or NULL on failure |
flickcurl_perms* flickcurl_photos_getPerms (flickcurl *fc, const char *photo_id);
Get permissions for a photo.
Implements flickr.photos.getPerms (0.11)
|
flickcurl context |
|
The id of the photo to get permissions for. |
Returns : |
permissions or NULL on failure |
flickcurl_photo** flickcurl_photos_getRecent (flickcurl *fc, const char *extras, int per_page, int page);
Returns a list of the latest public photos uploaded to flickr.
See flickcurl_photos_getRecent_params() for details of parameters.
Implements flickr.photos.getRecent (0.12)
|
flickcurl context |
|
A comma-delimited list of extra information to fetch for each returned record (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_photos_getRecent_params (flickcurl *fc, flickcurl_photos_list_params *list_params);
Returns a list of the latest public photos uploaded to flickr.
Currently supported extras fields are: license, date_upload, date_taken, owner_name, icon_server, original_format, last_update, geo, tags, machine_tags.
Optional extra type 'media' that will return an extra media=VALUE for VALUE "photo" or "video". API addition 2008-04-07.
|
flickcurl context |
|
flickcurl_photos_list_params result parameters (or NULL) |
Returns : |
non-0 on failure |
flickcurl_size** flickcurl_photos_getSizes (flickcurl *fc, const char *photo_id);
Returns the available sizes for a photo. The calling user must have permission to view the photo.
Implements flickr.photos.getSizes (0.13)
|
flickcurl context |
|
The id of the photo to fetch size information for. |
Returns : |
non-0 on failure |
flickcurl_photo** flickcurl_photos_getUntagged (flickcurl *fc, int min_upload_date, int max_upload_date, const char *min_taken_date, const char *max_taken_date, int privacy_filter, const char *extras, int per_page, int page);
Returns a list of your photos with no tags.
See flickcurl_photos_getUntagged_params() for details of parameters.
Implements flickr.photos.getUntagged (0.12)
|
flickcurl context |
|
Minimum upload date. |
|
Maximum upload date. |
|
Minimum taken date (or NULL) |
|
Maximum taken date (or NULL) |
|
Return photos only matching a certain privacy level. Valid privacy values are: 1 public, 2 friends, 3 family, 4 friends and family, 5 private |
|
A comma-delimited list of extra information to fetch for each returned record (or NULL) |
|
Number of photos to return per page (default 100, max 500). |
|
The page of results to return (default 1). |
Returns : |
a list of photos or NULL on failure |
flickcurl_photos_list* flickcurl_photos_getUntagged_params (flickcurl *fc, int min_upload_date, int max_upload_date, const char *min_taken_date, const char *max_taken_date, int privacy_filter, flickcurl_photos_list_params *list_params);
Returns a list of your photos with no tags.
Currently supported extras fields are: license, date_upload, date_taken, owner_name, icon_server, original_format, last_update, geo, tags, machine_tags.
|
flickcurl context |
|
Minimum upload date. |
|
Maximum upload date. |
|
Minimum taken date (or NULL) |
|
Maximum taken date (or NULL) |
|
Return photos only matching a certain privacy level. Valid privacy values are: 1 public, 2 friends, 3 family, 4 friends and family, 5 private |
|
flickcurl_photos_list_params result parameters (or NULL) |
Returns : |
a list of photos or NULL on failure |
flickcurl_photo** flickcurl_photos_getWithGeoData (flickcurl *fc, int min_upload_date, int max_upload_date, const char *min_taken_date, const char *max_taken_date, int privacy_filter, const char *extras, int per_page, int page);
Returns a list of your geo-tagged photos.
See flickcurl_photos_getWithGeoData_params() for details of parameters.
Implements flickr.photos.getWithGeoData (0.12)
|
flickcurl context |
|
Minimum upload date. Photos with an upload date greater than or equal to this value will be returned. The date should be in the form of a unix timestamp. (or NULL) |
|
Maximum upload date. Photos with an upload date less than or equal to this value will be returned. The date should be in the form of a unix timestamp. (or NULL) |
|
Minimum taken date. Photos with an taken date greater than or equal to this value will be returned. The date should be in the form of a mysql datetime. (or NULL) |
|
Maximum taken date. Photos with an taken date less than or equal to this value will be returned. The date should be in the form of a mysql datetime. (or NULL) |
|
Return photos only matching a certain privacy level. Valid values are: 1 public photos; 2 private photos visible to friends; 3 private photos visible to family; 4 private photos visible to friends and family; 5 completely private photos. (or NULL) |
|
A comma-delimited list of extra information to fetch for each returned record. |
|
Number of photos to return per page. |
|
The page of results to return. |
Returns : |
non-0 on failure |
flickcurl_photos_list* flickcurl_photos_getWithGeoData_params (flickcurl *fc, int min_upload_date, int max_upload_date, const char *min_taken_date, const char *max_taken_date, int privacy_filter, flickcurl_photos_list_params *list_params);
Returns a list of your geo-tagged photos.
|
flickcurl context |
|
Minimum upload date. Photos with an upload date greater than or equal to this value will be returned. The date should be in the form of a unix timestamp. (or NULL) |
|
Maximum upload date. Photos with an upload date less than or equal to this value will be returned. The date should be in the form of a unix timestamp. (or NULL) |
|
Minimum taken date. Photos with an taken date greater than or equal to this value will be returned. The date should be in the form of a mysql datetime. (or NULL) |
|
Maximum taken date. Photos with an taken date less than or equal to this value will be returned. The date should be in the form of a mysql datetime. (or NULL) |
|
Return photos only matching a certain privacy level. Valid values are: 1 public photos; 2 private photos visible to friends; 3 private photos visible to family; 4 private photos visible to friends and family; 5 completely private photos. (or NULL) |
|
flickcurl_photos_list_params result parameters (or NULL) |
Returns : |
non-0 on failure |
flickcurl_photo** flickcurl_photos_getWithoutGeoData (flickcurl *fc, int min_upload_date, int max_upload_date, const char *min_taken_date, const char *max_taken_date, int privacy_filter, const char *extras, int per_page, int page);
Returns a list of your photos which haven't been geo-tagged.
See flickcurl_photos_getWithoutGeoData_params() for details of parameters.
Implements flickr.photos.getWithoutGeoData (0.12)
|
flickcurl context |
|
Minimum upload date. Photos with an upload date greater than or equal to this value will be returned. The date should be in the form of a unix timestamp. (or NULL) |
|
Maximum upload date. Photos with an upload date less than or equal to this value will be returned. The date should be in the form of a unix timestamp. (or NULL) |
|
Minimum taken date. Photos with an taken date greater than or equal to this value will be returned. The date should be in the form of a mysql datetime. (or NULL) |
|
Maximum taken date. Photos with an taken date less than or equal to this value will be returned. The date should be in the form of a mysql datetime. (or NULL) |
|
Return photos only matching a certain privacy level. Valid values are: 1 public photos; 2 private photos visible to friends; 3 private photos visible to family; 4 private photos visible to friends and family; 5 completely private photos. (or NULL) |
|
A comma-delimited list of extra information to fetch for each returned record. |
|
Number of photos to return per page. |
|
The page of results to return. |
Returns : |
non-0 on failure |
flickcurl_photos_list* flickcurl_photos_getWithoutGeoData_params (flickcurl *fc, int min_upload_date, int max_upload_date, const char *min_taken_date, const char *max_taken_date, int privacy_filter, flickcurl_photos_list_params *list_params);
Returns a list of your photos which haven't been geo-tagged.
|
flickcurl context |
|
Minimum upload date. Photos with an upload date greater than or equal to this value will be returned. The date should be in the form of a unix timestamp. (or NULL) |
|
Maximum upload date. Photos with an upload date less than or equal to this value will be returned. The date should be in the form of a unix timestamp. (or NULL) |
|
Minimum taken date. Photos with an taken date greater than or equal to this value will be returned. The date should be in the form of a mysql datetime. (or NULL) |
|
Maximum taken date. Photos with an taken date less than or equal to this value will be returned. The date should be in the form of a mysql datetime. (or NULL) |
|
Return photos only matching a certain privacy level. Valid values are: 1 public photos; 2 private photos visible to friends; 3 private photos visible to family; 4 private photos visible to friends and family; 5 completely private photos. (or NULL) |
|
flickcurl_photos_list_params result parameters (or NULL) |
Returns : |
non-0 on failure |
flickcurl_license** flickcurl_photos_licenses_getInfo (flickcurl *fc);
Get a list of available photo licenses for Flickr.
Implements flickr.photos.licenses.getInfo (0.6)
|
flickcurl context |
Returns : |
an array of flickcurl_license or NULL on failure |
flickcurl_license* flickcurl_photos_licenses_getInfo_by_id (flickcurl *fc, int id);
Get an individual photo license by ID
Not part of the Flickr API.
|
flickcurl context |
|
license ID |
Returns : |
a flickcurl_license or NULL on failure |
int flickcurl_photos_licenses_setLicense
(flickcurl *fc,
const char *photo_id,
int license_id);
Sets the license for a photo.
Implements flickr.photos.licenses.setLicense (0.12)
|
flickcurl context |
|
The photo to update the license for. |
|
The license to apply, or 0 (zero) to remove the current license. |
Returns : |
non-0 on failure |
char* flickcurl_photos_notes_add (flickcurl *fc, const char *photo_id, int note_x, int note_y, int note_w, int note_h, const char *note_text);