IMPORTANT: As we revamp and transition our documentation to this site, you may find the articles you need on Liferay's Help Center.

Analytics Cloud Commerce Courses DXP / Portal DXP Cloud Reference

Documentation Menu

Highlighting

Remove Highlighting

Go Back

• Getting Started
• Site Building
• Content Authoring and Management
• Process Automation
• Using Search
• Collaboration and Social
  • Collaboration and Social Overview
  • Message Boards
  • Notifications and Requests
  • Social Tools
  • Wiki
    • Getting Started with Wikis
    • Creating Wiki Pages
    • Creating a Node
    • Exporting and Importing a Wiki
    • Using the Page Menu Widget
    • Using the Tree Menu Widget
    • Using the Wiki Display Widget
    • Scoping Your Wikis
    • Wiki Permissions Reference
    • Wiki Widget UI Reference
    • Developer Guide
      • Wiki API Basics
  • Questions
  • Alerts and Announcements
  • Inviting Members to Your Site
  • Knowledge Base
• Users and Permissions
• System Administration
• Building Applications
• Liferay Internals
• Headless Delivery
• Installation and Upgrades

English

• Japanese
• English

• Liferay Learn
• DXP
• Collaboration and Social
• Wiki
• Developer Guide
• Wiki API Basics

Wiki API Basics

Liferay’s Headless Delivery application provides REST services for the Wiki application. With these services, you can add Wiki nodes and pages, list their information, modify their content, or remove them altogether. Here you’ll call those services using cURL commands and Java classes.

Preparing Tutorial Resources

Before proceeding with the tutorial, first set up a clean Liferay Docker container and prepare the provided tutorial code for use.

Liferay Docker Container

Start a new Liferay instance by running

docker run -it -m 8g -p 8080:8080 liferay/portal:7.4.3.22-ga22

Sign in to Liferay at http://localhost:8080. Use the email address test@liferay.com and the password test. When prompted, change the password to learn.

Once started, retrieve the Site ID. To find your Site ID, open the Site Menu (), and go to Configuration → Site Settings → Site Configuration.

Tutorial Code

This tutorial provides sample code to demonstrate the Headless API. This code includes both sample cURL and Java files for use throughout the tutorial.

Run the following command to download and unzip the sample code:

curl https://learn.liferay.com/dxp/latest/en/collaboration-and-social/wiki/developer-guide/liferay-q8u2.zip -O

unzip liferay-q8u2.zip

While the cURL scripts come ready for use, you must manually compile the Java source files before you can run them. To do this, go to the project’s java folder, and run the javac command.

cd liferay-q8u2/java

javac -classpath .:* *.java

Note that the project includes the com.liferay.headless.delivery.client.jar file as a dependency. You can find client JAR dependency information for all REST applications in the API explorer in your installation at /o/api.

Using WikiNode and WikiPage Headless APIs

The sample code includes cURL scripts and Java classes that call the following APIs.

Service	HTTP Method	HTTP Endpoint	Java Method	Description
WikiNode	POST	/v1.0/sites/{siteId}/wiki-nodes	postSiteWikiNode	Creates a new Wiki node in the specified Site using the details provided in the API call
WikiNode	GET	/v1.0/sites/{siteId}/wiki-nodes	getSiteWikiNodesPage	Returns a complete list of all Wiki nodes in the specified Site; results can be paginated, filtered, searched, and sorted
WikiNode	GET	/v1.0/wiki-nodes/{wikiNodeId}	getWikiNode	Returns details for the specified node entity
WikiNode	PUT	/v1.0/wiki-nodes/{wikiNodeId}	putWikiNode	Replaces the specified node’s details with those provided in the API call
WikiNode	DELETE	​/v1.0​/wiki-nodes​/{wikiNodeId}	deleteWikiNode	Deletes the specified node and returns a 204 if the operation succeeds
WikiPage	POST	/v1.0/wiki-nodes/{wikiNodeId}/wiki-pages	postWikiNodeWikiPage	Creates a new Wiki page in the specified node using the details provided in the API call
WikiPage	POST	/v1.0/wiki-pages/{parentWikiPageId}/wiki-pages	postWikiPageWikiPage	Creates a new Wiki child page for the specified Wiki page using the details provided in the API call.
WikiPage	GET	/v1.0/wiki-nodes/{wikiNodeId}/wiki-pages	getWikiNodeWikiPagesPage	Returns a complete list of all Wiki pages added to the specified Wiki node; results can be paginated, filtered, searched, and sorted
WikiPage	GET	/v1.0/wiki-pages/{parentWikiPageId}/wiki-pages	getWikiPageWikiPagesPage	Returns a complete list of all Wiki child pages added to the specified Wiki page; results can be paginated, filtered, searched, and sorted
WikiPage	GET	/v1.0/wiki-pages/{wikiPageId}	getWikiPage	Returns details for the specified Wiki page entity
WikiPage	PUT	/v1.0/wiki-pages/{wikiPageId}	putWikiPage	Replaces the specified page’s details with those provided in the API call
WikiPage	DELETE	/v1.0/wiki-pages/{wikiPageId}	deleteWikiPage	Deletes the specified page and returns a 204 if the operation succeeds

