Technical documentation - Signifikant Server Publisher REST API v4.x
To automate the import and publish process, you will need to use the Signifikant Server Publisher REST API. Here is a description of its functionality.
Version 4.5 and earlier
This article descripes the API in version 4.5 and earlier.
Methods exposed by the Signifikant REST Publisher API
The publisher REST API exposes the following methods: Transform, Import and Publish. For each method, it is possible to checkout the status. The base url's for these methods are:
- http://<servername>/AssertServer/api/Publisher/Transform/<directoryname>/<languagecode>/<sitename>
- http://<servername>/AssertServer/api/Publisher/Status/<directoryname>/Transform/<languagecode>
- http://<servername>/AssertServer/api/Publisher/Import/<sitename>/<directoryname>/<languagecode>
- http://<servername>/AssertServer/api/Publisher/Status/<sitename>/Import/<directoryname>
- http://<servername>/AssertServer/api/Publisher/Publish/<sitename>/<publicationlabel>
- http://<servername>/AssertServer/api/Publisher/Status/<sitename>/Publish/<publicationlabel>
Where:
- servername = host name or ip address of the server running AssertServer web application
directoryname = name of the directory that is placed in the Export directory that contains the xml import files
sitename = name of the site as it is registered within the editorial environment (Signifikant Server and/or Manager)
publicationlabel = label of the publication object that, defined in Signifikant Manager
languagecode: language code, e.g. en-US, for the imported information.
Publication label
Publication label is set in the Manager. This way it is possible to predefine several publications that can be triggered using APIs.
Call the Signifikant Publisher REST API using a simple Web GUI
The Signifikant Web Viewer exposes a simple web GUI that can help you to call the above methods. It will also be useful to create valid url's that you then can use in your own application:
- http://<servername>/AssertServer/PublisherView.cshtml
Retrieve information on which sites are deployed on editor and web environment
If you want to see which sites are registered within the editorial environment, you can use the following method:
http://<servername>/AssertServer/Service.cshtml
If you want to see which sites are registered with the web environment, you can use the following link:
- http://<servername>/AssertWeb/en/<sitename>/WebAdmin
User: adminserver
Password: adminserverp
Select "Site information"
Fully automated workflow
The way these REST API's are used is as follows in a fully automated environment:
- The external system creates an export file and drops it in the designated Export folder with directory name "xyz"
- The external system calls Signifikant Publisher REST API to transform the files in directory "xyz" and save the result in the Import folder
- The external system calls status method to see if transformation is finished. Waits until it is finished.
- The external system calls Signifikant Publisher REST API to import the files from Import folder to the designated site.
- The external system calls status method to see if import is finished. Waits until it is finished.
- The external system calls Signifikant Publisher REST API to publish the designated catalogue of the site to the web environment.
Related articles