Quick Start
Set up your environment and retrieve your first task list for Oracle Integration using the REST API by performing the following tasks.
Step 1: Obtain Account Information
-
User name and password for your Oracle Integration account.
-
The Service URL of your Oracle Integration instance, which is listed in the welcome e-mail you receive with your trial or purchased subscription.
Step 2: Install cURL
The examples within this document use the cURL command-line tool to demonstrate how to access the Oracle Integration REST API.
To connect securely to the server, you must install a version of cURL that supports SSL and provides an SSL certificate authority (CA) certificate file or bundle to authenticate against the Verisign CA certificate. For more information about:
-
Using cURL, see Use cURL.
-
Authentication, see Authentication.
-
In your browser, navigate to the cURL home page at http://curl.haxx.se and click Download in the left navigation menu.
-
On the cURL Releases and Downloads page, locate the SSL-enabled version of the cURL software that corresponds to your operating system, click the link to download the ZIP file, and install the software.
-
Navigate to the cURL CA Certs page at http://curl.haxx.se/docs/caextract.html and download the ca-bundle.crt SSL CA certificate bundle in the folder where you installed cURL.
-
Open a command window, navigate to the directory where you installed cURL, and set the cURL environment variable,
CURL_CA_BUNDLE
, to the location of an SSL certificate authority (CA) certificate bundle. For example:C:\curl> set CURL_CA_BUNDLE=ca-bundle.crt
You are now ready to send requests to the Oracle Integration REST API using cURL.
Step 3: Retrieve Your First Task List
Use a cURL command such as the following to retrieve a list of tasks assigned to you. Change example.com
to the host in your Service URL as described in Send Requests.
curl -H 'Authorization: Bearer eyJiO.eyJzdZ.tQ8_-9Jor5' -H "Content-Type:application/json" -H "Accept:application/json" -X GET https://example.com/ic/api/process/<version>/tasks
where, <version>
- REST API version. For example, 1.0. See Send Requests.