Discuss Cloudrail CloudRail is an API integration solution that speeds up the process of integrating third-party APIs into an application and maintaining them. It does so by providing libraries for multiple platforms featuring abstraction layers that combine similar services behind a common interface.
Cloudrail – Setup Register a CloudRail app Use this link to create a new app (you may have to login first) − You can find your CloudRail license key in the app summary. Register a Facebook app Use this link to create a new app (you may have to login first) − . Then click the ”Add a New App” button, choose ”Basic setup” and create a new app. In the dashboard section you find your App Key (Client ID) and App Secret (Client Secret). Go to ”Add Product” and select ”Facebook Login”. Set the Redirect URI to ”http://localhost:12345/auth/redirect/facebook”. Register a Twitter app Use this link to create a new app (you may have to login first) − Click the ”Create New App” button and fill in the required details. Click on ”Keys and Access Tokens” and you”ll find your App Key (Client ID) and App Secret (Client Secret). Set the Redirect URI to ”http://localhost:12345/auth/redirect/twitter”. Initialize a new Node.js project Make sure you have Node.js installed, create a new folder, initialize the package.json and install Express and CloudRail by issuing the following commands in the console (or the equivalent commands on non-Unix OSs) − mkdir myProject cd myProject npm init npm i –save express cloudrail-si
Cloudrail – Useful Resources The following resources contain additional information on Cloudrail. Please use them to get more in-depth knowledge on this. Useful Video Courses 18 Lectures 42 mins 110 Lectures 10 hours 33 Lectures 3 hours 101 Lectures 10.5 hours 27 Lectures 8 hours 235 Lectures 15.5 hours
Cloudrail – Android This section gives an introduction on how to use CloudRail”s Android SDK. Setup The easiest way to install is via Maven. If you are using Android Studio with Gradle, it suffices to add the following to your build.gradle file − dependencies { compile ”com.cloudrail:cloudrail-si-android:2.8.1 } Usage The following example shows how to create a new folder and upload a file from an Android application”s assets to the newly created folder on any cloud storage provider. java CloudRail.setAppKey(“[CloudRail License Key]”); // CloudStorage cs = new Box(context, “[clientIdentifier]”, “[clientSecret]”); // CloudStorage cs = new OneDrive(context, “[clientIdentifier]”, “[clientSecret]”); // CloudStorage cs = new GoogleDrive(context, “[clientIdentifier]”, “[clientSecret]”); CloudStorage cs = new Dropbox(context, “[clientIdentifier]”, “[clientSecret]”); new Thread() { @Override public void run() { cs.createFolder(“/TestFolder”); // <— InputStream stream = null; try { AssetManager assetManager = getAssets(); stream = assetManager.open(“UserData.csv”); long size = assetManager.openFd(“UserData.csv”).getLength(); cs.upload(“/TestFolder/Data.csv”, stream, size, false); // <— } catch (Exception e) { // TODO: handle error } finally { // TODO: close stream } } }.start();
Cloudrail – Quick Guide Cloudrail – Overview CloudRail is an API integration solution that speeds up the process of integrating third-party APIs into an application and maintaining them. It does so by providing libraries for multiple platforms featuring abstraction layers that combine similar services behind a common interface. CloudRail – Features Here is a list of some of the most prominent features of CloudRail − Unified API − CloudRail bundles multiple web APIs into a single unified API. For instance, the function upload() works exactly the same for Dropbox as it does for Google Drive. You can easily integrate whole categories of providers, e.g. Social Logins, or change a provider with a single line of code. API Change Management − APIs change all the time, leading to broken integrations, unsatisfied customers and even more wasted development time. CloudRail monitors all APIs and maintains the integrations. You get immediate notifications about changes and all you need to do is update the CloudRail library to the latest version – no code changes required. API Statistics − Understand which APIs and functions are being used most by your customers. Get the necessary insights you need to identify new features or improve marketing campaigns. Direct Data − None of your data will ever pass a CloudRail server. The system doesn’t use a hosted middleware. All data transformation happens in the CloudRail library which is integrated in your App. This means no data privacy concerns, no down-times and no additional SPOF. OAuth Made Simple − Doing OAuth authentications is a pain. CloudRail makes authorizations as simple as adding a single line of code. The free version of CloudRail may only be used for non-commercial purpose or testing. Commercial users must purchase a license. Cloudrail – Android This section gives an introduction on how to use CloudRail”s Android SDK. Setup The easiest way to install is via Maven. If you are using Android Studio with Gradle, it suffices to add the following to your build.gradle file − dependencies { compile ”com.cloudrail:cloudrail-si-android:2.8.1 } Usage The following example shows how to create a new folder and upload a file from an Android application”s assets to the newly created folder on any cloud storage provider. java CloudRail.setAppKey(“[CloudRail License Key]”); // CloudStorage cs = new Box(context, “[clientIdentifier]”, “[clientSecret]”); // CloudStorage cs = new OneDrive(context, “[clientIdentifier]”, “[clientSecret]”); // CloudStorage cs = new GoogleDrive(context, “[clientIdentifier]”, “[clientSecret]”); CloudStorage cs = new Dropbox(context, “[clientIdentifier]”, “[clientSecret]”); new Thread() { @Override public void run() { cs.createFolder(“/TestFolder”); // <— InputStream stream = null; try { AssetManager assetManager = getAssets(); stream = assetManager.open(“UserData.csv”); long size = assetManager.openFd(“UserData.csv”).getLength(); cs.upload(“/TestFolder/Data.csv”, stream, size, false); // <— } catch (Exception e) { // TODO: handle error } finally { // TODO: close stream } } }.start(); Cloudrail – Java This section gives an introduction on how to use CloudRail”s Java SDK. Setup The easiest way to install is via Maven. It suffices to add the following to your pom.xml file − <dependencies> <dependency> <groupId>com.cloudrail</groupId> <artifactId>cloudrail-si-java</artifactId> <version>2.8.0</version> </dependency> </dependencies> Usage The following example shows how to create a new folder and upload a file from the local machine to the newly created folder on any cloud storage provider. java CloudRail.setAppKey(“[CloudRail License Key]”); // CloudStorage cs = new Box(redirectReceiver, “[clientIdentifier]”, “[clientSecret]”, “[redirectUri]”, “[state]”); // CloudStorage cs = new OneDrive(redirectReceiver, “[clientIdentifier]”, “[clientSecret]”, “[redirectUri]”, “[state]”); // CloudStorage cs = new GoogleDrive(redirectReceiver, “[clientIdentifier]”, “[clientSecret]”, “[redirectUri]”, “[state]”); CloudStorage cs = new Dropbox(redirectReceiver, “[clientIdentifier]”, “[clientSecret]”, “[redirectUri]”, “[state]”); new Thread() { @Override public void run() { cs.createFolder(“/TestFolder”); InputStream stream = null; try { stream = getClass().getResourceAsStream(“Data.csv”); long size = new File(getClass().getResource(“Data.csv”).toURI()).length(); cs.upload(“/TestFolder/Data.csv”, stream, size, false); } catch (Exception e) { // TODO: handle error } finally { // TODO: close stream } } }.start(); Cloudrail – Node.js This section gives an introduction on how to use CloudRail”s Node.js SDK. Setup The easiest way to install is via NPM. Simply use the following command − npm install cloudrail-si Usage The following example shows how to create a new folder and upload a file from the local machine to the newly created folder on any cloud storage provider. javascript const cloudrail = require(“cloudrail-si”); cloudrail.Settings.setKey(“[CloudRail License Key]”); // let cs = new cloudrail.services.Box(redirectReceiver, “[clientIdentifier]”, “[clientSecret]”, “[redirectUri]”, “[state]”); // let cs = new cloudrail.services.OneDrive(redirectReceiver, “[clientIdentifier]”, “[clientSecret]”, “[redirectUri]”, “[state]”); // let cs = new cloudrail.services.GoogleDrive(redirectReceiver, “[clientIdentifier]”, “[clientSecret]”, “[redirectUri]”, “[state]”); let cs = new cloudrail.services.Dropbox(redirectReceiver, “[clientIdentifier]”, “[clientSecret]”, “[redirectUri]”, “[state]”); cs.createFolder(“/TestFolder”, (err) => { // <— if (err) throw err; let fileStream = fs.createReadStream(“UserData.csv”); let size = fs.statSync(“UserData.csv”).size; cs.upload(“/TestFolder/Data.csv”, fileStream, size, false, (err) => { // <— if (err) throw err; console.log(“Upload successfully finished”); }); }); Cloudrail – IOS This section gives an introduction on how to use CloudRail”s iOS SDK. Setup The easiest way to install is via CocoaPods. Simply add the following to your podfile − pod “cloudrail-si-ios-sdk” Make sure the “use_frameworks!” flag is set and run Pod install Usage The following examples shows how to download a file from any cloud storage provider in Objective-C and Swift. objective-c // self.service = [[CROneDrive alloc] initWithClientId:@”clientIdentifier” clientSecret:@”clientSecret” redirectUri:@”REDIRURL” state:@”CRSTATE”]; // self.service = [[CRGoogleDrive alloc] initWithClientId:@”clientIdentifier” clientSecret:@”clientSecret” redirectUri:@”REDIRURL” state:@”CRSTATE”]; // self.service = [[CRBox alloc] initWithClientId:@”clientIdentifier” clientSecret:@”clientSecret” redirectUri:@”REDIRURL” state:@”CRSTATE”]; [CRCloudRail setAppKey:@”CLOUDRAIL_API_KEY”]; self.service = [[CRDropbox alloc] initWithClientId:@”clientIdentifier” clientSecret:@”clientSecret” redirectUri:@”REDIRURL” state:@”CRSTATE”]; NSInputStream * object = [self.service downloadFileWithPath:@”/mudkip.jpg”]; //READ FROM STREAM swift //let cloudStorage : CloudStorageProtocol = Box.init(clientId: “ClientID”, clientSecret: “ClientSecret”) //let cloudStorage : CloudStorageProtocol = GoogleDrive.init(clientId: “ClientID”, clientSecret: “ClientSecret”) //let cloudStorage : CloudStorageProtocol = OneDrive.init(clientId: “ClientID”, clientSecret: “ClientSecret”) CRCloudRail.setAppKey(“CLOUDRAIL_API_KEY”) let cloudStorage : CloudStorageProtocol = Dropbox.init( clientId: “ClientID”, clientSecret: “ClientSecret”) do { let inputStream = try cloudStorage.downloadFileWithPath(“/TestFolder/Data.csv”) } catch let error{ print(“An error: (error)”) } //READ FROM STREAM Cloudrail – Social Login This section presents the use-case of implementing social login for a (web) app. This chapter provides just an overview on Social Login and in the subsequent chapters, we will show how to set it up for Facebook and Twitter but it is very easy to add more services like Google Plus, LinkedIn, GitHub, Instagram, Slack, Windows Live and Yahoo. We will be using Node.js with Express on the
Cloudrail – Java This section gives an introduction on how to use CloudRail”s Java SDK. Setup The easiest way to install is via Maven. It suffices to add the following to your pom.xml file − <dependencies> <dependency> <groupId>com.cloudrail</groupId> <artifactId>cloudrail-si-java</artifactId> <version>2.8.0</version> </dependency> </dependencies> Usage The following example shows how to create a new folder and upload a file from the local machine to the newly created folder on any cloud storage provider. java CloudRail.setAppKey(“[CloudRail License Key]”); // CloudStorage cs = new Box(redirectReceiver, “[clientIdentifier]”, “[clientSecret]”, “[redirectUri]”, “[state]”); // CloudStorage cs = new OneDrive(redirectReceiver, “[clientIdentifier]”, “[clientSecret]”, “[redirectUri]”, “[state]”); // CloudStorage cs = new GoogleDrive(redirectReceiver, “[clientIdentifier]”, “[clientSecret]”, “[redirectUri]”, “[state]”); CloudStorage cs = new Dropbox(redirectReceiver, “[clientIdentifier]”, “[clientSecret]”, “[redirectUri]”, “[state]”); new Thread() { @Override public void run() { cs.createFolder(“/TestFolder”); InputStream stream = null; try { stream = getClass().getResourceAsStream(“Data.csv”); long size = new File(getClass().getResource(“Data.csv”).toURI()).length(); cs.upload(“/TestFolder/Data.csv”, stream, size, false); } catch (Exception e) { // TODO: handle error } finally { // TODO: close stream } } }.start();
Cloudrail Tutorial Job Search CloudRail is an API integration solution that speeds up the process of integrating third-party APIs into an application and maintaining them. It does so by providing libraries for multiple platforms featuring abstraction layers that combine similar services behind a common interface. Audience This tutorial targets software developers that want to learn how to lose less time on API integrations. Prerequisites CloudRail provides libraries for Android, Java, Node.js and iOS (Objective-C and Swift). Basic knowledge of the respective platform is required to use the corresponding library. You can quickly sign up for a free account at and get a license key which you will need to use the library.
Cloudrail – IOS This section gives an introduction on how to use CloudRail”s iOS SDK. Setup The easiest way to install is via CocoaPods. Simply add the following to your podfile − pod “cloudrail-si-ios-sdk” Make sure the “use_frameworks!” flag is set and run Pod install Usage The following examples shows how to download a file from any cloud storage provider in Objective-C and Swift. objective-c // self.service = [[CROneDrive alloc] initWithClientId:@”clientIdentifier” clientSecret:@”clientSecret” redirectUri:@”REDIRURL” state:@”CRSTATE”]; // self.service = [[CRGoogleDrive alloc] initWithClientId:@”clientIdentifier” clientSecret:@”clientSecret” redirectUri:@”REDIRURL” state:@”CRSTATE”]; // self.service = [[CRBox alloc] initWithClientId:@”clientIdentifier” clientSecret:@”clientSecret” redirectUri:@”REDIRURL” state:@”CRSTATE”]; [CRCloudRail setAppKey:@”CLOUDRAIL_API_KEY”]; self.service = [[CRDropbox alloc] initWithClientId:@”clientIdentifier” clientSecret:@”clientSecret” redirectUri:@”REDIRURL” state:@”CRSTATE”]; NSInputStream * object = [self.service downloadFileWithPath:@”/mudkip.jpg”]; //READ FROM STREAM swift //let cloudStorage : CloudStorageProtocol = Box.init(clientId: “ClientID”, clientSecret: “ClientSecret”) //let cloudStorage : CloudStorageProtocol = GoogleDrive.init(clientId: “ClientID”, clientSecret: “ClientSecret”) //let cloudStorage : CloudStorageProtocol = OneDrive.init(clientId: “ClientID”, clientSecret: “ClientSecret”) CRCloudRail.setAppKey(“CLOUDRAIL_API_KEY”) let cloudStorage : CloudStorageProtocol = Dropbox.init( clientId: “ClientID”, clientSecret: “ClientSecret”) do { let inputStream = try cloudStorage.downloadFileWithPath(“/TestFolder/Data.csv”) } catch let error{ print(“An error: (error)”) } //READ FROM STREAM
Cloudrail – Node.js This section gives an introduction on how to use CloudRail”s Node.js SDK. Setup The easiest way to install is via NPM. Simply use the following command − npm install cloudrail-si Usage The following example shows how to create a new folder and upload a file from the local machine to the newly created folder on any cloud storage provider. javascript const cloudrail = require(“cloudrail-si”); cloudrail.Settings.setKey(“[CloudRail License Key]”); // let cs = new cloudrail.services.Box(redirectReceiver, “[clientIdentifier]”, “[clientSecret]”, “[redirectUri]”, “[state]”); // let cs = new cloudrail.services.OneDrive(redirectReceiver, “[clientIdentifier]”, “[clientSecret]”, “[redirectUri]”, “[state]”); // let cs = new cloudrail.services.GoogleDrive(redirectReceiver, “[clientIdentifier]”, “[clientSecret]”, “[redirectUri]”, “[state]”); let cs = new cloudrail.services.Dropbox(redirectReceiver, “[clientIdentifier]”, “[clientSecret]”, “[redirectUri]”, “[state]”); cs.createFolder(“/TestFolder”, (err) => { // <— if (err) throw err; let fileStream = fs.createReadStream(“UserData.csv”); let size = fs.statSync(“UserData.csv”).size; cs.upload(“/TestFolder/Data.csv”, fileStream, size, false, (err) => { // <— if (err) throw err; console.log(“Upload successfully finished”); }); });
Cloudrail – Overview CloudRail is an API integration solution that speeds up the process of integrating third-party APIs into an application and maintaining them. It does so by providing libraries for multiple platforms featuring abstraction layers that combine similar services behind a common interface. CloudRail – Features Here is a list of some of the most prominent features of CloudRail − Unified API − CloudRail bundles multiple web APIs into a single unified API. For instance, the function upload() works exactly the same for Dropbox as it does for Google Drive. You can easily integrate whole categories of providers, e.g. Social Logins, or change a provider with a single line of code. API Change Management − APIs change all the time, leading to broken integrations, unsatisfied customers and even more wasted development time. CloudRail monitors all APIs and maintains the integrations. You get immediate notifications about changes and all you need to do is update the CloudRail library to the latest version – no code changes required. API Statistics − Understand which APIs and functions are being used most by your customers. Get the necessary insights you need to identify new features or improve marketing campaigns. Direct Data − None of your data will ever pass a CloudRail server. The system doesn’t use a hosted middleware. All data transformation happens in the CloudRail library which is integrated in your App. This means no data privacy concerns, no down-times and no additional SPOF. OAuth Made Simple − Doing OAuth authentications is a pain. CloudRail makes authorizations as simple as adding a single line of code. The free version of CloudRail may only be used for non-commercial purpose or testing. Commercial users must purchase a license.