cURL Access

The examples within this document use cURL to demonstrate how to access the Oracle Unified Directory REST API.

To use cURL to access the Oracle Unified Directory REST API:

  • 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 @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 Defines one or both of the following:
    • Content type of the request document

    • Custom header, X-ID-TENANT-NAME, to identify the identity domain

    -i Displays response header information.
    -u, --user username:password Specifies the user name and password for the Oracle Unified Directory account.
    -X Indicates the type of request (for example, GET, POST, and so on).

    Syntax:

    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:

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