Magnolia 5.6 reached end of life on June 25, 2020. This branch is no longer supported, see End-of-life policy.
This page explains the delivery endpoint, which can be used to obtain JCR data as JSON.
The endpoint provides two REST resources - readNode
and queryNodes
- both must be called with HTTP GET.
The delivery endpoint must be configured via YAML. Its next version will allow multiple named configurations which can be distinguished by URL path parameter.
readNode
Returns a node including its properties and child nodes down to a certain depth.
..
..
...
queryNodes
..
The delivery endpoint requires a YAML configuration - otherwise it cannot deliver cannot. Add the configuration to the folder your-light-module/restEndpoints/
.
class: info.magnolia.rest.delivery.jcr.JcrDeliveryEndpointDefinition implementationClass: info.magnolia.rest.delivery.jcr.v1.JcrDeliveryEndpoint params: website: depth: 3 includeSystemProperties: false nodeTypes: - mgnl:page - mgnl:area - mgnl:component rootPath: / limit: 10 bypassWorkspaceAcls: true dam: depth: 1 includeSystemProperties: false nodeTypes: - mgnl:asset - mgnl:folder rootPath: / limit: 10 bypassWorkspaceAcls: false
Properties:
class | required Must be info.magnolia.rest.delivery.jcr.JcrDeliveryEndpointDefinition or a subclass. |
implementationClass | required Must be info.magnolia.rest.delivery.jcr.v1.JcrDeliveryEndpoint or a subclass. |
params | required The map defining at least one ore more workspace parameters. |
| required The name of the JCR workspace to deliver content from. |
| optional (default=0) The depth of subnodes to shwo in the result |
| optional (default=true) Whether the result should show the system properties. |
| required The root path of this endpoint. Path information when requesting the endpoint is added to this path. |
| optional (default=false) When set to true JCR security is bypassed. Use with care and for development reasons only! |
| optional (default=10) The number of nodes (of level 1) in the result. Only working together with |
xx