HCL Experience API

This documentation provides developers with documentation on how to provision, configure, and use the HCL Experience API with the HCL WebSphere Portal 9.5 platform.

Overview

The HCL Experience API is a set of OpenAPI-compliant REST APIs available for customers deploying HCL WebSphere Portal 9.5 containers on supported Kubernetes platforms. It supports the integration and management of HCL WebSphere Portal content and functionality to any digital channel using any front-end development framework. The HCL Experience API includes REST APIs that serve as a wrapper around previously published HCL WebSphere Portal HTTP-based APIs.

Reference the HCL WebSphere Portal 8.5 and 9.0 topics for additional information about previously published HCL WebSphere Portal APIs. Benefits of using HCL Experience API include:

• OpenAPI compliance
• GraphQL enabled

  Note: Use of GraphQL functions is available at a Beta level and not supported for production use.

• Simplified JSON payloads
• Enhanced API documentation

The HCL Experience API provides a simplified API to lower the burden for developers to work with it. It also has human-readable request and response payloads in JSON format for easy request construction. The HCL Experience API allows users to send and receive requests via OpenAPI-compliant interfaces. This API set accepts form-encoded request bodies made over HTTPS, and returns JSON-encoded responses using standard HTTP response codes and verbs. The HCL Experience API describes a high-level API through which the following specific APIs are exposed:

• HCL Ring API : Presents developer entry points to HCL Digital Experience 9.5 core platform capabilities which are divided into two main categories - Authorization APIs and Web Content APIs .
• HCL Digital Asset Management API : Presents developer entry points to the Digital Asset Management features of HCL WebSphere Portal 9.5.
• HCL Image Processor API : Presents developer entry points to the Digital Asset Management Image Processor functions of HCL WebSphere Portal 9.5.

Note: Future HCL WebSphere Portal 9.5 feature functionality will also be exposed through the HCL WebSphere Portal API.

HCL recommends that developers building solutions for HCL WebSphere Portal 9.5 running on Kubernetes programmatically use the HCL Experience API for the scenarios that are covered.

The HCL Experience API is a component of the HCL WebSphere Portal offerings. HCL Digital Experience offering license and download packages are provided with HCL Digital Experience entitlements available to customers on the HCL Software License Portal.

Installation instructions for HCL DX 9.5 image components may be viewed in the Container Deployment pages.

Detailed API listings for the HCL Experience API may be viewed at the HCL WebSphere Portal GitHub repository. Common Tasks:

• Prerequisites HCL Experience API requires software prerequisites to successfully run. The build package also includes this information, along with the installation and configuration steps.
• Configuration options HCL Experience API comes with a set of default configurations. The build package also includes this information, along with the installation steps.
• Getting started with HCL Experience API Follow the steps to get started with HCL Experience API.
• Example API calls To give users more insight on how to use Experience API, the following samples are provided.
• Sample Content UI Learn how to use the Sample Content UI application for HCL Experience API.