Send Requests

Use the following guidelines when sending requests using the Oracle Managed File Transfer Cloud Service REST API.

URL Structure

Access the Oracle Managed File Transfer Cloud Service REST resources using the following URL structure:
https://region-prefix.oraclecloud.com/paas/service/mftapp/rest/v1/resource-path
Where:
  • region-prefix: URL prefix based on region. Valid values include:
    • United States: jaas For example:https://jaas.oraclecloud.com/paas/service/mftapp/rest/v1/resource-path

    • EMEA (Europe, the Middle East, and Africa): jcs.emea For example: https://jcs.emea.oraclecloud.com/paas/service/mftapp/rest/v1/resource-path

  • resource-path: Relative path that defines the REST endpoint. For a complete list of REST endpoints, see All Rest Endpoints.

Supported Methods

You can perform the operations described in the following table using standard HTTP method requests.

HTTP Method Description
GET

Retrieve information about a resource.

POST

Create or update a resource.

Media Types

The following media types are supported by the Oracle Managed File Transfer Cloud Service REST API:

  • application/json

  • application/xml (requests only)

Supported Headers

The Oracle Managed File Transfer 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 Oracle Managed File Transfer Cloud Service instance, used for authentication.

X-ID-TENANT-NAME:ExampleIdentityDomain