cURL Access

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

To use cURL to access the Oracle GoldenGate 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 <ProductName> account.
    -X Indicates the type of request (for example, GET, POST, and so on).

For example:

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