Skip to Main Content
Return to Navigation

Understanding REST Service Operations

This section discusses:

REST Service Operations

A REST service operation definition consists of general information about an operation, such as its name, description, request and response messages, and so on.

REST services operations are synchronous service operations.

Like a non-REST service operations, a REST service operation contain a routing, which determines the direction, inbound or outbound, of the service operation.

For a provider REST service operation the system creates an any-to-local routing definition when you save the service operation. You have the option to generate a local-to-local routing definition. For consumer REST service operations the system creates an outbound local-toWADL routing definition when you save the service operation. You cannot add routing definitions to provider or consumer REST service operations.

A REST service operation definition also contains a handler, which contains and runs the programming logic for providing or consuming the service operation, manipulating message content, and so on.

REST Service Operations Types

All REST service operations are synchronous service operations.

A synchronous service operations is processed in real time. Processing on the sending system does not continue until it receives a response from the receiving system.

REST Methods

REST methods determine the HTTP method for manipulating the resources defined in the service operation. The valid values are listed and described in the following table and can all be used for provider and consumer service operations:

REST Resource Definitions

REST service operation definitions contain a REST Resource Definition section where you define the REST base URL, resource URI templates, URI indexes, and document template. These components are discussed in greater detail elsewhere in the product documentation.

REST Messages

This section provides information about request and response messages used in REST service operations.

Request and Response Message Combinations

The REST method you select for a REST service operation determines the request and response message combination that you can use for the operation. The following table lists the allowable request and response message combinations for each REST method:

REST Method

Request Message

Response Message

Delete

Optional.

Optional.

Get

Optional.

Optional.

Head

No.

Optional.

Post

No.

Yes.

Put

No.

No.

MIME Content-Types

When you specify a request or response message for a REST service operation, must also specify the MIME content-type of the message. PeopleSoft supports the following content types for request and response messages used for REST service operations:

  • application/json

  • application/xml

  • text/xml

  • text/plain

  • text/html

Naming Conventions for REST Service Operation Metadata

The same naming convention restrictions that apply to non-REST service operations apply to REST service operations.

See Naming Conventions for Service Operation Metadata.

REST Service Operation Aliases

A service operation alias or operation alias is the service operation name that displays for the service operation when WADL is provided.

REST service operation aliases may be mixed case.

Service operation alias names for REST service operations can be the same across types. For example, you can have the same alias, for example MY_ALIAS, for Delete, Get, Put, Post and Head REST service operations.

REST Service Operation Versions

The same information about non-REST service operation versions applies to REST service operation versions.

See Service Operation Versions.

WADL Node

PeopleTools delivers a WADL node that is the default node for consumer REST services.

Monitoring REST Service Operations

You can use the same tools to monitor REST service operations as those you use to monitor non-REST service operations. These tools include:

  • The Service Operations Monitor.

  • The Integration Network Monitor.

  • The Integration Network Transactional Tracker.

  • Performance monitoring tools.

The Managing Service Operations topic in the product documentation provides a brief summary of each of these tools.

See Monitoring Service Operations.

You can also find complete documentation for these tools elsewhere in the product documentation.