Important

When using POST and PUT methods for Wiki pages, you must define both the headline and encodingFormat fields. The headline field sets the page’s main title, while the encodingFormat field determines the page’s media format (e.g., HTML, BBCode, etc.).

Calling the WikiNode APIs

In this exercise, you can use either the cURL commands or Java classes to call the WikiNode APIs. The following output examples correspond to the cURL command, which slightly differs from the output for the provided Java classes.

1. Navigate to the curl or java folder in the liferay-q8u2 project.

   For cURL:

   cd liferay-q8u2/curl
   

   For Java:

   cd liferay-q8u2/java
   

2. Execute the WikiNode_POST_ToSite shell script or Java class using your Site ID as a parameter. This creates a new Wiki node in the specified Site.

   For cURL:

   ./WikiNode_POST_ToSite.sh {site-id}
   

   For Java:

   java -classpath .:* -DsiteId={site-id} WikiNode_POST_ToSite
   

   The terminal displays the complete schema for the newly created Wiki node. The provided API calls only define the description and name fields for the new node, though you should copy the node’s ID for use with the following GET, PUT, and DELETE methods.

   {
     ...
     "description" : "Foo",
     ...
     "id" : 38405,
     "name" : "Able Node",
     ...
   }
   

3. Execute the WikiNodes_GET_FromSite shell script or Java class using the Site ID for its parameter. This returns a list of all Wiki nodes in the specified Site.

   For cURL:

   ./WikiNodes_GET_FromSite.sh {site-id}
   

   For Java:

   java -classpath .:* -DsiteId={site-id} WikiNodes_GET_FromSite
   

   Note

   All DXP/Portal instances come with a default Wiki node called Main. This node is shown in the above output, along with any nodes you’ve created.

4. Execute the WikiNode_PUT_ById shell script or Java class using the Wiki node ID for its parameter. This replaces the details of the specified Wiki node with the details provided in the API call.

   For cURL:

   ./WikiNode_PUT_ById.sh {wiki-node-id}
   

   For Java:

   java -classpath .:* -DwikiNodeId={wiki-node-id} WikiNode_PUT_ById
   

   {
     ...
     "description" : "Bar",
     ...
     "id" : 38405,
     "name" : "Baker Node",
     ...
   }
   

5. Execute the WikiNode_DELETE_ById shell script or Java class using the Wiki node ID for its parameter. This deletes the specified node.

   For cURL:

   ./WikiNode_DELETE_ById.sh {wiki-node-id}
   

   For Java:

   java -classpath .:* -DwikiNodeId={wiki-node-id} WikiNode_DELETE_ById
   

6. Execute the WikiNode_GET_ById shell script or Java class using the previous Wiki node ID for its parameter. This returns the details for the specified node if it exists.

   For cURL:

   ./WikiNode_GET_ById.sh {wiki-node-id}
   

   For Java:

   java -classpath .:* -DwikiNodeId={wiki-node-id} WikiNode_GET_ById
   

   Since you deleted the node in the preceding step, it returns the following message.

   {
     "status" : "NOT_FOUND",
     "title" : "No WikiNode exists with the primary key 38405"
   }
   

