Updated 2 May 2022
Oracle Autonomous Database is a Platform as a Service (PaaS) offering on the Oracle Cloud (OCI). It’s managed, meaning you don’t have to worry about updates, patches, or much in way of configuration.
One of the core features is the ability to publish and consume REST APIs for the data in your Autonomous Database – whether that be on the Dedicated, Serverless, or Always Free service offerings.
I wanted to answer a few frequently asked questions and share a couple of useful resources for you in this post.
How are my endpoints addressed?
All database REST APIs in Autonomous use the HTTPS protocol. Each HTTPS call generally has two main components, an address and a verb.
Well, if you publish a REST API in Autonomous, what the heck is my URL? We show you this critical information in your Database Actions REST workshop page.
So what comes after the /ords/ ?
Your REST APIs will look like this –
The schema is the REST Enabled schema name, or it’s schema alias, which we refer to as the url_mapping_pattern.
What else do I need to know about ORDS in Autonomous?
OS Authentication is available if you want it. But note that means consumers of your API will be logging in as actual Oracle Database users, and you’ll be using BASIC Auth, which is generally frowned upon, even when HTTPS is in play.
We recommend you use an ORDS provided OAUTH2 client. Hot Tip #1 – use Todd’s awesome blog post to see how to do this.
DO NOT USE ADMIN FOR PUBLISHING REST APIs
Building Services – with what tools?
You can use anything that can connect to your database and exercise the ORDS PL/SQL APIs. We recommend you either use SQL Developer on your desktop or stay in your browser and simply use Oracle SQL Developer Web..
The preferred interface is SQL Developer Web, also known as Database Actions.
Just give me a movie to watch, TL;DR
I have a 12 minute video demonstration showing a REST service in Autonmous that you can watch here.