Upload Group Photo

From KickApps Documentation

Contents 1 Overview 2 Parameters 3 Post Parameters 4 JSON Payload 5 Permissions 6 Overview 7 Parameters 8 Post Parameters 9 JSON Payload 10 Permissions

Overview

Adds an image to an existing group. This image serves as the group’s logo. You can make an HTTP POST request for this call. This call may only be invoked by the site administrator. This is a multipart HTTP POST request that uploads a new image file (JPG, PNG, or GIF, no progressive JPGs or animated GIFs), directly from the user. For more information on file uploads, see the Upload Media call.

Important: Do not submit the upload form directly from the web browser. Instead, the client-side form should send data to your server, which compiles the data before requesting the upload URI.

http://api.kickapps.com/rest/grouplogo/add/{groupId}/{as}

When using multipart form fields, the form's method should be set to POST and the form's enctype attribute should be set to multipart/form-data. For example:

<form name="uploadForm" method="POST" enctype="multipart/form-data" action="processUpload.jsp">

Parameters

As shown above, your call will include the following parameters:

• groupId. The ID of the group to which the photo is being added to.
• as. The site that the group is a part of. as is unique for each of the affiliate's sites.

Post Parameters

• t. String. Required. Your access permissions.
• callback. String. Optional. The name of your JavaScript callback function.
• clientIP. String. Optional. Use the clientIP parameter to pass the IP address of the user making the call. If the IP has been blocked by the webmaster under the Affiliate Center -> Manage Members section, an error message will be returned starting with "status":"-1","error":"This IP address has been banned".
• photoPortrait. The actual media file that will be uploaded.

JSON Payload

On success, a payload that begins with "status":"1","error":"".

Permissions

Overview

KickConnect API call that lets you post activities done outside the community into the community activity feeds for members.

Your request will look something like the following:

http://api.kickapps.com/rest/kickconnect/{memberId}/{as} 

Parameters

As shown above, your call will include the following parameters:

• memberId. The id of the user for who the update is being made.
• as. The site Id to search. as is unique for each of the affiliate's sites.

Post Parameters

• t. String. Required. Your access permissions.
• callback. String. Optional. The name of your JavaScript callback function.
• clientIP. String. Optional. Use the clientIP parameter to pass the IP address of the user making the call. If the IP has been blocked by the webmaster under the Affiliate Center -> Manage Members section, an error message will be returned starting with "status":"-1","error":"This IP address has been banned".
• storyContent. Required. Accepts HTML and text. Allows 5,000 characters. Be sure to urlEncode the string that you pass for this variable.

• storyIcon. Optional. url of the image to be associated with the story. Recommended size is 16 X 16.

• postedFromSource. Optional. This is the name of the service from which the activity is being posted from. Allows 200 characters.

• postToGroups. Optional. Should accept comma separated groupID's. Should only post to a group if the user is a member of that group.

JSON Payload

• On success, the call will return "status":"1","message":"Story published successfully."
• On failure, the call will return "status":"-1","message":"Story could not be published. Please make sure that the provided information is accurate."
• If the user doesn't belong to the group(s) return, "status":"-1","message":"Story could not be published. Please make sure that the member belongs to the group(s)."

Permissions