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 Integration Zone is brought to you in partnership with Cloud Elements.  What’s below the surface of an API integration? Download The Definitive Guide to API Integrations to start building an API strategy.

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.

The State of API Integration Report provides data from the Cloud Elements platform and will help all developers navigate the recent explosion of APIs and the implications of API integrations to work more efficiently in 2017 and beyond.

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

Published at DZone with permission of Ross Garrett, DZone MVB. See the original article here.

Opinions expressed by DZone contributors are their own.

THE DZONE NEWSLETTER

Dev Resources & Solutions Straight to Your Inbox

Thanks for subscribing!

Awesome! Check your inbox to verify your email so you can start receiving the latest in tech news and resources.

X

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

{{ parent.tldr }}

{{ parent.urlSource.name }}