Add External Media

From KickApps Documentation

Jump to: navigation, search

“External media” is a placeholder within the KIT Cloud Social media database, allowing you to create rows for content that is hosted on your own site or CMS. This feature allows you to add KIT Cloud Social-powered comments and ratings to non-KIT Cloud Social content.

Use this URI to add an external media object to the database:

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

The call is otherwise the same as the Add Blog Post call (above) with the exception of the following parameters:

Name Value
name Media’s name. required. Must be 2 characters or longer.
author Media’s author. If null, the webmaster’s username is autopopulated as the author string.
pathToMedia Required. This is the URL of the external media. It must be unique – this value will function as the media’s unique ID on for all subsequent API calls.
allowPublicTagging Boolean. true or false. true for allowing other site users to be able to add tags to the media. No to restrict other site members from adding tags to the media.
allowPublicCommenting Not included.
updatedAt Optional. The date on which the media should be marked as modified. If its not passed the the time this call is made will be used. Format: mm/dd/yyyy hh:mm
createdAt Optional. The date on which the media should be marked as created. If its not passed the the time this call is made will be used. Format: mm/dd/yyyy hh:mm



List of Kit Cloud Social API Calls


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.