cURL Access

The examples within this document use cURL to demonstrate how to access the REST API for Oracle Integration Cloud Service on Oracle Public Cloud Machine (ICS on OPCM).

To use cURL to access the REST API for ICS on OPCM:

  • Install cURL, as described in Quick Start.

  • In a command window, set the cURL environment variable, CURL_CA_BUNDLE, to the location of your local CA certificate bundle. For information about CA certificate verification using cURL, see: http://curl.haxx.se/docs/sslcerts.html.

  • Invoke cURL and specify one or more of the command-line options defined in the following table, as required, to direct its execution

    This table summarizes the cURL options used in the command examples.

    cURL Option

    Description

    -d, --data @file.json Identifies the request document, in JSON format, on the local machine.
    -F file=@path Identifies a file on the local machine. Use this option for import operations.
    -H, --header Defines the content type of the request document.
    -i Displays response header information.
    -o path Identifies the response output on the local machine. Use this option for export operations.
    -u, --user username:password Specifies the user name and password for the ICS on OPCM account.
    -X, --request Indicates the type of request (for example, GET, POST, and so on).
The following example cURL command exports an integration:
curl -u jstein:welcome1
 -X GET
 -o ./TestProject.iar
 https://example.com/icsapis/v1/integrations/TEST/01.00.0000/export
The following example cURL command imports and adds an integration:
curl -u jstein:welcome1
 -H "Accept: application/json"
 -X POST
 -F "file=@TestProject.iar;type=application/octet-stream"
 https://example.com/icsapis/v1/integrations/import

Change example.com to the host in your Service URL as described in Send Requests.