The App Garden |
flickr.photos.people.add
Add a person to a photo. Coordinates and sizes of boxes are optional; they are measured 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 person to.
user_id(Required)- The NSID of the user to add to the photo.
person_x(Optional)- The left-most pixel co-ordinate of the box around the person.
person_y(Optional)- The top-most pixel co-ordinate of the box around the person.
person_w(Optional)- The width (in pixels) of the box around the person.
person_h(Optional)- The height (in pixels) of the box around the person.
Example Response
This method has no specific response - It returns an empty success response if it completes without error.
Error Codes
1: Person not found- The NSID passed was not a valid user id.
2: Photo not found- The photo id passed was not a valid photo id.
3: User cannot add this person to photos- The person being added cannot be added to this photo.
4: User cannot add people to that photo- The owner of the photo doesn't allow the calling user to add people to their photos.
5: Person can't be tagged in that photo- The person being added to the photo does not want to be identified in this photo.
6: Some co-ordinate paramters were blank- Not all of the co-ordinate parameters (person_x, person_y, person_w, person_h) were passed with valid values.
7: Can't add that person to a non-public photo- You can only add yourself to another member's non-public photos.
8: Too many people in that photo- The maximum number of people has already been added to the photo.
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.