SiteVision provides a built-in Model REST API that operates on the JCR data tree model that is also accessible via the SiteVision Public API. The authentication and permissions that are required to access the data via the REST API is exactly the same as it is in the SiteVision editor and via the Public API.
The Model REST API is bundled with all SiteVision installations, but it must be explicitly activated on the website. The Model REST API can be activated under the site settings in the SiteVision editor.
Enabling the REST API also exposes the REST API documentation to all users that has the DEVELOPER permission!
Be sure to log on to the website and ensure your user has the DEVELOPER permission. The REST API documentation for your REST API-enabled website is available at:
<protocol> :// <domain> / rest-api / doc
When you enter the REST API documentation you see the Nodes view. The JCR Model tree can be browsed via the links in the left menu. All available Methods/Operations will be displayed for each Node you navigate to.
When you have browsed to a Node in the JCR Model tree and selected a Method/Operation, its documentation is displayed. The documentation specifies the supported http verbs (GET, POST, PUT, DELETE) and the data requirements. It often also gives an example of input data and the corresponding JSON result.
Each node and endpoint has two different URLs that can be used.
Always use the identifier-based URL whenever possible!
The Identifier-based URL is significantly faster than the path-based URL and it is also safer since it guarantees there will never be a name collision!
The pattern of a REST API URL is:
<protocol> :// <domain> / rest-api / <rest api version> / <model version> / <path | identifier> / <method>
The <model version> should typically be 1 ("online") in a REST URL when used externally!
Site visitors always use/view the "online" model version (1). SiteVision editors that are editing use/view the "offline" version (0). External invokers of the REST API should typically behave as typical site visitors, i.e. use the "online" model version (1).
The REST API Console can be used to test invocations of REST API endpoints.