Accessing the Public API

In the request body of each endpoint, we pass all the information we believe is necessary to complete the provisioning process. For example, the request body of the account synchronization endpoint includes all the main information of an account (name, phone and email, details of primary contact, etc.). If your provisioning flow requires more information which not available in the request body, you can access this information by calling the interworks.cloud API.

This page explains how you can call the interworks.cloud API from your service manager endpoints.

Define which Endpoints can Access the interworks.cloud API

You need first to define for which endpoints you want to receive an access token for our API. These endpoints can be defined in the “Authentication” section of the “Edit Integration” page.

Calling the interworks.cloud API

The system will generate an access token for the selected endpoints that will be passed to your service manager through the X-CloudPlatform-Token HTTP header. This token can be used to call our API for receiving additional info.

Below is a paradigm of how the access token will be available in the request body of the Account synchronize endpoint:

POST https://bssdemo.interworkscloud.net/AcronisCyber/api/accounts/synchronize HTTP/1.1
X-CloudPlatform-Token: Rn0W7vJq_Mrupa44m6PExDI1dlLbjyTF0IIdJexDumwcRtgQTbhVLfDUAP5Xp0Q8JrCTuXHHE-LIHjggJ1rkA0vu1wxFQDM1kHIARzBfgZao4LlD_zP6B1fHnTeFBQ3bGVwUyFSEywpLOLznEpWkRmrJYiR0sgsu7af3pzOTAKdds6XUSmPW9NKF_BJAkDdY0_PNdlPvPWE3bD090XNUvvMP88ZOnPKWs5ESZ7_G8J2M-z4AHVDM_NYTScD8zY67bv6A9XwM1U8WtooiZt-9KTMMSalKsFqL87VVMYcUmvfl5x7sQkA3cktFB1rDGcd8uRm1RbnURLTaPVokqppSS6Ba_yMaYSgpvcnInjyMtIFy3ByrVy_6fSeXHoRbaaZLH9PS4mcmN-gbFsINbxIfqff4l6BxBD0tEmHMXwe7_zz8kvnRjaacPuSrVaSP0GYY9F0TLIYxle1IafthSruz7N-T8-xmT2sVsBAb8OakPDR_dHSG9kUhO7ZAdl_XtmMj4G-p1rZ3S2z1F8u32w4U6dW2c0_SfGaIm48r6eTmmSELt-K5aqkMcR_bBuZiTTcTJm6LYkfJluCB9KtEjc7Srg
X-CloudPlatform-BaseUri: https://bssdemo.interworkscloud.net
X-CloudPlatform-ApplicationId: A0C53E79-8DE1-46A9-B198-9FAE94E1DBBE
X-CloudPlatform-APIKey: WksvUHZ5NGJ5d084ZU9DOU1Ta2IwRG42WjlJZWZNWGNZK0pvQWg4WVBsTT0=
Accept-Language: en
X-CloudPlatform-Setting-Gateway: https://mc-beta-cloud.acronis.com/api/
X-CloudPlatform-Setting-ClientId: 99553539-8aff-4a5c-88ca-f1635d0a01eb
X-CloudPlatform-Setting-ClientSecret: 57a32a2fac90494bbce19d678274fb46
X-CloudPlatform-Setting-DistributorDiscount: 18
X-CloudPlatform-TrackId: afd1a9aa-1a52-4223-b0f0-6036a7cfad27
Content-Type: application/json; charset=UTF-8
Accept: Accept=application/json
Host: bssdemo.interworkscloud.net
Content-Length: 513

For calling an API method, your should then pass this access token to the authorization header using Bearer authentication. Below, you can find a code snippet (line 9).

C# API Call Example

using (var client = new HttpClient())
 {
           client.BaseAddress = new Uri("http://my.interworkscloud.com/");
           client.DefaultRequestHeaders.Accept.Clear();
           client.DefaultRequestHeaders.Accept.Add(new MediaTypeWithQualityHeaderValue("application/json"));
		   client.DefaultRequestHeaders.Add("X-Api-Version", "latest");

           // Add the Authorization header with the AccessToken.
           client.DefaultRequestHeaders.Add("Authorization", "Bearer " + accessToken);


           // create the URL string.
           string url = string.Format("api/accounts/1");


           // make the request
           HttpResponseMessage response = await client.GetAsync(url);


           // parse the response and return the data.
           string jsonString = await response.Content.ReadAsStringAsync();
           object responseData = JsonConvert.DeserializeObject(jsonString);
 }