Accessing a Service Through a Proxy URL

Access your backend or internet-based service through a proxy URL. The URL supports read (HTTP GET), create (HTTP POST), update (HTTP PUT), and delete (HTTP DELETE).

You can specify the customized application properties for the client with the request. Provide the application connection ID, X-SMP-APPCID by using an explicit request header or a cookie.

Perform an HTTP request at the following URL:

http[s]://<host:port>/[public/]/ApplicationName/{connectionName}

connectionName - connection name of the whitelisted URL.

Note:

Ensure that all the URLs to be proxied are whitelisted.
If the session is not handled by the client implicitly, you need to handle it explicitly in the code.

HTTP GET – Invoke GET request to retrieve the data from the back end through SAP Mobile Platform.

http[s]://<host:port>/[public/]/ApplicationName/[Collection]

Example:

Request header

X-SMP-APPCID : <Application connection Id recieved in the response of the onboarding xml>
Authorization  :  <Base64 format of username/password>
Content-type  : <application/atom+xml>
X-CSRF-Token: <"Fetch">

Response header

Response code 200 ok
//Response header contains requested data from back end with the below mentioned response headers:
x-csrf-token: "value"
content-encoding
Content-Type
Content-Length

HTTP POST – Use POST to request the server to accept the data included in the request message body.

http[s]://<host:port>/[public/]/ ApplicationName/[Collection]

Example:

Request header

X-SMP-APPCID : <Application connection Id recieved in the response of the onboarding xml>
Content-Type : application/atom+xml
X-Requested-With  : XMLHttpRequest 
X-CSRF-TOKEN : <value of x-csrf-token is recieved as part of GET which needs to be passed here>
Authorisation : <Base 64 encoded value of Authorisation>

Response header

201 //on successful creation.

HTTP PUT – Use PUT to update the entry in the back end.

http[s]://<host:port>/[public/]/ ApplicationName/[Collection]/<’EntryID’>

Example:

Request header

X-SMP-APPCID : <Application connection Id recieved in the response of the onboarding xml>
Content-Type : application/atom+xml
X-CSRF-TOKEN : <value of x-csrf-token is recieved as part of GET which needs to be passed here>
Authorisation : < Base 64 encoded value of Authorisation>
X-Requested-With  : XMLHttpRequest

Response header

204 //on successful update.

HTTP DELETE – Use DELETE to the delete an entry in back end.

http[s]://<host:port>/[public/]/ApplicationName/[Collection](EntryID)

Example:

Request header

X-SMP-APPCID : <Application connection Id recieved in the response of the onboarding xml>
Authorization  :  <Base64 format of username/password>
Content-type  : <application/atom+xml>
X-CSRF-TOKEN : <value of x-csrf-token is recieved as part of GET which needs to be passed here>
X-Requested-With  : XMLHttpRequest

Response header

204 //on successful deletion.

Note: No information is returned in case of DELETE request.