Send Requests

Use the following guidelines when sending requests using the REST API for Managing Issues in Oracle Developer Cloud Service.

URL Structure

Access the Oracle Developer Cloud Service REST resources using the following URL structure:

https://<host-url/<org-id>/rest/<project-id>/<resource-path>

Where:

• <host-url> – Host where Oracle Developer Cloud Service is running. This URL usually includes a prefix that includes a service abbreviation and a region designator, followed by oraclecloud.com. If you are unsure of your host name, locate Oracle Developer Service Cloud in the My Services console, click Details, and look at the REST Endpoint value.

  The Service URL listed in the welcome email you receive with your trial or purchased subscription also contains this host.

  The examples in this document use developer.us.oraclecloud.com for your host system.

• <org-id> – Organization identifier that equates to the group in which you work.

• <project-id> – Project identifier that identifies the Oracle Developer Cloud Service project with which the issues are associated. The project identifier can be located in the SSH and Maven URLs that are displayed on the right side of the Main page in Oracle Developer Cloud Service.

• <resource-path> – Relative path that defines the resource. issues/v2/issues and issues/v2/repository are the fixed prefixes for Oracle Developer Cloud Service REST resources. For a complete list of resources, see REST Endpoints

Supported Methods

You can perform basic CRUD operations (create, read, and update) on issues and repository data in Oracle Developer Cloud Service using standard HTTP method requests, as summarized in the following table.

HTTP Method	Description
GET	Retrieve information about issues and repository data in Oracle Developer Cloud Service.
POST	Create a new issue in Oracle Developer Cloud Service.
PUT	Update an existing issue in Oracle Developer Cloud Service.

Media Types

The application/json media type is supported by the REST API for Managing Issues in Oracle Developer Cloud Service.

Supported Headers

The Oracle Developer Cloud Service REST API supports the following headers that may be passed in the header section of the HTTP request or response.

Header	Description	Example
Content-Type	Media type of the body of the request. Required for POST and PUT requests.	Content-Type: application/json
Accept	List of acceptable encodings to support compression.	Accept: application/json