Table of Contents

Generate a complete OpenAPI specification from REST service rules (8.4)

Automatically generate a complete and accurate OpenAPI Specification (OAS) by using REST Service rules. You can use the OAS to better understand how to use your REST API in your application.

With the following enhancements, you can produce a comprehensive description of your REST APIs:

  • Pega Platform uses relevant records to more clearly define the schema for page and page list outputs.
  • Map values to JSON or Clipboard in the request, or map values from JSON or Clipboard in the response.
  • Schema type definitions are more detailed and more accurately reflect the properties to which you mapped in the request or response.

The following figure shows an example of the OAS that you can generate by using the enhancements in a REST service rule:

OAS on the OpenAPI tab of a REST service rule.
OAS on the OpenAPI tab of a REST service rule.

REST service rules now support using an automation for the implementation method instead of an activity. Although creating automations is restricted in Pega Platform 8.4, you can take full advantage of this capability in an upcoming Pega Platform release.

For more information, see Creating a REST service.

Suggest Edit

Have a question? Get answers now.

Visit the Collaboration Center to ask questions, engage in discussions, share ideas, and help others.