REST API and content associations | HCL Digital Experience

Based on the Representational State Transfer (REST) architecture, the APIs represent information about content associations as Atom feeds. To perform actions, you send HTTP requests to specific URLs.

Retrieve all content associations

URL

http://hostname:port/context_root/mypoc?uri=contentmapping:objecttype:CONTENT_NODE&mode=download

HTTP method

GET

Links

Link information is provided for each entry in the Atom feed, as identified by the rel attribute.

Table 1. Link information in the Atom feed for retrieving content associations

Link	Description
rel="self"	Link to this Atom entry.
rel="edit"	Link to this item that can be used for POST, PUT, and DELETE operations.
rel="related"	Link that can be used to view the web content page with which the content association is associated.
rel="first"	Link to the first feed fragment. This link is only served if a feed fragment was served.
rel="last"	Link to the last feed fragment. This link is only served if a feed fragment was served.
rel="previous"	Link to the feed fragment preceding the current feed fragment. This link is only served if a feed fragment was served that does not start at the beginning of the feed.
rel="next"	Link to the next feed fragment. This link is only served if a feed fragment was served that does not contain the last entry of the feed.

Supported URL parameters

Table 2. Supported parameters for requests to retrieve content associations

Parameter	Description
start-index	Identifies the start index of the feed fragment to be served. The default value is 0.
max-results	Identifies the maximum number of entries to be served by this request, as determined by the configuration of the server.

Retrieve content associations for a specific web content page

URL

The web content page is identified either by its object ID or by its unique name.

http://hostname:port/context_root/mypoc?uri=contentmapping:oid:serialized_object_id

http://hostname:port/context_root/mypoc?uri=contentmapping:oid:unique_name

HTTP method

GET

Links

Link information is provided for each entry in the Atom feed, as identified by the rel attribute.

Table 3. Link information in the Atom feed for retrieving content associations for a specific web content page

Link	Description
rel="self"	Link to this Atom entry.
rel="edit"	Link to this item that can be used for POST, PUT, and DELETE operations.
rel="related"	Link that can be used to view the web content page with which the content association is associated.

Modify content associations

URL

The web content page is identified either by its object ID or by its unique name.

http://hostname:port/context_root/mypoc?uri=contentmapping:oid:serialized_object_id

http://hostname:port/context_root/mypoc?uri=contentmapping:oid:unique_name

HTTP method

PUT

Links

Link information is provided for each entry in the Atom feed, as identified by the rel attribute.

Table 4. Link information in the Atom feed for modifying content associations

Link	Description
rel="self"	Link to this Atom entry.
rel="edit"	Link to this item that can be used for POST, PUT, and DELETE operations.
rel="related"	Link that can be used to view the web content page with which the content association is associated.

Supported URL parameters

Table 5. Supported parameters for requests for modifying content associations

Parameters

Description

update

The following values are supported for the update parameter: merge This mode merges the content associations in the request with the content associations on the server. The request updates existing content associations and adds new content associations, but the request does not delete other content associations already on the server. replace This mode replaces all current content associations on the server with the content associations specified in the request. The request updates existing content associations, adds new content associations, and deletes other content associations on the server that are not represented in the request. delete This mode deletes the content association specified in the request from the web content page.

Delete content associations

URL

The web content page is identified either by its object ID or by its unique name.

http://hostname:port/context_root/mypoc?uri=contentmapping:oid:serialized_object_id

http://hostname:port/context_root/mypoc?uri=contentmapping:oid:unique_name

HTTP method

DELETE

Supported URL parameters

Table 6. Supported parameters for requests for deleting content associations for a web content page

Parameters	Description
content	Indicates the content associations to be deleted. If the content parameter is not specified, all content associations for the web content page are deleted. If the content ID for a content item is specified as the value of the content parameter, only one content association is deleted. The content association deleted is the one that maps the web content page to the specified content item. Any other content associations are unaffected.