diff --git a/doc/api.md b/doc/api.md index 35a5a8c6ca..d1f2ebc86b 100644 --- a/doc/api.md +++ b/doc/api.md @@ -460,6 +460,28 @@ Friendica doesn't allow showing followers of other users. Friendica doesn't allow showing friends of other users. +--- +### account/update_profile_image (POST; AUTH) +#### Parameters +* image: image data as base64 (Twitter has a limit of 700kb, Friendica allows more) +* profile_id (optional): id of the profile for which the image should be used, default is changing the default profile + +uploads a new profile image (scales 4-6) to database, changes default or specified profile to the new photo + +#### Return values + +On success: +* JSON return: returns the updated user details (see account/verify_credentials) + +On error: +* 403 FORBIDDEN: if not authenticated +* 400 BADREQUEST: "no media data submitted", "profile_id not available" +* 500 INTERNALSERVERERROR: "image size exceeds PHP config settings, file was rejected by server", + "image size exceeds Friendica Config setting (uploaded size: x)", + "unable to process image data", + "image upload failed" + + ## Implemented API calls (not compatible with other APIs) @@ -765,7 +787,7 @@ On error: * desc (optional): description for the photo, updated when photo_id is specified * album: name of the album to be deleted (always necessary) * album_new (optional): can be used to change the album of a single photo if photo_id is specified -* allow_cid/allow_gid/deny_cid/deny_gid (optional): on create: empty string or omitting = public photo, specify in format '' for private photo; +* allow_cid/allow_gid/deny_cid/deny_gid (optional): on create: empty string or omitting = public photo, specify in format '``````' for private photo; on update: keys need to be present with empty values for setting a private photo now to public both calls point to one function for creating AND updating photos. Saves data for the scales 0-2 to database (see above for scale description). Call adds non-visible entries to items table to enable authenticated contacts to comment/like the photo. @@ -811,28 +833,6 @@ On error: * 500 INTERNALSERVERERROR: "unknown error on deleting photo", "problem with deleting items occurred" ---- -### account/update_profile_image (POST; AUTH) -#### Parameters -* image: image data as base64 (Twitter has a limit of 700kb, Friendica allows more) -* profile_id (optional): id of the profile for which the image should be used, default is changing the default profile - -uploads a new profile image (scales 4-6) to database, changes default or specified profile to the new photo - -#### Return values - -On success: -* JSON return: returns the updated user details (see account/verify_credentials) - -On error: -* 403 FORBIDDEN: if not authenticated -* 400 BADREQUEST: "no media data submitted", "profile_id not available" -* 500 INTERNALSERVERERROR: "image size exceeds PHP config settings, file was rejected by server", - "image size exceeds Friendica Config setting (uploaded size: x)", - "unable to process image data", - "image upload failed" - - --- ### friendica/direct_messages_setseen (GET; AUTH) #### Parameters