Over a million developers have joined DZone.
{{announcement.body}}
{{announcement.title}}

Resource-Centric API Calls: Switching Up the Cloud Elements Hubs

DZone's Guide to

Resource-Centric API Calls: Switching Up the Cloud Elements Hubs

In Cloud Elements' platform for API integration, developers can now define their own API resources, accessed by a consistent RESTful API with a JSON payload.

· Integration Zone ·
Free Resource

The State of API Integration 2018: Get Cloud Elements’ report for the most comprehensive breakdown of the API integration industry’s past, present, and future.

Our API Hubs represent the intersection of resources across the Elements within a category of applications. We created a platform for API Integration with the assumption that one-to-many means that integrating to many CRMs (or Finance apps, or Marketing Automation platforms) is faster than building one-by-one. However, something new we have learned is that our customers are using integrations beyond the category. We're excited to announce resource-center API calls for developers to define their own API resources.

API Developer Documentation

We now support API calls directly to resources, without requiring association to a Hub. Previously, if you wanted to call GET /Contacts to Salesforce, the entire API would have to look like:  GET /hubs/crm/contacts. The requirement to know the Hub for all the Elements you were using caused problems for some use cases.

Now, you can call GET /contacts directly without specifying a Hub.  This will provide multiple benefits, including:

  • Resources are now accessible regardless of the Hub each Element resides.
  • One-to-many integrations are simpler since you no longer need to know the Hub location for an Element.
  • Lays the groundwork for Composite Resources and Composite Hubs, such as what Inspirato did to orchestrate data in their app.

API Call Get CompanyEvery resource is accessed using a consistent RESTful API with a JSON payload, regardless of the API protocol used at the endpoint. Cloud Elements’ pre-built connectors do the work of mapping the unified API call to each provider’s API endpoint, as well as transforming SOAP, XML and other API protocols to REST/JSON.  When Cloud Elements creates an Element, the resources defined for that Element are normalized to the intersection of resources that are available across the applications in that category.

For example, a user can create a common object for use across Hubs, which could be a Company Object. The individual application endpoints may use different naming conventions for this resource, such as Account in Salesforce, Company in HubSpot, and Organization in Quickbooks. Cloud Elements resource normalization transforms all varieties of the Company Object to one uniform model.  

Using resource-centric API calls, the common objects will still be normalized even though they do not need to be associated with the Hub within the call.

For more information on our Hubs and Elements, check out our API Documentation.

Your API is not enough. Learn why (and how) leading SaaS providers are turning their products into platforms with API integration in the ebook, Build Platforms, Not Products from Cloud Elements.

Topics:
integration ,api ,api resources ,cloud elements ,hubs

Published at DZone with permission of

Opinions expressed by DZone contributors are their own.

{{ parent.title || parent.header.title}}

{{ parent.tldr }}

{{ parent.urlSource.name }}