Change Log

From KickApps Documentation

Contents 1 July 22nd, 2010 1.1 New Calls/Features 1.2 Bugs 2 May 11th, 2010 3 May 5th, 2010 4 March 1st, 2010 5 January 26th, 2010 6 November 3rd, 2009 7 November 2nd, 2009 8 August 27th, 2009 9 August 18th, 2009 10 July 16th, 2009 11 July 15th, 2009 12 June 22nd, 2009 13 June 22nd, 2009 14 June 11th, 2009 15 June 3rd, 2009 16 May 27th, 2009 17 May 15th, 2009 17.1 List of Kit Cloud Social API Calls

July 22nd, 2010

New Calls/Features

• The following new calls were added:
  • Remove Media from Set
  • Edit Set
  • Delete Set
  • Retrieve User by Facebook Id
  • Retrieve Set
  • Retrieve Site Settings
  • Retrieve Related Media
  • Assign Member Profile Photo
  • Remove Member Profile Photo

• The following are the updates to existing calls:
  • API's now support "automatically approve content from this member" functionality.
  • Added sets and favoriteSets parameters in the payload for Retrieve Member Profile ( Updated!) call.
  • Added role and isRatedByMe param in the payload for Retrieve Member Profile ( Updated!) call.
  • Media can now be retrieved in approved and rejected status using the Retrieve Pending Media for the site or for a particular member of a site.
  • Search API now returns the pathToMedia param in the payload when external media is included in the search.
  • Add Or Remove Media Flag, Rate Media, Retrieve Media Ratings support user media type.
  • Retrieve Member's Favorite Media updated now to support retrieving member favorite media across multiple media types.
  • The following calls now support "Sets" media type
    • Add To Or Remove From Favorites
    • Add Tags To Media, Members and Groups
    • Add Admin Tags To Media, Members and Groups
    • Remove Admin Tags From Media, Members and Groups
    • Rate Media
    • Approve Member Media
    • Reject Member Media
    • Member Favorite Media Check
    • Retrieve Member Media
    • Retrieve Member's Favorite Media
    • Retrieve Media Rated By Member
    • Add Media Comment
    • Delete Comment
    • Retrieve Admin Tags
    • Add Or Remove Media Flag
    • Retrieve Comments
    • Retrieve Tag Count
    • Flag Comment
    • Retrieve Pending Media
    • Retrieve Media Ratings
    • Add/Remove Media To Group
    • Edit Comment
    • Email Media
    • Search
    • Retrieve Related Media
    • Retrieve Member Media, Retrieve Media Meta Data return a list of setId's that the each media in the response belongs to.
  • The following calls now support Admin Role:
    • KickConnect
    • Member Favorite Media Check
    • Approve Member
    • Reject Member
    • Approve Member Media
    • Reject Member Media
    • Retrieve Pending Media
    • Retrieve Active Member Count
    • Remove Custom Meta Data
    • Delete Category
    • Edit Category
    • Add Category
    • Add Admin Tags To Media, Members and Groups
    • Remove Admin Tags From Media, Members and Groups
    • Retrieve Admin Tags
    • Set Member Offset
    • Set Member Custom Level
    • Add to Member Offset
    • Upload Group Photo
    • Remove Group Photo
    • Retrieve Member Groups
    • Add/Remove Media To Group
    • Add/Remove Member To Group
    • Edit Group
    • Add Group
  • Edit Media Meta Data call now supports 'isProfileImage' param when media type is selected as photo.
  • Add Media Set, Edit Set and Add Media to Set calls now return "Access Denied." error when a user tries to add another members media that has been restricted such that other members cannot add that media to their sets.
  • Upload Media, Edit Media Meta Data, Add Blog Post, Edit Blog Post now support "isAddToMediaSetAllowed" post param to allow/disallow other community members from adding media that belongs to other users to their sets.
  • Retrieve Media Meta Data, Retrieve Play Page, Retrieve Member Media and Retrieve Member's Favorite Media now return "isAddToMediaSetAllowed" in the payload to indicate if the media contributor has restricted the media from being added to sets that belong to other members.
  • "user" media type now supported for Rate Media, Retrieve Media Ratings, Add Or Remove Media Flag API
  • Added updatedAt and createdAt post params to Add/Remove Media To Group call.
  • Retrieve Member Profile ( Updated!) call now returns the inappropriate flag count for the user in the payload.

