cURL Access

The examples within this document use cURL to demonstrate how to access the Developer API for Oracle Integration 3.

To use cURL to access the Developer API for Oracle Integration 3:

  • 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.

    cURL Option Description
    -d, --data '{"name":"value"}' -d, --data @file.json Identifies the request document, in JSON format, on the local machine.
    -F, --form @file.json Identifies form data, in JSON format, on the local machine.
    -H, --header Defines the content type of the request data.
    -i Displays response header information.
    -o path Identifies the response output on the local machine. Use this option for export operations and to save a response to a file.
    -H 'Authorization: Bearer access_token’ Specifies the access token for the Oracle Integration account. See Security, Authentication and Authorization.
    -X, --request Indicates the type of request (for example, GET, POST, and so on).
The following example cURL command posts a comment to the task with the ID 123456: 
curl -H 'Authorization: Bearer eyJiO.eyJzdZ.tQ8_-9Jor5'
 -H "Content-Type:application/json"
 -H "Accept: application/json"
 -X POST
 -d '{"commentStr":"add test Comment"}'
 https://example.com/ic/api/process/<version>/tasks/123456/comments

where, <version> - REST API version. See Send Requests.