Use cURL

The examples within this document use cURL to demonstrate how to access the OAM OAuth REST API.

To use cURL to access the Oracle Access Management REST APIs:

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

    Note:

    See Authentication for more information about authentication requirements.

  • 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 @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 a request header.

-i

Displays response header information.

-X

Indicates the HTTP request method DELETE, GET, POST, PATCH, or PUT). If this option is omitted, the default is GET.

For example:

curl -i -X GET -u <username>:<password> -H <request-header>:<value> https://<subdomain>.<domain>.com/<path>/<resource-path>

For detailed information cURL, refer to the following URL:

https://curl.haxx.se/docs/manpage.html