cURL Access

The examples within this document use cURL to demonstrate how to access the REST API for Content Preview.

To use cURL to access the REST API for Content Preview:

  1. Install cURL, as described in Quick Start.

  2. When running cURL from a Windows command shell only, set the cURL environment variable, CURL_CA_BUNDLE, to the location of an SSL certificate authority (CA) certificate file or bundle to authenticate against the Verisign CA certificate. Alternatively, you can specify the location of your local CA certificate bundle on the command line, using the --cacert command-line option.

    You can download an SSL CA certificate bundle from http://curl.haxx.se/docs/caextract.html or provide your own. For information about CA certificate verification using cURL, see http://curl.haxx.se/docs/sslcerts.html.

  3. 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.
    -H 'Authorization: BearerToken' Specifies the Bearer Token for the Oracle Content Management account.
    -X Indicates the type of request (GET, POST, PUT, or DELETE).

For example:

curl -i -H 'Authorization: BearerToken' -X GET -H request-header:value https://subdomain.domain.com/path/resource-path

Where:

  • BearerToken is the Bearer Token for Oracle Content Management.

  • request-header:value is the request header.

  • hostname.com:port is the host and port where Oracle Content Management is running.

  • version is the version of the REST API. For example, v1.

  • resource-path is the relative path that defines the resource.