Bugs

• Flag Group Comment API now updates flag count along with the notification.
• Flag Comment API now allows a member to flag a comment only once.
• Add Tags To Media, Members and Groups call now checks for the allowPublicTagging flag.

May 11th, 2010

• Added createdAt and updatedAt post parameters to the following API calls (These post params allow you to modify the createdAt and updatedAt dates for your site assets) :
  • Upload Media
  • Add Blog Post
  • Add External Media
  • Add Group Comment
  • Add Media Comment
  • Add Profile Comment
  • Add Group
  • Add Media Set
  • Edit Media Meta Data
• Retrieve Comments call now supports the group media type.

May 5th, 2010

Added the Add Media to Set call.

March 1st, 2010

Added the Add Media Set call.

January 26th, 2010

Added the following new API calls:

• Member Favorite Media Check

Updated the following calls:

• New filters for the Retrieve Member Media REST call.
  • The Retrieve Member Media REST API call will support optional sortName and sortBy parameters. Filters supported for sortName are: votes, views, averageRating and createdAt. Filters supported for sortBy are: asc or desc.
• New filters for the Retrieve Member's Favorite Media REST call.
  • The Retrieve Member Favorite Media REST API call will support optional sortName and sortBy parameters. Filters supported for sortName are: votes, views, averageRating, createdAt and favAt. Filters supported for sortBy are: asc or desc.

November 3rd, 2009

Media Privacy is now supported in API calls. The following calls were affected:

• API calls whose payload will now include the "isPrivacyEnabled" parameter:
  • Retrieve Group Page
  • Retrieve Member Media
  • Retrieve Media Meta Data
  • Add/Remove Media To Group
  • Retrieve Play Page
  • Retrieve Pending Media
• API calls that will support the "isPrivacyEnabled" parameter are:
  • Upload Media
  • Edit Media Meta Data
  • Add Blog Post
  • Edit Blog Post

November 2nd, 2009

• Updated the Retrieve Pending Media and Search calls to have the numComments param in the payload.
• Added the following new calls:
  • Retrieve Active Member Count
  • Retrieve Media Rated By Member
  • Retrieve Media Meta Data
  • Retrieve Member Groups
• Email Media call now supports sending emails to community members by using their usernames.

August 27th, 2009

• Added the following new calls to the documentation:
  • Add Custom Meta Data
  • Remove Custom Meta Data
  • Retrieve Custom Meta Data

August 18th, 2009

• Added the following new calls to the documentation:
  • Retrieve Member Media
  • Edit Media Meta Data
• Updated the Retrieve Member Profile ( Updated!) to return profilePrivacy param in the payload.

July 16th, 2009

Corrected the documentation to have the correct payload for the Upload Media.

July 15th, 2009

• Updated the payload of the Retrieve Member Profile ( Updated!) to include the users Facebook Id. Parameter name - facebookUserId
• Updated the Upload Media and Add Blog Post to add the status parameter.
• Added the new KickConnect call.

June 22nd, 2009

• Updated the Add/Remove Member To Group call documentation to include the payload.

June 22nd, 2009

• Updated all calls to support 'clientIP' in post parameters to ban IP addresses.
• Added the following new calls:
  • Retrieve Tag Count

June 11th, 2009

1. Added the following new calls to the KickApps API inventory:
   1. Approve Member Media
   2. Reject Member Media
   3. Approve Member
   4. Reject Member
2. Updated the Upload Media call documentation to include a PHP script on how to upload multiple media files.

June 3rd, 2009

1. Added Retrieve Admin Tags call.

May 27th, 2009