Calling the WikiPage APIs

You can use either the cURL commands or Java classes to call the WikiPage APIs. The following output examples correspond to the cURL command, which differs from the Java classes output.

1. Navigate to the curl or java folder in the liferay-q8u2 project.

   For cURL:

   cd liferay-q8u2/curl
   

   For Java:

   cd liferay-q8u2/java
   

2. Execute the WikiNode_POST_ToSite shell script or Java class to create a node for your Wiki page.

   For cURL:

   ./WikiNode_POST_ToSite.sh {site-id}
   

   For Java:

   java -classpath .:* -DsiteId={site-id} WikiNode_POST_ToSite
   

   Note

   Since Wiki pages are stored in Wiki nodes, at least one node must exist before you can create any Wiki pages.

3. Copy the node’s ID from the output for use with the WikiPage_POST_ToNode call.

   {
     ...
     "description" : "Foo",
     ...
     "id" : 38504,
     "name" : "Able Node",
     ...
   }
   

4. Execute the WikiPage_POST_ToNode shell script or Java class using the above node ID for its parameter. This creates a new Wiki page for the specified node.

   For cURL:

   ./WikiPage_POST_ToNode.sh {wiki-node-id}
   

   For Java:

   java -classpath .:* -DwikiNodeId={wiki-node-id} WikiPage_POST_ToNode
   

5. Copy the page’s ID for use with the WikiPage_POST_ToParent call.

   {
     ...
     "content" : "Foo",
     ...
     "description" : "Able Page",
     "encodingFormat" : "text/x-wiki",
     ...
     "headline" : "Able Page",
     "id" : 38506,
     ...
   }
   

6. Execute the WikiPage_POST_ToParent shell script or Java class using the above Wiki page ID for its parameter. This creates a child page for the specified Wiki page.

   For cURL:

   ./WikiPage_POST_ToNode.sh {wiki-page-id}
   

   For Java:

   java -classpath .:* -DparentWikiPageId={wiki-page-id} WikiPage_POST_ToParent
   

   {
      ...
      "content" : "Foo",
      ...
      "description" : "Charlie Page",
      "encodingFormat" : "text/x-wiki",
      ...
      "headline" : "Charlie Page",
      "id" : 38510,
      ...
   }
   

7. Execute the WikiPages_GET_FromNode shell script or Java class using the Wiki node ID for its parameter. This returns a list of all Wiki pages added to the specified node, which includes both of the newly created Wiki pages.

   For cURL:

   ./WikiPages_GET_FromNode.sh {wiki-node-id}
   

   For Java:

   java -classpath .:* -DwikiNodeId={wiki-node-id} WikiPages_GET_FromNode
   

8. Execute the WikiPages_GET_FromParent shell script or Java class using the Wiki parent page ID for its parameter. This returns any existing child pages for the specified Wiki page.

   For cURL:

   ./WikiPages_GET_FromParent.sh {wiki-page-id}
   

   For Java:

   java -classpath .:* -DparentWikiPageId={wiki-page-id} WikiPages_GET_FromParent
   

9. Execute the WikiPage_PUT_ById shell script or Java class using either of the above Wiki page IDs for its parameter. This replaces the original page’s content with the content defined in the API call.

   For cURL:

   ./WikiPage_PUT_ById.sh {wiki-page-id}
   

   For Java:

   java -classpath .:* -DwikiPageId={wiki-page-id} WikiPage_PUT_ById
   

   {
     "content" : "Bar",
     ...
     "encodingFormat" : "text/x-wiki",
     ...
     "headline": "Baker Page",
     "id" : 38515,
     ...
   }
   

10. Execute the WikiPage_DELETE_ById shell script or Java class using the desired Wiki page ID for its parameter. This deletes the specified Wiki page.

    For cURL:

    ./WikiPage_DELETE_ById.sh {wiki-page-id}
    

    For Java:

    java -classpath .:* -DwikiPageId={wiki-page-id} WikiPage_DELETE_ById
    

