Quick Start

Set up your environment for using Oracle Messaging Cloud Service by performing the following tasks.

Step 1: Subscribe to the Service

Obtain a trial or paid subscription to Oracle Messaging Cloud Service. See How to Begin with Oracle Messaging Cloud Service Subscriptions in Using Oracle Messaging Cloud Service.

Step 2: Get the Required Roles Assigned

Two default account roles are created during provisioning:

• Messaging Administrator

• Messaging Worker

When the service instance is created during provisioning, the service administrator is given both Messaging Administrator and Messaging Worker roles. The account administrator can create more messaging administrators, messaging workers, or users with both roles, by assigning the appropriate role to users.

For more information, see About Oracle Messaging Cloud Service Roles and Users in Using Oracle Messaging Cloud Service.

Step 3: Install cURL

You can access the REST API from any application or programming platform that correctly and completely understands the Hypertext Transfer Protocol (HTTP) and has Internet connectivity. The REST API uses advanced facets of HTTP such as secure communication over HTTPS, HTTP headers, and specialized HTTP methods (PUT, DELETE).

cURL is a command-line tool that you can use to invoke REST API calls by sending HTTP requests. The examples in this document use the cURL command-line tool to demonstrate how to access the Oracle Messaging Cloud Service REST API.

cURL is typically available by default on most UNIX-like hosts. For the instructions to install cURL on Windows, see Installing the cURL Command-Line Tool on Windows.

Note:

Certain web browsers can also be used to send REST API calls. Support varies across vendors. Browser plugins may be needed for full support.

Step 4: Understand the Format of Resource URLs

See Send Requests.

You are now ready to start interacting with the REST API of Oracle Messaging Cloud Service.