Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

 

Warning
titleWarning

This space is now deprecated: if you have been redirected to this page, please go to [Deprecated] Get the Technical Integration started

 

 

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 contact@maestranodevelopers@maestrano.com. Nothing to be afraid of (smile)

...

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.

...

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

Java

.NET

PHP

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

Image Added

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.

Info
titleConnec!™ on the Dev Sandbox

Connec!™ on the dev sandbox only replicates very basic functionalities from the real Connec!™. Validation, notifications, calculation logic etc.. are absent from this environment. The goal of Connec!™ on the Dev Sandbox is really to provide a "look and feel" experience of Connec!™ and allow you to test basic integration.

For real testing around data sharing, you should head to your App Provider dashboard on Maestrano, launch a sandbox app and start testing your data integration with other apps.

 

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)

Tip
titleMore data to share?

Think you've got more data to share than what's available currently? Don't hesitate to let us know! We're always glad to hear ideas about extending our data model. Just write an email to developers@maestrano.com and we'll get in touch.

 

 

...