Send Requests

Use the following guidelines when sending requests using the Oracle Messaging Cloud Service REST API.

URL Structure

Access the Oracle Messaging Cloud Service REST resources using the following URL structure:
https://{api_endpoint}/{resource_base}/{resource_path}
Where:
  • api_endpoint is the REST endpoint URL that you received when you subscribed to the service. For example, https://messaging.dataCenter.oraclecloud.com

  • resource_base is the base URI of the resource:

    /service name-identity domain name/api

  • resource_path is the path of a specific resource. For example, /v1/queues

Supported Methods

Oracle Messaging Cloud Service uses standard HTTP method requests, as summarized in the following table.

HTTP Method Description
GET Retrieves information about the object specified in the request URI.
POST Updates an object by using the data in the parameters, headers, and request body.
PUT Creates an object by using the data in the parameters, headers, and request body.
DELETE Deletes the object specified in the request URI.

Supported Headers

For a list of the headers that you can pass with a specific HTTP request, see the section that describes that request method.

Also, message headers and properties are treated as HTTP headers when messages are sent and received through the REST API. For more information, see Message Headers and Properties.