Use cURL

The examples within this document use cURL to demonstrate how to access the OAM Password Management 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