Skip to Content

Introduction

The OData API of SAP Cloud Platform Integration enables you to access the stored data (e.g. to implement a monitoring project) or to update data (e.g. to create/update/delete partner directory content). In the past these OData API entities were only described in SAP Help Portal (see SAP Help Portal: SAP Cloud Platform Integration – OData API), but now with SAP Cloud Platform Integration 14-Apr-2018 release (v2.39.x) the first version of this API is published in the SAP API Business Hub.

New with SAP Cloud Platform Integration 7 July 2018 release:
API package of SAP Cloud Platform Integration is enhanced by access to “Design” section. These API enhancements are further detailed in  Blog: Cloud Integration – Remote OData API’s for Integration Flows and in SAP Help Portal: Integration Content Designtime – OData API.

New with SAP Cloud Platform Integration 4 August 2018 release:
API package of SAP Cloud Platform Integration is enhanced regarding the integration flow in “Design” section:

  • Access to resources of an integration flow
  • Download integration flow
  • Delete integration flow

The new artifact “Security Content” is provided with “Certifacte-to-User-Mapping”.

API Package “SAP Cloud Platform Integration”

This package contains the artifact list, which enables you to trigger the following actions:

  • Integration Content
    Get the list of deployed integration artifacts.
    Deploy/undeploy integration artifacts.
    New with  7 July 2018 release: Get/deploy integration flow with configuration parameters of “Design” section.
    New with  7 July 2018 release: Update configuration parameters of integration flow in “Design” section.
    New with 4 August 2018 release:
    Download/delete integration flow of “Design” section.
  • Log Files
    Get http and trace log files.
  • Message Processing Log
    Get information about the message processing including error information, attachments etc.
  • Message Store
    Get the stored payload with payload attachments and header properties.
  • Partner Directory
    Create, read, delete the Partner Directory content.
  • Security Content (new with 4 August 2018 release):
    Create, read, delete Certificate-to-User-Mappings.

Image 1: New API Package “SAP Cloud Platform Integration” in SAP API Business Hub

“Try It Out”

You have two different opportunities to test the API directly in the API Business Hub. Either you use the API Sandbox or you configure an API endpoint for your tenant account. For both options you need to be logged on with your SAP Community User.

API Sandbox

It is possible to directly test the provided GET methods via API Sandbox (see SAP Help Portal: SAP API Business Hub- Trying Out PIs in Sandbox Environment), which is the default “Try it out” feature.
The API Sandbox contains all test data for the provided API artifacts.

Example: GET All Deployed Integration Artifacts

Select the artifact from the “Artifacts” tab, which you want to test.

Image 2: Select artifact

In the “RESOURCE” tab open the method list for an entity (“Show/Hide”).

Image 3: Open method list of an entity

Click on the “GET” method header, fill possibly the required parameters and click on “Try it out”.

Image 4: Trigger test by clicking on “Try it out” button

Afterwards you could see the received response directly underneath.

Image 5: Received response

Your Tenant Account

Alternatively to API Sandbox, you could test all methods (GET, POST, PUT and DELETE) in your SAP Cloud Platform account by configuring API endpoint (see SAP Help Portal: SAP API Business Hub – Trying Out APIs in a Productive Environment).

For creating your API endpoint, click on “Configure” for an opened artifact.

Image 6: Configure an API endpoint

Select the region specific host of your tenant account:

Image 7: Select region specific host of your tenant account

Enter an endpoint alias, the account short name and the SSL host to complete the required URL for the API call and add your user credentials to complete the configuration.

Image 8: Enter the required attributes and the credentials of your tenant account

As prerequisite for API call via your configured API endpoint your user needs to be assigned to the required roles (see SAP Help Portal: SAP Cloud Platform Integration – Tasks and Required Roles).

CSRF Token Handling

For each write access a CSRF token is required. The corresponding fetch method “CSRF Token Handling” is part of each API package artifact with at least one write method.

To get the required CSRF token, at first the GET method needs to be called with the parameter X-CSRF-Token = ‘Fetch’.

Image 9: Fetch CSRF-Token

The received token must be copied from the response header.

Image 10: Copy CSRF-Token from response header

Afterwards this copied token needs to be entered into the X-CSRF-Token parameter of the POST, PUT or DELETE method.

Image11: Paste the copied CSRF-Token into the corresponding parameter value – e.g. for DELETE IntegrationRuntimeArtifacts to undeploy an integration flow

Look-Ahead

It is planned to further enhance the OData API of Cloud Integration (e.g. copy package from “Discover” to “Design” section) and to update this package in the SAP API Business Hub accordingly.
The API artifact “Security Content” will be further enhanced (e.g. keystore entities will be added).

To report this post you need to login first.

2 Comments

You must be Logged on to comment or reply to a post.

  1. Florian Kube

    Thanks you Sandra for this blog entry.

    I wonder how I am able to see the last processed messages. When I use the methode “Message Processing Logs” with the orderby option “LogStart,LogEnd desc” the order is still ascending.

    (0) 
    1. Sandra Voges Post author

      Hi Florian,

      Thank you very much for this feedback!
      The correct “$orderby” term should be “LogStart desc,LogEnd desc”.
      With the next update I will fix this issue of the GET method for the MessageProcessingLog artifact in the API package.

      Thank you and best regards,
      Sandra

       

      (0) 

Leave a Reply