{"id":1700,"date":"2022-10-11T19:33:20","date_gmt":"2022-10-11T19:33:20","guid":{"rendered":"http:\/\/nikolapacekvetnic.rs\/?p=1700"},"modified":"2022-11-21T08:55:35","modified_gmt":"2022-11-21T08:55:35","slug":"consuming-a-rest-api-with-abap","status":"publish","type":"post","link":"http:\/\/nikolapacekvetnic.rs\/?p=1700","title":{"rendered":"Consuming a REST API with ABAP"},"content":{"rendered":"\n

A RESTful (or REST for short) API is an architectural style for an application program interface (API) that uses HTTP requests to access and use data. That data can be used to GET, PUT, POST and DELETE data types, which refers to the reading, updating, creating and deleting of operations concerning resources (Gillis)<\/a>. To consume a REST API simply means to use any part of it from an application.<\/span><\/p>\n

The simplest form of an HTTP request is certainly GET without parameters which is usually used to retrieve all entries offered via particular endpoint. In the following tutorial I will be looking at creating an ABAP program which consumes a REST API and displays all the entries retrieved as a HTML page.<\/p>\n\n\n\n

Getting Started<\/h2>\n

Most of the coding will be done in Eclipse with ADT, but the entire process is as easy to follow when one is using SAP GUI tools as well. Select File \/ New \/ Other<\/span>, and then type in “program<\/em><\/span>” to filter out the results; select ABAP Program<\/span> to create one. The result can be seen on Screenshot 1.<\/p>\n\n\n\n

\"\"
Screenshot 1 – A new ABAP program.<\/figcaption><\/figure>\n\n\n\n

Define a selection screen with a single parameter of type string <\/span>(Screenshot 2).<\/p>\n\n\n\n

\"\"
Screenshot 2 – Defining a selection screen.<\/figcaption><\/figure>\n\n\n\n

In order to get the selection screen frame caption and the parameter label open the program with SAP GUI <\/span>(Screenshot 3).<\/p>\n\n\n\n

\"\"
Screenshot 3 – Opening the program with SAP GUI.<\/figcaption><\/figure>\n\n\n\n

Head over straight to the Text Elements<\/span> page (Screenshot 4).<\/p>\n\n\n\n

\"\"
Screenshot 4 – Program opened with SAP GUI.<\/figcaption><\/figure>\n\n\n\n

Add the entry 001<\/span> into the Text Symbols table with value “User Input<\/span>” (can be anything really). The filled out table can be seen on Screenshot 5.<\/p>\n\n\n\n

\"\"
Screenshot 5 – Text Symbols table.<\/figcaption><\/figure>\n\n\n\n

Now, head over to the Selection Texts<\/span> tab and change the value of P_URL<\/span> entry to “Rest API URL<\/span>” (again, it can be anything). Check Screenshot 6 for comparison.<\/p>\n\n\n\n

\"\"
Screenshot 6 – Selection Texts table.<\/figcaption><\/figure>\n\n\n\n

This concludes the initial setup, thus letting us move on to consuming the REST API itself.<\/p>\n\n\n\n

Consuming the REST API<\/h2>\n

The basic idea, which is by no means exclusive to ABAP, comes down to following five steps:<\/p>\n

    \n
  1. Create an HTTP Client Object<\/li>\n
  2. Make a Request<\/li>\n
  3. Ask for a Response<\/li>\n
  4. Get the Data<\/li>\n
  5. Display the Data<\/li>\n<\/ol>\n\n\n\n

    Create an HTTP Client Object<\/h3>\n

    To create an HTTP client object in ABAP one should make use of cl_http_client<\/span> class and its static method create_by_url<\/span> (there are other options as well but this one suits us best in this case).<\/p>\n

    In order to make use of Eclipse’s advanced assistance features, start typing the name of the class and then hit CTRL+Space<\/span> – an auto-complete list should pop up letting you choose one of the options available based on what you typed down already. Not only does this work with methods as well, but there is an additional feature of using SHIFT+Enter<\/span> to select the method, which then types out the entire signature, i.e. reveals all the IMPORTING, EXPORTING, EXCEPTIONS and other types of parameters that the method works with (Screenshot 7).<\/p>\n\n\n\n

    \"\"
    Screenshot 7 – Creating an HTTP Client Object.<\/figcaption><\/figure>\n\n\n\n

    The method create_by_url<\/span> takes in the URL of the REST API we wish to consume (fed in via parameter on the selection screen in this case) and returns the HTTP client object it creates (lo_http<\/span> in our case). The exceptions stated in the signature can then be evaluated and properly handled, however that is out of the scope of this tutorial.<\/p>\n\n\n\n

    Make a Request<\/h3>\n

    The IF sy-subrc = 0.<\/span> check ensures that the program is terminated in case any errors occur. <\/p>\n

    If, on the other hand, all went well we now have our HTTP client and we are in position to make a request. For this we utilise the send<\/span> method (again, CTRL+Space<\/span> and SHIFT+Enter<\/span> make our lives easier in Eclipse) which only cares about a timeout<\/span> value, which is here set to 15<\/span> but can be any other value that works as well. The result can be seen on Screenshot 8.<\/p>\n\n\n\n

    \"\"
    Screenshot 8 – Making a Request.<\/figcaption><\/figure>\n\n\n\n

    Ask for a Response<\/h3>\n

    Now that the request has been made, we should ask for a response – this is achieved through method receive<\/span> which takes no input and returns no output values (Screenshot 9).<\/p>\n\n\n\n

    \"\"
    Screenshot 9 – Asking for a Response.<\/figcaption><\/figure>\n\n\n\n

    Get the Data<\/h3>\n

    Data is accessed via response<\/span>, which is a field of the lo_http<\/span> object. The get_cdata<\/span> method used is the way of getting the data in character format, i.e. as a string. Since what we will be receiving from the API is a JSON object, this is exactly what we want (Screenshot 10).<\/p>\n\n\n\n

    \"\"
    Screenshot 10 – Getting the Data.<\/figcaption><\/figure>\n\n\n\n

    Display the Data<\/span><\/h3>\n

    The data is displayed using the cl_abap_browser<\/span> class and its method show_html<\/span>. The method signature once fully displayed in Eclipse is pretty self-explanatory, however of its myriad of input parameters we will only be using two. This gives us perhaps not the fanciest, but certainly quite serviceable display of the JSON objects retrieved (Screenshot 11).<\/p>\n\n\n\n

    \"\"
    Screenshot 11 – Displaying the Data.<\/figcaption><\/figure>\n\n\n\n

    Example of REST APIs Ready for Consumption<\/h2>\n

    Some of the URLs I have used are listed below:<\/p>\n