class FlickRaw::Flickr::Photos
Public Instance Methods
flickr.photos.addTags request.
Add tags to a photo.
Arguments
- photo_id (required)
-
The id of the photo to add tags to.
- tags (required)
-
The tags to add to the photo.
Error codes
-
1: Photo not found
The photo id passed was not the id of a photo that the calling user can add tags to. It could be an invalid id, or the user may not have permission to add tags to it.
-
2: Maximum number of tags reached
The maximum number of tags for the photo has been reached - no more tags can be added. If the current count is less than the maximum, but adding all of the tags for this request would go over the limit, the whole request is ignored. I.E. when you get this message, none of the requested tags have been added.
-
96: Invalid signature
The passed signature was invalid.
-
97: Missing signature
The call required signing but no signature was sent.
-
98: Login failed / Invalid auth token
The login details or auth token passed were invalid.
-
99: User not logged in / Insufficient permissions
The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions.
-
100: Invalid API Key
The API key passed was not valid or has expired.
-
105: Service currently unavailable
The requested service is temporarily unavailable.
-
106: Write operation failed
The requested operation failed due to a temporary issue.
-
111: Format “xxx” not found
The requested response format was not found.
-
112: Method “xxx” not found
The requested method was not found.
-
114: Invalid SOAP envelope
The SOAP envelope send in the request could not be parsed.
-
115: Invalid XML-RPC Method Call
The XML-RPC request document could not be parsed.
-
116: Bad URL found
One or more arguments contained a URL that has been used for abuse on Flickr.
# Generated automatically from flickr api
def addTags(*args)
@flickr.call 'flickr.photos.addTags', *args
end
Returns a Comments object.
flickr.photos.delete request.
Delete a photo from flickr.
Arguments
- photo_id (required)
-
The id of the photo to delete.
Error codes
-
1: Photo not found
The photo id was not the id of a photo belonging to the calling user.
-
96: Invalid signature
The passed signature was invalid.
-
97: Missing signature
The call required signing but no signature was sent.
-
98: Login failed / Invalid auth token
The login details or auth token passed were invalid.
-
99: User not logged in / Insufficient permissions
The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions.
-
100: Invalid API Key
The API key passed was not valid or has expired.
-
105: Service currently unavailable
The requested service is temporarily unavailable.
-
106: Write operation failed
The requested operation failed due to a temporary issue.
-
111: Format “xxx” not found
The requested response format was not found.
-
112: Method “xxx” not found
The requested method was not found.
-
114: Invalid SOAP envelope
The SOAP envelope send in the request could not be parsed.
-
115: Invalid XML-RPC Method Call
The XML-RPC request document could not be parsed.
-
116: Bad URL found
One or more arguments contained a URL that has been used for abuse on Flickr.
# Generated automatically from flickr api
def delete(*args)
@flickr.call 'flickr.photos.delete', *args
end
Returns a Geo object.
flickr.photos.getAllContexts request.
Returns all visible sets and pools the photo belongs to.
Arguments
- photo_id (required)
-
The photo to return information for.
Error codes
-
1: Photo not found
The photo id passed was not the id of a valid photo.
-
100: Invalid API Key
The API key passed was not valid or has expired.
-
105: Service currently unavailable
The requested service is temporarily unavailable.
-
106: Write operation failed
The requested operation failed due to a temporary issue.
-
111: Format “xxx” not found
The requested response format was not found.
-
112: Method “xxx” not found
The requested method was not found.
-
114: Invalid SOAP envelope
The SOAP envelope send in the request could not be parsed.
-
115: Invalid XML-RPC Method Call
The XML-RPC request document could not be parsed.
-
116: Bad URL found
One or more arguments contained a URL that has been used for abuse on Flickr.
Returns
# Generated automatically from flickr api
def getAllContexts(*args)
@flickr.call 'flickr.photos.getAllContexts', *args
end
flickr.photos.getContactsPhotos request.
Fetch a list of recent photos from the calling users' contacts.
Arguments
- count
-
Number of photos to return. Defaults to 10, maximum 50. This is only used if single_photo is not passed.
- just_friends
-
set as 1 to only show photos from friends and family (excluding regular contacts).
- single_photo
-
Only fetch one photo (the latest) per contact, instead of all photos in chronological order.
- include_self
-
Set to 1 to include photos from the calling user.
- extras
-
A comma-delimited list of extra information to fetch for each returned record. Currently supported fields include: license, date_upload, date_taken, owner_name, icon_server, original_format, last_update. For more information see extras under flickr.photos.search.
Error codes
-
96: Invalid signature
The passed signature was invalid.
-
97: Missing signature
The call required signing but no signature was sent.
-
98: Login failed / Invalid auth token
The login details or auth token passed were invalid.
-
99: User not logged in / Insufficient permissions
The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions.
-
100: Invalid API Key
The API key passed was not valid or has expired.
-
105: Service currently unavailable
The requested service is temporarily unavailable.
-
106: Write operation failed
The requested operation failed due to a temporary issue.
-
111: Format “xxx” not found
The requested response format was not found.
-
112: Method “xxx” not found
The requested method was not found.
-
114: Invalid SOAP envelope
The SOAP envelope send in the request could not be parsed.
-
115: Invalid XML-RPC Method Call
The XML-RPC request document could not be parsed.
-
116: Bad URL found
One or more arguments contained a URL that has been used for abuse on Flickr.
Returns
# Generated automatically from flickr api
def getContactsPhotos(*args)
@flickr.call 'flickr.photos.getContactsPhotos', *args
end
flickr.photos.getContactsPublicPhotos request.
Fetch a list of recent public photos from a users' contacts.
Arguments
- user_id (required)
-
The NSID of the user to fetch photos for.
- count
-
Number of photos to return. Defaults to 10, maximum 50. This is only used if single_photo is not passed.
- just_friends
-
set as 1 to only show photos from friends and family (excluding regular contacts).
- single_photo
-
Only fetch one photo (the latest) per contact, instead of all photos in chronological order.
- include_self
-
Set to 1 to include photos from the user specified by user_id.
- extras
-
A comma-delimited list of extra information to fetch for each returned record. Currently supported fields are: license, date_upload, date_taken, owner_name, icon_server, original_format, last_update.
Error codes
-
1: User not found
The user NSID passed was not a valid user NSID.
-
100: Invalid API Key
The API key passed was not valid or has expired.
-
105: Service currently unavailable
The requested service is temporarily unavailable.
-
106: Write operation failed
The requested operation failed due to a temporary issue.
-
111: Format “xxx” not found
The requested response format was not found.
-
112: Method “xxx” not found
The requested method was not found.
-
114: Invalid SOAP envelope
The SOAP envelope send in the request could not be parsed.
-
115: Invalid XML-RPC Method Call
The XML-RPC request document could not be parsed.
-
116: Bad URL found
One or more arguments contained a URL that has been used for abuse on Flickr.
Returns
# Generated automatically from flickr api
def getContactsPublicPhotos(*args)
@flickr.call 'flickr.photos.getContactsPublicPhotos', *args
end
flickr.photos.getContext request.
Returns next and previous photos for a photo in a photostream.
Arguments
- photo_id (required)
-
The id of the photo to fetch the context for.
- num_prev
- num_next
- extras
- num_next
-
A comma-delimited list of extra information to fetch for each returned record. Currently supported fields are: description, license, date_upload, date_taken, owner_name, icon_server, original_format, last_update, geo, tags, machine_tags, o_dims, views, media, path_alias, url_sq, url_t, url_s, url_m, url_z, url_l, url_o
- order_by
-
Accepts datetaken or dateposted and returns results in the proper order.
- view_as
-
Can take values public to indicate that the profile has to be viewed as public and returns context only in public setting
Error codes
-
1: Photo not found
The photo id passed was not a valid photo id, or was the id of a photo that the calling user does not have permission to view.
-
100: Invalid API Key
The API key passed was not valid or has expired.
-
105: Service currently unavailable
The requested service is temporarily unavailable.
-
106: Write operation failed
The requested operation failed due to a temporary issue.
-
111: Format “xxx” not found
The requested response format was not found.
-
112: Method “xxx” not found
The requested method was not found.
-
114: Invalid SOAP envelope
The SOAP envelope send in the request could not be parsed.
-
115: Invalid XML-RPC Method Call
The XML-RPC request document could not be parsed.
-
116: Bad URL found
One or more arguments contained a URL that has been used for abuse on Flickr.
Returns
# Generated automatically from flickr api
def getContext(*args)
@flickr.call 'flickr.photos.getContext', *args
end
flickr.photos.getCounts request.
Gets a list of photo counts for the given date ranges for the calling user.
Arguments
- dates
-
A comma delimited list of unix timestamps, denoting the periods to return counts for. They should be specified smallest first.
- taken_dates
-
A comma delimited list of mysql datetimes, denoting the periods to return counts for. They should be specified smallest first.
Error codes
-
1: No dates specified
Neither dates nor taken_dates were specified.
-
96: Invalid signature
The passed signature was invalid.
-
97: Missing signature
The call required signing but no signature was sent.
-
98: Login failed / Invalid auth token
The login details or auth token passed were invalid.
-
99: User not logged in / Insufficient permissions
The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions.
-
100: Invalid API Key
The API key passed was not valid or has expired.
-
105: Service currently unavailable
The requested service is temporarily unavailable.
-
106: Write operation failed
The requested operation failed due to a temporary issue.
-
111: Format “xxx” not found
The requested response format was not found.
-
112: Method “xxx” not found
The requested method was not found.
-
114: Invalid SOAP envelope
The SOAP envelope send in the request could not be parsed.
-
115: Invalid XML-RPC Method Call
The XML-RPC request document could not be parsed.
-
116: Bad URL found
One or more arguments contained a URL that has been used for abuse on Flickr.
Returns
# Generated automatically from flickr api
def getCounts(*args)
@flickr.call 'flickr.photos.getCounts', *args
end
flickr.photos.getExif request.
Retrieves a list of EXIF/TIFF/GPS tags for a given photo. The calling user must have permission to view the photo.
Arguments
- photo_id (required)
-
The id of the photo to fetch information for.
- secret
-
The secret for the photo. 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.
- extras
-
Error codes
-
1: Photo not found
The photo id was either invalid or was for a photo not viewable by the calling user.
-
2: Permission denied
The owner of the photo does not want to share EXIF data.
-
100: Invalid API Key
The API key passed was not valid or has expired.
-
105: Service currently unavailable
The requested service is temporarily unavailable.
-
106: Write operation failed
The requested operation failed due to a temporary issue.
-
111: Format “xxx” not found
The requested response format was not found.
-
112: Method “xxx” not found
The requested method was not found.
-
114: Invalid SOAP envelope
The SOAP envelope send in the request could not be parsed.
-
115: Invalid XML-RPC Method Call
The XML-RPC request document could not be parsed.
-
116: Bad URL found
One or more arguments contained a URL that has been used for abuse on Flickr.
Returns
Canon90/10f/964/1, 42/1, 4414/10064° 42' 44.14"
-
# Generated automatically from flickr api
def getExif(*args)
@flickr.call 'flickr.photos.getExif', *args
end
flickr.photos.getFavorites request.
Returns the list of people who have favorited a given photo.
Arguments
- photo_id (required)
-
The ID of the photo to fetch the favoriters list for.
- page
-
The page of results to return. If this argument is omitted, it defaults to 1.
- per_page
-
Number of usres to return per page. If this argument is omitted, it defaults to 10. The maximum allowed value is 50.
Error codes
-
1: Photo not found
The specified photo does not exist, or the calling user does not have permission to view it.
-
100: Invalid API Key
The API key passed was not valid or has expired.
-
105: Service currently unavailable
The requested service is temporarily unavailable.
-
106: Write operation failed
The requested operation failed due to a temporary issue.
-
111: Format “xxx” not found
The requested response format was not found.
-
112: Method “xxx” not found
The requested method was not found.
-
114: Invalid SOAP envelope
The SOAP envelope send in the request could not be parsed.
-
115: Invalid XML-RPC Method Call
The XML-RPC request document could not be parsed.
-
116: Bad URL found
One or more arguments contained a URL that has been used for abuse on Flickr.
Returns
# Generated automatically from flickr api
def getFavorites(*args)
@flickr.call 'flickr.photos.getFavorites', *args
end
flickr.photos.getInfo request.
Get information about a photo. The calling user must have permission to view the photo.
Arguments
- photo_id (required)
-
The id of the photo to get information for.
- secret
-
The secret for the photo. 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.
- humandates
- privacy_filter
- get_contexts
- get_geofences
- privacy_filter
-
Return geofence information in the photo's location property
- datecreate
-
If set to 1, it returns the timestamp of the user's account creation, in MySQL DATETIME format.
- extras
-
Error codes
-
1: Photo not found.
The photo id was either invalid or was for a photo not viewable by the calling user.
-
100: Invalid API Key
The API key passed was not valid or has expired.
-
105: Service currently unavailable
The requested service is temporarily unavailable.
-
106: Write operation failed
The requested operation failed due to a temporary issue.
-
111: Format “xxx” not found
The requested response format was not found.
-
112: Method “xxx” not found
The requested method was not found.
-
114: Invalid SOAP envelope
The SOAP envelope send in the request could not be parsed.
-
115: Invalid XML-RPC Method Call
The XML-RPC request document could not be parsed.
-
116: Bad URL found
One or more arguments contained a URL that has been used for abuse on Flickr.
Returns
orford_castle_tasterhello!1foowooyayhooplahttp://www.flickr.com/photos/bees/2733/
-
# Generated automatically from flickr api
def getInfo(*args)
@flickr.call 'flickr.photos.getInfo', *args
end
flickr.photos.getNotInSet request.
Returns a list of your photos that are not part of any sets.
Arguments
- max_upload_date
-
Maximum upload date. Photos with an upload date less than or equal to this value will be returned. The date can be in the form of a unix timestamp or mysql datetime.
- min_taken_date
-
Minimum taken date. Photos with an taken date greater than or equal to this value will be returned. The date can be in the form of a mysql datetime or unix timestamp.
- max_taken_date
-
Maximum taken date. Photos with an taken date less than or equal to this value will be returned. The date can be in the form of a mysql datetime or unix timestamp.
- privacy_filter
-
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 & family 5 completely private photos
- media
-
Filter results by media type. Possible values are all (default), photos or videos
- min_upload_date
-
Minimum upload date. Photos with an upload date greater than or equal to this value will be returned. The date can be in the form of a unix timestamp or mysql datetime.
- extras
-
A comma-delimited list of extra information to fetch for each returned record. Currently supported fields are: description, license, date_upload, date_taken, owner_name, icon_server, original_format, last_update, geo, tags, machine_tags, o_dims, views, media, path_alias, url_sq, url_t, url_s, url_q, url_m, url_n, url_z, url_c, url_l, url_o
- per_page
-
Number of photos to return per page. If this argument is omitted, it defaults to 100. The maximum allowed value is 500.
- page
-
The page of results to return. If this argument is omitted, it defaults to 1.
Error codes
-
96: Invalid signature
The passed signature was invalid.
-
97: Missing signature
The call required signing but no signature was sent.
-
98: Login failed / Invalid auth token
The login details or auth token passed were invalid.
-
99: User not logged in / Insufficient permissions
The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions.
-
100: Invalid API Key
The API key passed was not valid or has expired.
-
105: Service currently unavailable
The requested service is temporarily unavailable.
-
106: Write operation failed
The requested operation failed due to a temporary issue.
-
111: Format “xxx” not found
The requested response format was not found.
-
112: Method “xxx” not found
The requested method was not found.
-
114: Invalid SOAP envelope
The SOAP envelope send in the request could not be parsed.
-
115: Invalid XML-RPC Method Call
The XML-RPC request document could not be parsed.
-
116: Bad URL found
One or more arguments contained a URL that has been used for abuse on Flickr.
# Generated automatically from flickr api
def getNotInSet(*args)
@flickr.call 'flickr.photos.getNotInSet', *args
end
flickr.photos.getPerms request.
Get permissions for a photo.
Arguments
- photo_id (required)
-
The id of the photo to get permissions for.
Error codes
-
1: Photo not found
The photo id passed was not a valid photo id of a photo belonging to the calling user.
-
96: Invalid signature
The passed signature was invalid.
-
97: Missing signature
The call required signing but no signature was sent.
-
98: Login failed / Invalid auth token
The login details or auth token passed were invalid.
-
99: User not logged in / Insufficient permissions
The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions.
-
100: Invalid API Key
The API key passed was not valid or has expired.
-
105: Service currently unavailable
The requested service is temporarily unavailable.
-
106: Write operation failed
The requested operation failed due to a temporary issue.
-
111: Format “xxx” not found
The requested response format was not found.
-
112: Method “xxx” not found
The requested method was not found.
-
114: Invalid SOAP envelope
The SOAP envelope send in the request could not be parsed.
-
115: Invalid XML-RPC Method Call
The XML-RPC request document could not be parsed.
-
116: Bad URL found
One or more arguments contained a URL that has been used for abuse on Flickr.
Returns
# Generated automatically from flickr api
def getPerms(*args)
@flickr.call 'flickr.photos.getPerms', *args
end
flickr.photos.getRecent request.
Returns a list of the latest public photos uploaded to flickr.
Arguments
- jump_to
- extras
-
A comma-delimited list of extra information to fetch for each returned record. Currently supported fields are: description, license, date_upload, date_taken, owner_name, icon_server, original_format, last_update, geo, tags, machine_tags, o_dims, views, media, path_alias, url_sq, url_t, url_s, url_q, url_m, url_n, url_z, url_c, url_l, url_o
- per_page
-
Number of photos to return per page. If this argument is omitted, it defaults to 100. The maximum allowed value is 500.
- page
-
The page of results to return. If this argument is omitted, it defaults to 1.
Error codes
-
1: bad value for jump_to, must be valid photo id.
-
100: Invalid API Key
The API key passed was not valid or has expired.
-
105: Service currently unavailable
The requested service is temporarily unavailable.
-
106: Write operation failed
The requested operation failed due to a temporary issue.
-
111: Format “xxx” not found
The requested response format was not found.
-
112: Method “xxx” not found
The requested method was not found.
-
114: Invalid SOAP envelope
The SOAP envelope send in the request could not be parsed.
-
115: Invalid XML-RPC Method Call
The XML-RPC request document could not be parsed.
-
116: Bad URL found
One or more arguments contained a URL that has been used for abuse on Flickr.
# Generated automatically from flickr api
def getRecent(*args)
@flickr.call 'flickr.photos.getRecent', *args
end
flickr.photos.getSizes request.
Returns the available sizes for a photo. The calling user must have permission to view the photo.
Arguments
- photo_id (required)
-
The id of the photo to fetch size information for.
Error codes
-
1: Photo not found
The photo id passed was not a valid photo id.
-
2: Permission denied
The calling user does not have permission to view the photo.
-
100: Invalid API Key
The API key passed was not valid or has expired.
-
105: Service currently unavailable
The requested service is temporarily unavailable.
-
106: Write operation failed
The requested operation failed due to a temporary issue.
-
111: Format “xxx” not found
The requested response format was not found.
-
112: Method “xxx” not found
The requested method was not found.
-
114: Invalid SOAP envelope
The SOAP envelope send in the request could not be parsed.
-
115: Invalid XML-RPC Method Call
The XML-RPC request document could not be parsed.
-
116: Bad URL found
One or more arguments contained a URL that has been used for abuse on Flickr.
Returns
# Generated automatically from flickr api
def getSizes(*args)
@flickr.call 'flickr.photos.getSizes', *args
end
flickr.photos.getUntagged request.
Returns a list of your photos with no tags.
Arguments
- min_upload_date
-
Minimum upload date. Photos with an upload date greater than or equal to this value will be returned. The date can be in the form of a unix timestamp or mysql datetime.
- max_upload_date
-
Maximum upload date. Photos with an upload date less than or equal to this value will be returned. The date can be in the form of a unix timestamp or mysql datetime.
- min_taken_date
-
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 unix timestamp.
- max_taken_date
-
Maximum taken date. Photos with an taken date less than or equal to this value will be returned. The date can be in the form of a mysql datetime or unix timestamp.
- privacy_filter
-
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 & family 5 completely private photos
- media
-
Filter results by media type. Possible values are all (default), photos or videos
- extras
-
A comma-delimited list of extra information to fetch for each returned record. Currently supported fields are: description, license, date_upload, date_taken, owner_name, icon_server, original_format, last_update, geo, tags, machine_tags, o_dims, views, media, path_alias, url_sq, url_t, url_s, url_q, url_m, url_n, url_z, url_c, url_l, url_o
- per_page
-
Number of photos to return per page. If this argument is omitted, it defaults to 100. The maximum allowed value is 500.
- page
-
The page of results to return. If this argument is omitted, it defaults to 1.
Error codes
-
96: Invalid signature
The passed signature was invalid.
-
97: Missing signature
The call required signing but no signature was sent.
-
98: Login failed / Invalid auth token
The login details or auth token passed were invalid.
-
99: User not logged in / Insufficient permissions
The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions.
-
100: Invalid API Key
The API key passed was not valid or has expired.
-
105: Service currently unavailable
The requested service is temporarily unavailable.
-
106: Write operation failed
The requested operation failed due to a temporary issue.
-
111: Format “xxx” not found
The requested response format was not found.
-
112: Method “xxx” not found
The requested method was not found.
-
114: Invalid SOAP envelope
The SOAP envelope send in the request could not be parsed.
-
115: Invalid XML-RPC Method Call
The XML-RPC request document could not be parsed.
-
116: Bad URL found
One or more arguments contained a URL that has been used for abuse on Flickr.
# Generated automatically from flickr api
def getUntagged(*args)
@flickr.call 'flickr.photos.getUntagged', *args
end
flickr.photos.getWithGeoData request.
Returns a list of your geo-tagged photos.
Arguments
- min_upload_date
-
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.
- max_upload_date
-
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.
- min_taken_date
-
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.
- max_taken_date
-
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.
- privacy_filter
-
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 & family 5 completely private photos
- sort
-
The order in which to sort returned photos. Deafults to date-posted-desc. The possible values are: date-posted-asc, date-posted-desc, date-taken-asc, date-taken-desc, interestingness-desc, and interestingness-asc.
- media
-
Filter results by media type. Possible values are all (default), photos or videos
- extras
-
A comma-delimited list of extra information to fetch for each returned record. Currently supported fields are: description, license, date_upload, date_taken, owner_name, icon_server, original_format, last_update, geo, tags, machine_tags, o_dims, views, media, path_alias, url_sq, url_t, url_s, url_q, url_m, url_n, url_z, url_c, url_l, url_o
- per_page
-
Number of photos to return per page. If this argument is omitted, it defaults to 100. The maximum allowed value is 500.
- page
-
The page of results to return. If this argument is omitted, it defaults to 1.
Error codes
-
96: Invalid signature
The passed signature was invalid.
-
97: Missing signature
The call required signing but no signature was sent.
-
98: Login failed / Invalid auth token
The login details or auth token passed were invalid.
-
99: User not logged in / Insufficient permissions
The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions.
-
100: Invalid API Key
The API key passed was not valid or has expired.
-
105: Service currently unavailable
The requested service is temporarily unavailable.
-
106: Write operation failed
The requested operation failed due to a temporary issue.
-
111: Format “xxx” not found
The requested response format was not found.
-
112: Method “xxx” not found
The requested method was not found.
-
114: Invalid SOAP envelope
The SOAP envelope send in the request could not be parsed.
-
115: Invalid XML-RPC Method Call
The XML-RPC request document could not be parsed.
-
116: Bad URL found
One or more arguments contained a URL that has been used for abuse on Flickr.
# Generated automatically from flickr api
def getWithGeoData(*args)
@flickr.call 'flickr.photos.getWithGeoData', *args
end
flickr.photos.getWithoutGeoData request.
Returns a list of your photos which haven't been geo-tagged.
Arguments
- max_upload_date
-
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.
- min_taken_date
-
Minimum taken date. Photos with an taken date greater than or equal to this value will be returned. The date can be in the form of a mysql datetime or unix timestamp.
- max_taken_date
-
Maximum taken date. Photos with an taken date less than or equal to this value will be returned. The date can be in the form of a mysql datetime or unix timestamp.
- privacy_filter
-
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 & family 5 completely private photos
- sort
-
The order in which to sort returned photos. Deafults to date-posted-desc. The possible values are: date-posted-asc, date-posted-desc, date-taken-asc, date-taken-desc, interestingness-desc, and interestingness-asc.
- media
-
Filter results by media type. Possible values are all (default), photos or videos
- min_upload_date
-
Minimum upload date. Photos with an upload date greater than or equal to this value will be returned. The date can be in the form of a unix timestamp or mysql datetime.
- extras
-
A comma-delimited list of extra information to fetch for each returned record. Currently supported fields are: description, license, date_upload, date_taken, owner_name, icon_server, original_format, last_update, geo, tags, machine_tags, o_dims, views, media, path_alias, url_sq, url_t, url_s, url_q, url_m, url_n, url_z, url_c, url_l, url_o
- per_page
-
Number of photos to return per page. If this argument is omitted, it defaults to 100. The maximum allowed value is 500.
- page
-
The page of results to return. If this argument is omitted, it defaults to 1.
Error codes
-
96: Invalid signature
The passed signature was invalid.
-
97: Missing signature
The call required signing but no signature was sent.
-
98: Login failed / Invalid auth token
The login details or auth token passed were invalid.
-
99: User not logged in / Insufficient permissions
The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions.
-
100: Invalid API Key
The API key passed was not valid or has expired.
-
105: Service currently unavailable
The requested service is temporarily unavailable.
-
106: Write operation failed
The requested operation failed due to a temporary issue.
-
111: Format “xxx” not found
The requested response format was not found.
-
112: Method “xxx” not found
The requested method was not found.
-
114: Invalid SOAP envelope
The SOAP envelope send in the request could not be parsed.
-
115: Invalid XML-RPC Method Call
The XML-RPC request document could not be parsed.
-
116: Bad URL found
One or more arguments contained a URL that has been used for abuse on Flickr.
# Generated automatically from flickr api
def getWithoutGeoData(*args)
@flickr.call 'flickr.photos.getWithoutGeoData', *args
end
Returns a Licenses object.
Returns a Notes object.
Returns a People object.
flickr.photos.recentlyUpdated request.
Return a list of your photos that have been recently created or which have been recently modified.
Recently modified may mean that the photo's metadata (title, description, tags) may have been changed or a comment has been added (or just modified somehow :-)
Arguments
- min_date (required)
-
A Unix timestamp or any English textual datetime description indicating the date from which modifications should be compared.
- extras
-
A comma-delimited list of extra information to fetch for each returned record. Currently supported fields are: description, license, date_upload, date_taken, owner_name, icon_server, original_format, last_update, geo, tags, machine_tags, o_dims, views, media, path_alias, url_sq, url_t, url_s, url_q, url_m, url_n, url_z, url_c, url_l, url_o
- per_page
-
Number of photos to return per page. If this argument is omitted, it defaults to 100. The maximum allowed value is 500.
- page
-
The page of results to return. If this argument is omitted, it defaults to 1.
Error codes
-
1: Required argument missing.
Some or all of the required arguments were not supplied.
-
2: Not a valid date
The date argument did not pass validation.
-
96: Invalid signature
The passed signature was invalid.
-
97: Missing signature
The call required signing but no signature was sent.
-
98: Login failed / Invalid auth token
The login details or auth token passed were invalid.
-
99: User not logged in / Insufficient permissions
The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions.
-
100: Invalid API Key
The API key passed was not valid or has expired.
-
105: Service currently unavailable
The requested service is temporarily unavailable.
-
106: Write operation failed
The requested operation failed due to a temporary issue.
-
111: Format “xxx” not found
The requested response format was not found.
-
112: Method “xxx” not found
The requested method was not found.
-
114: Invalid SOAP envelope
The SOAP envelope send in the request could not be parsed.
-
115: Invalid XML-RPC Method Call
The XML-RPC request document could not be parsed.
-
116: Bad URL found
One or more arguments contained a URL that has been used for abuse on Flickr.
Returns
# Generated automatically from flickr api
def recentlyUpdated(*args)
@flickr.call 'flickr.photos.recentlyUpdated', *args
end
flickr.photos.removeTag request.
Remove a tag from a photo.
Arguments
- tag_id (required)
-
The tag to remove from the photo. This parameter should contain a tag id, as returned by flickr.photos.getInfo.
Error codes
-
1: Tag not found
The calling user doesn't have permission to delete the specified tag. This could mean it belongs to someone else, or doesn't exist.
-
96: Invalid signature
The passed signature was invalid.
-
97: Missing signature
The call required signing but no signature was sent.
-
98: Login failed / Invalid auth token
The login details or auth token passed were invalid.
-
99: User not logged in / Insufficient permissions
The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions.
-
100: Invalid API Key
The API key passed was not valid or has expired.
-
105: Service currently unavailable
The requested service is temporarily unavailable.
-
106: Write operation failed
The requested operation failed due to a temporary issue.
-
111: Format “xxx” not found
The requested response format was not found.
-
112: Method “xxx” not found
The requested method was not found.
-
114: Invalid SOAP envelope
The SOAP envelope send in the request could not be parsed.
-
115: Invalid XML-RPC Method Call
The XML-RPC request document could not be parsed.
-
116: Bad URL found
One or more arguments contained a URL that has been used for abuse on Flickr.
# Generated automatically from flickr api
def removeTag(*args)
@flickr.call 'flickr.photos.removeTag', *args
end
flickr.photos.search request.
Return a list of photos matching some criteria. Only photos visible to the calling user will be returned. To return private or semi-private photos, the caller must be authenticated with 'read' permissions, and have permission to view the photos. Unauthenticated calls will only return public photos.
Arguments
- user_id
-
The NSID of the user who's photo to search. If this parameter isn't passed then everybody's public photos will be searched. A value of “me” will search against the calling user's photos for authenticated calls.
- tags
-
A comma-delimited list of tags. Photos with one or more of the tags listed will be returned. You can exclude results that match a term by prepending it with a - character.
- tag_mode
-
Either 'any' for an OR combination of tags, or 'all' for an AND combination. Defaults to 'any' if not specified.
- text
-
A free text search. Photos who's title, description or tags contain the text will be returned. You can exclude results that match a term by prepending it with a - character.
- min_upload_date
-
Minimum upload date. Photos with an upload date greater than or equal to this value will be returned. The date can be in the form of a unix timestamp or mysql datetime.
- max_upload_date
-
Maximum upload date. Photos with an upload date less than or equal to this value will be returned. The date can be in the form of a unix timestamp or mysql datetime.
- min_taken_date
-
Minimum taken date. Photos with an taken date greater than or equal to this value will be returned. The date can be in the form of a mysql datetime or unix timestamp.
- max_taken_date
-
Maximum taken date. Photos with an taken date less than or equal to this value will be returned. The date can be in the form of a mysql datetime or unix timestamp.
- license
-
The license id for photos (for possible values see the flickr.photos.licenses.getInfo method). Multiple licenses may be comma-separated.
- sort
-
The order in which to sort returned photos. Deafults to date-posted-desc (unless you are doing a radial geo query, in which case the default sorting is by ascending distance from the point specified). The possible values are: date-posted-asc, date-posted-desc, date-taken-asc, date-taken-desc, interestingness-desc, interestingness-asc, and relevance.
- privacy_filter
-
Return photos only matching a certain privacy level. This only applies when making an authenticated call to view photos you own. Valid values are:
1 public photos 2 private photos visible to friends 3 private photos visible to family 4 private photos visible to friends & family 5 completely private photos
- bbox
-
A comma-delimited list of 4 values defining the Bounding Box of the area that will be searched.
The 4 values represent the bottom-left corner of the box and the top-right corner, minimum_longitude, minimum_latitude, maximum_longitude, maximum_latitude.
Longitude has a range of -180 to 180 , latitude of -90 to 90. Defaults to -180, -90, 180, 90 if not specified.
Unlike standard photo queries, geo (or bounding box) queries will only return 250 results per page.
Geo queries require some sort of limiting agent in order to prevent the database from crying. This is basically like the check against “parameterless searches” for queries without a geo component.
A tag, for instance, is considered a limiting agent as are user defined min_date_taken and min_date_upload parameters — If no limiting factor is passed we return only photos added in the last 12 hours (though we may extend the limit in the future).
- accuracy
-
Recorded accuracy level of the location information. Current range is 1-16 :
World level is 1 Country is ~3 Region is ~6 City is ~11 Street is ~16
Defaults to maximum value if not specified.
- safe_search
-
Safe search setting:
1 for safe. 2 for moderate. 3 for restricted.
(Please note: Un-authed calls can only see Safe content.)
- content_type
-
Content Type setting:
1 for photos only. 2 for screenshots only. 3 for 'other' only. 4 for photos and screenshots. 5 for screenshots and 'other'. 6 for photos and 'other'. 7 for photos, screenshots, and 'other' (all).
- machine_tags
-
Aside from passing in a fully formed machine tag, there is a special syntax for searching on specific properties :
Find photos using the 'dc' namespace : “machine_tags” => “dc:”
Find photos with a title in the 'dc' namespace : "machine_tags" => "dc:title=" Find photos titled "mr. camera" in the 'dc' namespace : "machine_tags" => "dc:title=\"mr. camera\" Find photos whose value is "mr. camera" : "machine_tags" => "*:*=\"mr. camera\"" Find photos that have a title, in any namespace : "machine_tags" => "*:title=" Find photos that have a title, in any namespace, whose value is "mr. camera" : "machine_tags" => "*:title=\"mr. camera\"" Find photos, in the 'dc' namespace whose value is "mr. camera" : "machine_tags" => "dc:*=\"mr. camera\""
Multiple machine tags may be queried by passing a comma-separated list. The number of machine tags you can pass in a single query depends on the tag mode (AND or OR) that you are querying with. “AND” queries are limited to (16) machine tags. “OR” queries are limited to (8).
- machine_tag_mode
-
Either 'any' for an OR combination of tags, or 'all' for an AND combination. Defaults to 'any' if not specified.
- group_id
-
The id of a group who's pool to search. If specified, only matching photos posted to the group's pool will be returned.
- faves
-
boolean. Pass faves=1 along with your user_id to search within your favorites
- camera
-
Limit results by camera. Camera names must be in the Camera Finder normalized form. flickr.cameras.getList() returns a list of searchable cameras.
- jump_to
-
Jump, jump!
- contacts
-
Search your contacts. Either 'all' or 'ff' for just friends and family. (Experimental)
- woe_id
-
A 32-bit identifier that uniquely represents spatial entities. (not used if bbox argument is present).
Geo queries require some sort of limiting agent in order to prevent the database from crying. This is basically like the check against “parameterless searches” for queries without a geo component.
A tag, for instance, is considered a limiting agent as are user defined min_date_taken and min_date_upload parameters — If no limiting factor is passed we return only photos added in the last 12 hours (though we may extend the limit in the future).
- place_id
-
A Flickr place id. (not used if bbox argument is present).
Geo queries require some sort of limiting agent in order to prevent the database from crying. This is basically like the check against “parameterless searches” for queries without a geo component.
A tag, for instance, is considered a limiting agent as are user defined min_date_taken and min_date_upload parameters — If no limiting factor is passed we return only photos added in the last 12 hours (though we may extend the limit in the future).
- media
-
Filter results by media type. Possible values are all (default), photos or videos
- has_geo
-
Any photo that has been geotagged, or if the value is “0” any photo that has not been geotagged.
Geo queries require some sort of limiting agent in order to prevent the database from crying. This is basically like the check against “parameterless searches” for queries without a geo component.
A tag, for instance, is considered a limiting agent as are user defined min_date_taken and min_date_upload parameters — If no limiting factor is passed we return only photos added in the last 12 hours (though we may extend the limit in the future).
- geo_context
-
Geo context is a numeric value representing the photo's geotagginess beyond latitude and longitude. For example, you may wish to search for photos that were taken “indoors” or “outdoors”.
The current list of context IDs is :0, not defined. 1, indoors. 2, outdoors.
Geo queries require some sort of limiting agent in order to prevent the database from crying. This is basically like the check against “parameterless searches” for queries without a geo component.
A tag, for instance, is considered a limiting agent as are user defined min_date_taken and min_date_upload parameters — If no limiting factor is passed we return only photos added in the last 12 hours (though we may extend the limit in the future).
- lat
-
A valid latitude, in decimal format, for doing radial geo queries.
Geo queries require some sort of limiting agent in order to prevent the database from crying. This is basically like the check against “parameterless searches” for queries without a geo component.
A tag, for instance, is considered a limiting agent as are user defined min_date_taken and min_date_upload parameters — If no limiting factor is passed we return only photos added in the last 12 hours (though we may extend the limit in the future).
- lon
-
A valid longitude, in decimal format, for doing radial geo queries.
Geo queries require some sort of limiting agent in order to prevent the database from crying. This is basically like the check against “parameterless searches” for queries without a geo component.
A tag, for instance, is considered a limiting agent as are user defined min_date_taken and min_date_upload parameters — If no limiting factor is passed we return only photos added in the last 12 hours (though we may extend the limit in the future).
- radius
-
A valid radius used for geo queries, greater than zero and less than 20 miles (or 32 kilometers), for use with point-based geo queries. The default value is 5 (km).
- radius_units
-
The unit of measure when doing radial geo queries. Valid options are “mi” (miles) and “km” (kilometers). The default is “km”.
- is_commons
-
Limit the scope of the search to only photos that are part of the Flickr Commons project. Default is false.
- in_gallery
-
Limit the scope of the search to only photos that are in a gallery? Default is false, search all photos.
- person_id
-
The id of a user. Will return photos where the user has been people tagged. A call signed as the person_id in question will return all photos the user in, otherwise returns public photos.
- is_getty
-
Limit the scope of the search to only photos that are for sale on Getty. Default is false.
- username
-
username/character name of the person whose photos you want to search.
- exif_min_exposure
- exif_max_exposure
- exif_min_aperture
- exif_max_aperture
- exif_min_focallen
- exif_max_focallen
- exclude_user_id
- exif_max_exposure
-
NSId of the user to be excluded.
- extras
-
A comma-delimited list of extra information to fetch for each returned record. Currently supported fields are: description, license, date_upload, date_taken, owner_name, icon_server, original_format, last_update, geo, tags, machine_tags, o_dims, views, media, path_alias, url_sq, url_t, url_s, url_q, url_m, url_n, url_z, url_c, url_l, url_o
- per_page
-
Number of photos to return per page. If this argument is omitted, it defaults to 100. The maximum allowed value is 500.
- page
-
The page of results to return. If this argument is omitted, it defaults to 1.
Error codes
-
1: Too many tags in ALL query
When performing an 'all tags' search, you may not specify more than 20 tags to join together.
-
2: Unknown user
A user_id was passed which did not match a valid flickr user.
-
3: Parameterless searches have been disabled
To perform a search with no parameters (to get the latest public photos, please use flickr.photos.getRecent instead).
-
4: You don't have permission to view this pool
The logged in user (if any) does not have permission to view the pool for this group.
-
10: Sorry, the Flickr search API is not currently available.
The Flickr API search databases are temporarily unavailable.
-
11: No valid machine tags
The query styntax for the machine_tags argument did not validate.
-
12: Exceeded maximum allowable machine tags
The maximum number of machine tags in a single query was exceeded.
-
13: jump_to not avaiable for this query
jump_to only supported for some query types.
-
14: Bad value for jump_to
jump_to must be valid photo ID.
-
15: Photo not found
-
16: You can only search within your own favorites
-
17: You can only search within your own contacts
The call tried to use the contacts parameter with no user ID or a user ID other than that of the authenticated user.
-
18: Illogical arguments
The request contained contradictory arguments.
-
20: Excessive photo offset in search
The search requested photos beyond an allowable offset. Reduce the page number or number of results per page for this search.
-
100: Invalid API Key
The API key passed was not valid or has expired.
-
105: Service currently unavailable
The requested service is temporarily unavailable.
-
106: Write operation failed
The requested operation failed due to a temporary issue.
-
111: Format “xxx” not found
The requested response format was not found.
-
112: Method “xxx” not found
The requested method was not found.
-
114: Invalid SOAP envelope
The SOAP envelope send in the request could not be parsed.
-
115: Invalid XML-RPC Method Call
The XML-RPC request document could not be parsed.
-
116: Bad URL found
One or more arguments contained a URL that has been used for abuse on Flickr.
# Generated automatically from flickr api
def search(*args)
@flickr.call 'flickr.photos.search', *args
end
flickr.photos.setContentType request.
Set the content type of a photo.
Arguments
- photo_id (required)
-
The id of the photo to set the adultness of.
- content_type (required)
-
The content type of the photo. Must be one of: 1 for Photo, 2 for Screenshot, and 3 for Other.
Error codes
-
1: Photo not found
The photo id passed was not a valid photo id of a photo belonging to the calling user.
-
2: Required arguments missing
Some or all of the required arguments were not supplied.
-
3: Change not allowed
Changing the content type of this photo is not allowed.
-
96: Invalid signature
The passed signature was invalid.
-
97: Missing signature
The call required signing but no signature was sent.
-
98: Login failed / Invalid auth token
The login details or auth token passed were invalid.
-
99: User not logged in / Insufficient permissions
The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions.
-
100: Invalid API Key
The API key passed was not valid or has expired.
-
105: Service currently unavailable
The requested service is temporarily unavailable.
-
106: Write operation failed
The requested operation failed due to a temporary issue.
-
111: Format “xxx” not found
The requested response format was not found.
-
112: Method “xxx” not found
The requested method was not found.
-
114: Invalid SOAP envelope
The SOAP envelope send in the request could not be parsed.
-
115: Invalid XML-RPC Method Call
The XML-RPC request document could not be parsed.
-
116: Bad URL found
One or more arguments contained a URL that has been used for abuse on Flickr.
Returns
# Generated automatically from flickr api
def setContentType(*args)
@flickr.call 'flickr.photos.setContentType', *args
end
flickr.photos.setDates request.
Set one or both of the dates for a photo.
Arguments
- photo_id (required)
-
The id of the photo to edit dates for.
- date_posted
-
The date the photo was uploaded to flickr (see the dates documentation)
- date_taken
-
The date the photo was taken (see the dates documentation)
- date_taken_granularity
-
The granularity of the date the photo was taken (see the dates documentation)
Error codes
-
1: Photo not found
The photo id was not the id of a valid photo belonging to the calling user.
-
2: Not enough arguments
No dates were specified to be changed.
-
3: Invalid granularity
The value passed for 'granularity' was not a valid flickr date granularity.
-
96: Invalid signature
The passed signature was invalid.
-
97: Missing signature
The call required signing but no signature was sent.
-
98: Login failed / Invalid auth token
The login details or auth token passed were invalid.
-
99: User not logged in / Insufficient permissions
The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions.
-
100: Invalid API Key
The API key passed was not valid or has expired.
-
105: Service currently unavailable
The requested service is temporarily unavailable.
-
106: Write operation failed
The requested operation failed due to a temporary issue.
-
111: Format “xxx” not found
The requested response format was not found.
-
112: Method “xxx” not found
The requested method was not found.
-
114: Invalid SOAP envelope
The SOAP envelope send in the request could not be parsed.
-
115: Invalid XML-RPC Method Call
The XML-RPC request document could not be parsed.
-
116: Bad URL found
One or more arguments contained a URL that has been used for abuse on Flickr.
# Generated automatically from flickr api
def setDates(*args)
@flickr.call 'flickr.photos.setDates', *args
end
flickr.photos.setMeta request.
Set the meta information for a photo.
Arguments
- photo_id (required)
-
The id of the photo to set information for.
- title (required)
-
The title for the photo.
- description (required)
-
The description for the photo.
Error codes
-
1: Photo not found
The photo id passed was not the id of a photo belonging to the calling user. It might be an invalid id, or the photo might be owned by another user.
-
96: Invalid signature
The passed signature was invalid.
-
97: Missing signature
The call required signing but no signature was sent.
-
98: Login failed / Invalid auth token
The login details or auth token passed were invalid.
-
99: User not logged in / Insufficient permissions
The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions.
-
100: Invalid API Key
The API key passed was not valid or has expired.
-
105: Service currently unavailable
The requested service is temporarily unavailable.
-
106: Write operation failed
The requested operation failed due to a temporary issue.
-
111: Format “xxx” not found
The requested response format was not found.
-
112: Method “xxx” not found
The requested method was not found.
-
114: Invalid SOAP envelope
The SOAP envelope send in the request could not be parsed.
-
115: Invalid XML-RPC Method Call
The XML-RPC request document could not be parsed.
-
116: Bad URL found
One or more arguments contained a URL that has been used for abuse on Flickr.
# Generated automatically from flickr api
def setMeta(*args)
@flickr.call 'flickr.photos.setMeta', *args
end
flickr.photos.setPerms request.
Set permissions for a photo.
Arguments
- photo_id (required)
-
The id of the photo to set permissions for.
- is_public (required)
-
1 to set the photo to public, 0 to set it to private.
- is_friend (required)
-
1 to make the photo visible to friends when private, 0 to not.
- is_family (required)
-
1 to make the photo visible to family when private, 0 to not.
- perm_comment (required)
-
who can add comments to the photo and it's notes. one of:0: nobody1: friends & family2: contacts3: everybody
- perm_addmeta (required)
-
who can add notes and tags to the photo. one of:0: nobody / just the owner1: friends & family2: contacts3: everybody
Error codes
-
1: Photo not found
The photo id passed was not a valid photo id of a photo belonging to the calling user.
-
2: Required arguments missing
Some or all of the required arguments were not supplied.
-
96: Invalid signature
The passed signature was invalid.
-
97: Missing signature
The call required signing but no signature was sent.
-
98: Login failed / Invalid auth token
The login details or auth token passed were invalid.
-
99: User not logged in / Insufficient permissions
The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions.
-
100: Invalid API Key
The API key passed was not valid or has expired.
-
105: Service currently unavailable
The requested service is temporarily unavailable.
-
106: Write operation failed
The requested operation failed due to a temporary issue.
-
111: Format “xxx” not found
The requested response format was not found.
-
112: Method “xxx” not found
The requested method was not found.
-
114: Invalid SOAP envelope
The SOAP envelope send in the request could not be parsed.
-
115: Invalid XML-RPC Method Call
The XML-RPC request document could not be parsed.
-
116: Bad URL found
One or more arguments contained a URL that has been used for abuse on Flickr.
Returns
1234
# Generated automatically from flickr api
def setPerms(*args)
@flickr.call 'flickr.photos.setPerms', *args
end
flickr.photos.setSafetyLevel request.
Set the safety level of a photo.
Arguments
- photo_id (required)
-
The id of the photo to set the adultness of.
- safety_level
-
The safety level of the photo. Must be one of:
1 for Safe, 2 for Moderate, and 3 for Restricted.
- hidden
-
Whether or not to additionally hide the photo from public searches. Must be either 1 for Yes or 0 for No.
Error codes
-
1: Photo not found
The photo id passed was not a valid photo id of a photo belonging to the calling user.
-
2: Invalid or missing arguments
Neither a valid safety level nor a hidden value were passed.
-
3: Change not allowed
Changing the safety level of this photo is not allowed.
-
96: Invalid signature
The passed signature was invalid.
-
97: Missing signature
The call required signing but no signature was sent.
-
98: Login failed / Invalid auth token
The login details or auth token passed were invalid.
-
99: User not logged in / Insufficient permissions
The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions.
-
100: Invalid API Key
The API key passed was not valid or has expired.
-
105: Service currently unavailable
The requested service is temporarily unavailable.
-
106: Write operation failed
The requested operation failed due to a temporary issue.
-
111: Format “xxx” not found
The requested response format was not found.
-
112: Method “xxx” not found
The requested method was not found.
-
114: Invalid SOAP envelope
The SOAP envelope send in the request could not be parsed.
-
115: Invalid XML-RPC Method Call
The XML-RPC request document could not be parsed.
-
116: Bad URL found
One or more arguments contained a URL that has been used for abuse on Flickr.
Returns
# Generated automatically from flickr api
def setSafetyLevel(*args)
@flickr.call 'flickr.photos.setSafetyLevel', *args
end
flickr.photos.setTags request.
Set the tags for a photo.
Arguments
- photo_id (required)
-
The id of the photo to set tags for.
- tags (required)
-
All tags for the photo (as a single space-delimited string).
Error codes
-
1: Photo not found
The photo id passed was not the id of a photo belonging to the calling user. It might be an invalid id, or the photo might be owned by another user.
-
2: Maximum number of tags reached
The number of tags specified exceeds the limit for the photo. No tags were modified.
-
96: Invalid signature
The passed signature was invalid.
-
97: Missing signature
The call required signing but no signature was sent.
-
98: Login failed / Invalid auth token
The login details or auth token passed were invalid.
-
99: User not logged in / Insufficient permissions
The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions.
-
100: Invalid API Key
The API key passed was not valid or has expired.
-
105: Service currently unavailable
The requested service is temporarily unavailable.
-
106: Write operation failed
The requested operation failed due to a temporary issue.
-
111: Format “xxx” not found
The requested response format was not found.
-
112: Method “xxx” not found
The requested method was not found.
-
114: Invalid SOAP envelope
The SOAP envelope send in the request could not be parsed.
-
115: Invalid XML-RPC Method Call
The XML-RPC request document could not be parsed.
-
116: Bad URL found
One or more arguments contained a URL that has been used for abuse on Flickr.
# Generated automatically from flickr api
def setTags(*args)
@flickr.call 'flickr.photos.setTags', *args
end
Returns a Suggestions object.
Returns a Transform object.
Returns a Upload object.