Integrate your app with Maestrano

Interested in joining the Maestrano community? Here is how to get started.

1 Contact our team

Maestrano is not an open marketplace. We make sure that every integration is taken care of properly and prefer to engage direct communications with developers and/or companies wishing to join our ecosystem. From there our friendly staff will make sure to get you covered both on the technical and marketing side.

It's only an email to developers@maestrano.com. Nothing to be afraid of 

2 Choose the right SDK

You've decided to move forward. Great! Now is time to choose how you're going to integrate, especially which SDK you're going to use.

We've got four SDKs available so far, all available on Github:

• Ruby and Ruby on Rails
• Java
• .NET
• PHP

Our SDKs are the best way to integrate with us, especially when it comes to Single Sign-On which - like any SSO protocol - tends to be a little bit..."hairy" to integrate without any out-of-the-box libraries.

Not the SDK you want? You can always revert to doing an SDK-free integration. Just checkout our guide on how to do so.

3 Explore the Sample Apps

Our engineering team has developed sample applications for each of the SDKs we propose. These open source apps are a great way to see our APIs in action and understand the scope of the integration. It's also a good way for our engineering team to provide code samples when you need to cover specific scenarios.

Ruby

• Source: https://github.com/maestrano/demoapp-rails
• Live Demo: http://rails-demoapp.maestrano.io/

Java

• Source: https://github.com/maestrano/demoapp-java
• Live Demo: http://java-demoapp.maestrano.io/

.NET

• Source: https://github.com/maestrano/demoapp-dotnet
• Live Demo: no live demo available for the moment

PHP

• Source: https://github.com/maestrano/demoapp-php
• Live Demo: http://php-demoapp.maestrano.io

4 Warm up on our Dev Sandbox

Maestrano has established three main test environments for you: the dev sandbox (open), the production sandbox (closed environment) and, finally, the production environment (closed environment)

The first thing to do is to get setup on the dev sandbox here: api-sandbox.maestrano.io

It will allow you to quickly get started with Single Sign-On, Single Billing and Connec!™. The logs section exposes the logs of the application with additional debug information to make sure you get clear visibility on what's happening.

5 Get a feel of data sharing

The Maestrano offers app providers the ability to share data with other applications via a single connector. Connec!™ Data Sharing defines a universal data model that developers can adopt to seamlessly communicate with tens of applications without worrying about the specifics of each of them. Our data model covers financial, customer/supplier, event, payroll, inventory data and more! We're extending it every month!

The Restful API as well as the list of entities available for sharing is available here:

http://maestrano.github.io/connec/

Each of our SDK (expect Java for the moment - coming soon) includes a pre-configured Connec!™ http client allowing you to make requests without worrying about authentication, endpoint configuration etc. Documentation on how to use the client is available at the end of each SDK documentation (on Github).

Data sharing without real time is lame. That's why Connec!™ also allows you to configure Webhooks so you get notified every time something gets changed in any other application. Documentation about webhooks is also available at the end of each SDK documentation (Github)