Send Requests

Use these guidelines when sending requests using the Oracle Unified Directory Data Management REST API.

URL Structure

Here's the URL structure for the requests:

https://<subdomain>.<domain>.com:<port>/<resource-path>

Where:

• <subdomain.domain>.com:<port>: Host and port where Oracle Unified Directory is running.

• <resource-path>: Relative path that defines the resource.

Supported Methods

You can perform basic CRUD operations (create, read, update, and delete) on a resource by using standard HTTP method requests, as summarized in the following table.

HTTP Method	Description
GET	Retrieve information about one or more complete or partial resources.
POST	Creates new resources or creates search requests, depending on the endpoint.
PATCH	Modifies a resource with a set of client-specified changes (partial updates).
DELETE	Delete the resource.

Media Types

The following media types are supported by the Oracle Unified Directory Data Management REST API:

• application/json

Supported Headers

The Oracle Unified Directory Data Management REST API supports the following headers that may be passed in the header section of the HTTP request or response.

Header	Description	Example
Authorization	Authentication credentials for HTTP authentication.
Content-Type	Media type of the body of the request. Required for POST and PUT requests.	Content-Type: application/json
ResponseTime	The time in milliseconds to process the request.	ResponseTime: 1000