How-To: Convert SOAP APIs to REST APIs
soap isn’t dead. not yet, at least. and that’s a pretty tough pill to swallow coming from an api-first product strategy. consuming soap apis is especially difficult for app developers working with web and mobile applications. we have to keep in mind that some of the older platforms originally built on soap apis were never really designed for public consumption, or even integration via the web. the architecture was strictly designed for the internal use case, and developer ux was an afterthought. soap is a strict document based api and while this offers resilience, it can make crafting a valid api cal complicated - especially in the absence of tooling.
as the demand for apis grows and integration use cases evolve over time, it’s important to consider the developer experience. here at cloud elements, we have taken an innovative approach to api integration, making it easier than ever to integrate your application to dozens of other endpoints with a unified rest api. but like i said, soap isn’t dead, yet.
this is why i’m excited to share with you the newest edition to our stack of developer tools: soap builder, an extension of our element builder . the core purpose of soap builder is to convert your soap-based endpoint into a unified rest api. developers can now leverage soap builder to transform every api they work into a familiar restful experience. as one of our developers mentioned to me, “we’re transposing an ugly interface [soap] into something that’s user-friendly.”
the value of element builder is to abstract and unify resources in a given category. you can use element builder to import an api, whether they are rest or soap, to either build new elements or extend the capabilities of existing elements in our catalog. element builder is designed to allow you to focus on the data you need, versus the interface, language, or capabilities it inherently offers.
in addition to now being able to import soap apis into element builder to create a new integration, soap builder now supports document-oriented and rpc wsdls. with this format, the endpoint’s operations and messages are described abstractly, and then bound to a concrete definition that is resource-centric.
“wsdl import is super cool -- a smart tool is rest-fying your soap interface for you. it gets you most of the way there, and leaves you to your discretion to get your integration up and running. it just works.”
what’s new in element builder with soap builder?
- you can import from wsdl - similar to an import using swagger for a rest api.
- being able to do an import from wsdl import, gets you at least 80% of the way to converting a soap endpoint to a rest endpoint.
- it imports your new endpoint to conform with the predefined hub api.
soap builder is particularly exciting for an organization that has existing internal soap interfaces they want to expose, and rather than investing into developing a new rest api for their company, they can now use cloud elements to modernize and extend the life/utility of their api. truly a great advance in a world where developers want rest.
