How to push data in body payload using ORACLE REST APIs?
Working with ORACLE REST is really enjoyable and easy, of course. But if you have huge amount of data to push through the web service then it becomes hectic because whatever you push through the web service appended into the URL. And as it’s obvious URL has it’s limitations of length. To push huge amount of data we can use body payload. let’s see what we have in body payload.
- form-data
- x-www-form-urlencoded
- raw
- binary
payload option “raw” is useful to push the huge amount of data in payload.
So, data can be pushed through raw payload option. now challenge is to retrieve the data at API other end.
ORDS REST provides support for default body payload parameter using “:body”. Now let’s understand how it works.
When we push data in body payload, it converts into blob format. Hence we need to convert this data into plain text so that we use it for our logical program.
DECLARE
l_body_to_clob CLOB;
l_plain_text VARCHAR2 (4000);
BEGIN
l_body_to_clob := EMPTY_CLOB ();
DBMS_LOB.createtemporary (l_body_to_clob, TRUE);
-- Convert body data into CLOB base64
l_body_to_clob := apex_web_service.blob2clobbase64 ( :body);
-- convert base64 clob data to plain text
l_plain_text :=
UTL_RAW.cast_to_varchar2 (
UTL_ENCODE.base64_decode (UTL_RAW.cast_to_raw (l_body_to_clob)));
-- printing received data
HTP.p (l_plain_text);
EXCEPTION
WHEN OTHERS
THEN
HTP.p (SQLERRM);
END;
Packages used and their purposes.
apex_web_service.blob2clobbase64
It is used to convert the payload data into base64 clob.
UTL_RAW.cast_to_varchar2
Casting raw data to varchar2
UTL_ENCODE.base64_decode
To decode raw data.
UTL_RAW.cast_to_raw
Casting clob data as raw.
API calling using Postman.