1. Updated Rate Media call to clarify the accepted values for "rating" parameter.
2. Updated add media comment, add group comment, add profile comment, retrieve comment calls to include reviewed and visible post parameters.
3. Updated add media comment and add group comment to include "newCommentId" in the JSON payload.

May 15th, 2009

1. Added Retrieve Member Profile ( Updated!) - The old member profile call will be phased out on 1/1/10. # The new call returns Points and Level data for a member.
2. Added New Edit External Media Call (Currently only external media call can be edited using this call)
3. Added New Add Category Call
4. Added New Edit Category Call
5. Added New Retrieve Category Call
6. Added New Set Member Offset Call
7. Added New Add to Member Offset Call
8. Added New Retrieve Member Points Call
9. Added New Set Member Custom Level Call
10. Update - Added a New Page for Create Token Call

List of Kit Cloud Social API Calls

API Change Log Create Token Call Social Networking Retrieve Member Profile Add Or Remove Member As Friend Get A Member's Friends, Fans, and "Fan Of" Retrieve User by Facebook Id KickConnect Assign Member Profile Photo Remove Member Profile Photo Member Profile Edit/Update SSO Method Member Register SSO Method Combined Member Sign On and Register SSO Method Member Change Username SSO Method Member Change Email SSO Method OpenAuth Create Message Board Media Sharing Upload Media Retrieve Media Meta Data Edit Media Meta Data Delete Member Media Retrieve Play Page Retrieve Member Media Retrieve Member's Favorite Media Retrieve Related Media Member Favorite Media Check Email Media Add Or Remove Media Flag Add To Or Remove From Favorites Geographic Values for Media Uploads Get Video Thumbnails Set Video Thumbnail Blogging Add Blog Post Edit Blog Post Comments and Rating Add External Media Retrieve External Media Edit External Media Add Group Comment Add Media Comment Add Profile Comment Retrieve Comments Search Comments Edit Comment Edit Group Comment Delete Comment Delete Group Comment Flag Comment Flag Group Comment Rate Media Retrieve Media Ratings Retrieve Media Rated By Member Retrieve Likes By User ID Search Search Media Sets Add Media Set Edit Set Retrieve Set Delete Set Add Media to Set Remove Media from Set Groups Add Group Retrieve Group Page Edit Group Request A Group Add/Remove Media To Group Add/Remove Member To Group Retrieve Member Groups Upload Group Photo Remove Group Photo Polls Creating Polls Using the Tag API’s

Badges Add Badge Edit Badge List Badges Add Action List Actions Add Badge Requirement Edit Badge Requirement List Badge Requirements Add User Action Retrieve User's Badges Retrieve User's Badge Status Retrieve Super Fans Get Super Fan Ranking Set Super Fan Badge Criteria Contests Add Contest Edit Contest View Contest Retrieve All Contests Add Contest Entry Edit Contest Entry Remove Contest Entry View Contest Entry Retrieve Contest Entries Select Contest Winner Flag Contest Entry Add to Member Offset Retrieve Member Points Set Member Custom Level Set Member Offset Categories and Tags Add Tags To Media, Members and Groups Remove Tags From Media, Members and Groups Add Admin Tags To Media, Members and Groups Remove Admin Tags From Media, Members and Groups Retrieve Admin Tags Retrieve Tag Count Add Category Edit Category Retrieve Category Delete Category Add Custom Meta Data Remove Custom Meta Data Retrieve Custom Meta Data Member and Media Management Approve Member Reject Member Approve Member Media Reject Member Media Delete Member Media Retrieve Pending Media Retrieve Active Member Count Retrieve Site Settings CRM Connectors SugarCRM Connector Salesforce Connector CRM Connectors (COMING SOON!!) IBM Websphere Microsoft Dynamic CRM NetSuite Oracle CRM On Demand Oracle E-Business Suite CRM PeopleSoft Enterprise CRM Oracle Siebel CRM SAP CRM Sugar Professional Maximizer CRM Pegasystems Customer Process Manager

Note: Occasionally (and without advanced warning) we modify our API calls by adding new parameters in the response payload. Please keep this in mind when designing your strategy for parsing our responses.

Category:REST