11. Execute the WikiPage_GET_ById shell script or Java class using the deleted Wiki page’s ID for its parameter. This returns the details for the specified page if it exists.

    For cURL:

    ./WikiPage_GET_ById.sh {wiki-page-id}
    

    For Java:

    java -classpath .:* -DwikiPageId={wiki-page-id} WikiPage_GET_ById
    

    Since the page was deleted in the preceding step, you see the following message.

    {
      "status" : "NOT_FOUND",
      "title" : "No WikiNode exists with the primary key 38515"
    }
    

Examining the Sample cURL Scripts

The following are representative examples of the tutorial’s cURL commands.

WikiNode_POST_ToSite.sh

curl \
	-H 'Content-Type: application/json' \
	-X 'POST' "http://localhost:8080/o/headless-delivery/v1.0/sites/${1}/wiki-nodes" \
	-d "{\"description\": \"Foo\", \"name\": \"Able Node\"}" \
	-u "[email protected]:learn"

WikiPage_POST_ToNode.sh

curl \
	-H 'Content-Type: application/json' \
	-X 'POST' "http://localhost:8080/o/headless-delivery/v1.0/wiki-nodes/${1}/wiki-pages" \
	-d "{\"content\": \"Foo\", \"encodingFormat\": \"text/x-wiki\", \"headline\": \"Able Page\"}" \
	-u "[email protected]:learn"

WikiPages_GET_FromNode.sh

curl \
	"http://localhost:8080/o/headless-delivery/v1.0/wiki-nodes/${1}/wiki-pages" \
	-u "[email protected]:learn"

Examining the Sample Java Classes

The following are representative examples of the tutorial’s Java commands.

WikiNode_POST_ToSite.java

ublic class WikiNode_POST_ToSite {

/**
 * java -classpath .:* -DsiteId=1234 WikiNode_POST_ToSite
 */
public static void main(String[] args) throws Exception {
	WikiNodeResource.Builder builder = WikiNodeResource.builder();

	WikiNodeResource wikiNodeResource = builder.authentication(
		"[email protected]", "learn"
	).build();

	WikiNode wikiNode = wikiNodeResource.postSiteWikiNode(
		Long.valueOf(System.getProperty("siteId")),
		new WikiNode() {
			{
				description = "Foo";
				name = "Dog Node";
			}
		});

	System.out.println(wikiNode);
}

WikiPage_POST_ToNode.java

ublic class WikiPage_POST_ToNode {

/**
 * java -classpath .:* -DwikiNodeId=1234 WikiPage_POST_ToNode
 */
public static void main(String[] args) throws Exception {
	WikiPageResource.Builder builder = WikiPageResource.builder();

	WikiPageResource wikiPageResource = builder.authentication(
		"[email protected]", "learn"
	).build();

	WikiPage wikiPage = wikiPageResource.postWikiNodeWikiPage(
		Long.valueOf(System.getProperty("wikiNodeId")),
		new WikiPage() {
			{
				content = "Foo";
				encodingFormat = "text/x-wiki";
				headline = "Dog Page";
			}
		});

	System.out.println(wikiPage);
}

WikiPages_GET_FromNode.java

ublic class WikiPages_GET_FromNode {

/**
 * java -classpath .:* -DwikiNodeId=1234 WikiPages_GET_FromNode
 */
public static void main(String[] args) throws Exception {
	WikiPageResource.Builder builder = WikiPageResource.builder();

	WikiPageResource wikiPageResource = builder.authentication(
		"[email protected]", "learn"
	).build();

	Page<WikiPage> page = wikiPageResource.getWikiNodeWikiPagesPage(
		Long.valueOf(System.getProperty("wikiNodeId")), null, null, null,
		Pagination.of(1, 2), null);

	System.out.println(page);
}

Additional Information

• Using Liferay as a Headless Platform

• Consuming Rest Services

Not finding what you're looking for?

Pardon our dust as we revamp and transition our product documentation to this site. If something seems missing, please check Liferay Help Center documentation for Liferay DXP 7.2 and previous versions.

Try Liferay's Help Center