cURL Overview

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

To use cURL to access the Oracle Prime REST API:

  • Install cURL, as described in Using cURL.
  • Invoke cURL and specify one or more of the command-line options described in this table.

This table summarizes the cURL options used in the command examples.

cURL Option Description
-d

Identifies the request document, in JSON format, on the local machine. For example:

-d @mydatafile.json

-F

Identifies form data, in JSON format, on the local machine. For example:

-F @myformdatafile.json

-H

Defines one or both of the following:

  • Content-Type: Media type of the body of the request
  • Accept: Media type of the body of the request
-i Displays response header information.
-u

Specifies the username and password for the Oracle Prime account. For example:

-u jsmith:mypassword1

-X

Indicates the type of request. For example:

-X DELETE

For example:

curl --u <username><password> -H "<request-header>:<value>" -X GET 
      http://<hostName>:<portNumber>/primeapi/restapi/v<release level>/<service>

To fetch a project object by its project ID:

curl --u jsmith:mypassword1 -H "Accept:application/json" -X GET
http://<server>:<port>/primeapi/restapi/v16.2/project/{id}