Integrating Content

Percussion provides multiple API's and Tools that Developers can use to accomplish specific use cases and tasks.

Content REST API

The Content API exists to allow integrators to programmatically exchange content between the Percussion CMS content repository and external systems and applications. This API is only available for Percussion CMS version 4.3 and later. 

This API is not meant for use with Live content that the CMS has published to the web delivery tier.  For programmatic access to live content use the Delivery Tier Services API.

The  Content API has been created to allow developers to create folders and pages in the Percussion CMS programmatically. The documentation for the API can be accessed from any instance of the Percussion CMS.  To access the API, go to <percussionserver>:9992/cm/api/index.html. 

Usage 

The REST service can be accessed via server side code, a custom application or AJAX requests. Additionally, data can be sent and received in JSON format. 

Access to the service is restricted to users in the Administrator role and authentication credentials must be supplied at the time the service is called. HTTP Basic Authentication is used for authenticating the user for Export/Import.

The following operations are supported:

Folders

  • Find/Retrieve folder by site and path (folder)
  • Delete a folder under root of site by site and path
  • Create or update folder under root of site by site and path

Assets

  • Find/Retrieve a binary asset by path (folder)
  • Create a binary asset by uploading the binary file by path (folder)
  • Find/Retrieve asset metadata by path (folder)
  • Create or update a non-binary asset by path (folder)
  • Delete an asset by path (folder) 

Further explanation of examples of the Asset API can be found on  Using the Asset REST API

Pages

  • Find page by site, path (folder), and pagename 
  • Create or update page by site, path (folder), and pagename
  • Delete page site, path (folder), and pagename

Leave a comment

*
*