The App Garden |
flickr.photos.notes.add
Add a note to a photo. Coordinates and sizes are in pixels, based on the 500px image size shown on individual photo pages.
Authentication
This method requiresauthentication with 'write' permission.
Note: This method requires an HTTP POST request.
Arguments
api_key(Required)- Your API application key.See here for more details.
photo_id(Required)- The id of the photo to add a note to
note_x(Required)- The left coordinate of the note
note_y(Required)- The top coordinate of the note
note_w(Required)- The width of the note
note_h(Required)- The height of the note
note_text(Required)- The description of the note
Example Response
<noteid="1234" />
Error Codes
1: Photo not found- The photo id passed was not a valid photo id
2: User cannot add notes- The calling user does not have permission to add a note to this photo
3: Missing required arguments- One or more of the required arguments were not supplied.
4: Maximum number of notes reached- The maximum number of notes for the photo has been reached.
5: Note would exceed photo dimensions- The note dimsension provided are larger than the photo dimension. Please reduce the note dimensions to an appropriate size.
6: User is posting notes too fast.- The user has reached the limit for number of notes posted during a specific time period. Wait a bit and try again.
95: SSL is required- SSL is required to access the Flickr API.
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.