Quick Start

The REST API for Oracle® Session Delivery Management Cloud (Oracle SDM Cloud) allows a northbound client application, such as a network service orchestrator (NSO), to interact with Oracle® Session Delivery Management Cloud (Oracle SDM Cloud).

The examples within this document use cURL to demonstrate how to access the Oracle® Session Delivery Management Cloud (Oracle SDM Cloud) REST API. Prerequisite: Make sure cURL is installed on your machine. If it isn’t, follow the steps below to install it.

Step 1: Install cURL

The examples within this document use the cURL command-line tool to demonstrate how to access the Session Delivery Manager REST API.

To connect securely to the server, you must install a version of cURL that supports SSL and provide an SSL certificate authority (CA) certificate file or bundle to authenticate against the Verisign CA certificate.

The following procedure demonstrates how to install cURL on a Windows 64-bit system.

  1. In your browser, navigate to the cURL home page at https://curl.haxx.se and click Download in the left navigation menu.

  2. On the cURL Releases and Downloads page, locate the SSL-enabled version of the cURL software that corresponds to your operating system, click the link to download the ZIP file, and install the software.

  3. Navigate to the cURL CA Certs page at https://curl.haxx.se/docs/caextract.html and download the ca-bundle.crt SSL CA certificate bundle in the folder where you installed cURL.

  4. Open a command window, navigate to the directory where you installed cURL, and set the cURL environment variable, CURL_CA_BUNDLE, to the location of an SSL certificate authority (CA) certificate bundle. For example:

C:\curl> set CURL_CA_BUNDLE=ca-bundle.crt

For information about CA certificate verification using cURL, see https://curl.haxx.se/docs/sslcerts.html.

Step 2: Invoke cURL

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 file that contains the request body, in JSON format, on the local machine.
-H, --header Defines the request header in the format of HEADER: VALUE
-i Displays response header information.
-X, --request Indicates the HTTPS request method (DELETE, GET, POST, PATCH, or PUT). If this option is omitted, the default is GET.

For example:

curl -v -X GET \
    -H <request-header>:<value> \
    https://<subdomain>.<domain>.com/<path>/<resource-path>