Send Requests

Review the following information before sending requests using the Oracle Data Integration Platform Cloud Service REST API.

URL Structure

Here's the URL structure for the requests:

https://<subdomain>.<domain>.com:<port>/<resource-path>
Where:
  • <subdomain.domain>.com:<port>: Host and port where Oracle Data Integration Platform Cloud Service is running.

  • <resource-path>: Relative path that defines the resource.

Supported Methods

Perform basic CRUD operations (create, read, update, and delete) on your Oracle Data Integration Platform Cloud Service using standard HTTP request methods.

Note:

You can combine multiple operations into a single HTTP request to improve performance. See Batch Actions.
HTTP Method Description
GET Retrieve information about the service instance.
HEAD Retrieve header information about the service instance.
POST Create, scale, backup, start, or stop the service instance.
PUT Update the service instance.
PATCH Patch the service instance.
OPTIONS Retrieve information about the options and requirements for the service instance.
DELETE Delete the service instance.

Media Types

The following media types are supported by the Oracle Data Integration Platform Cloud Service REST API:

  • application/json

Supported Headers

The Oracle Data Integration Platform Cloud Service REST API supports the following headers that may be passed in the header section of the HTTP request or response.

Header Description Example
Accept Media type of the body of the response. Accept application/json
Content-Type Media type of the body of the request. Required for POST and PUT requests. Content-Type: application/json
X-ID-TENANT-NAME Identity domain name of the <product name>, used for authentication. X-ID-TENANT-NAME:ExampleIdentityDomain