
By Mark O'Neill | Article Rating: |
|
February 1, 2013 07:30 AM EST | Reads: |
12,110 |

A lot has been written about the difference between REST APIs and SOAP Web Services. The technical differences are well known at this stage. SOAP is heavyweight, while REST is light and mobile-friendly. However, there is another key difference which is often overlooked:
- It is easy to create SOAP Web Services, but difficult to consume them.
- It is difficult to create a good REST APIs, but easy to consume them.
Taking SOAP first: development platforms such as .NET made it almost too easy to create a SOAP Web Service. I remember seeing MSDN demos showing how, in a few clicks, you can take a .NET object and expose it as a Web Service, complete with WSDL. But, in those quick clicks, what had you created? You had exposed the methods of your objects as SOAP operations. But why? Is this really what you wanted to do? And while it was easy to say "Clients can just consume the WSDL to call my new Web Service", this was easier said than done. And when clients did this, it often made little sense to directly run the methods of the class.
Fast forward to the world of REST. One of the great virtues of REST is that it is so much easier to consume a REST API, compared to consuming a SOAP Web Service. In addition, it does not require parsing XML, if you prefer to directly read in JSON. However, creating a good REST API takes thought and some decisions. You should think about how you'll appropriately use the HTTP verbs, how to express versioning, and what kind of error messages you'll return. Fortunately, an API Server helps a lot here, by providing a platform for delivering APIs, to take care of aspects like security, usage quota-management, and analytics. But it still is important to take time to design your API up front.
Read the original blog entry...
Published February 1, 2013 Reads 12,110
Copyright © 2013 SYS-CON Media, Inc. — All Rights Reserved.
Syndicated stories and blog feeds, all rights reserved by the author.
More Stories By Mark O'Neill
Mark O'Neill is VP Innovation at Axway - API and Identity. Previously he was CTO and co-founder at Vordel, which was acquired by Axway. A regular speaker at industry conferences and a contributor to SOA World Magazine and Cloud Computing Journal, Mark holds a degree in mathematics and psychology from Trinity College Dublin and graduate qualifications in neural network programming from Oxford University.
![]() Apr. 23, 2018 03:15 AM EDT Reads: 4,431 |
By Yeshim Deniz ![]() Apr. 23, 2018 01:00 AM EDT Reads: 1,970 |
By Liz McMillan Apr. 23, 2018 12:30 AM EDT Reads: 2,658 |
By Liz McMillan ![]() Apr. 23, 2018 12:00 AM EDT Reads: 5,557 |
By Pat Romanski Apr. 22, 2018 11:30 PM EDT Reads: 2,745 |
By Yeshim Deniz Apr. 22, 2018 11:00 PM EDT Reads: 2,435 |
By Liz McMillan ![]() Apr. 22, 2018 10:00 PM EDT Reads: 22,602 |
By Liz McMillan ![]() Apr. 22, 2018 07:45 PM EDT Reads: 13,650 |
By Liz McMillan ![]() Apr. 22, 2018 07:00 PM EDT Reads: 5,103 |
By Liz McMillan ![]() Apr. 22, 2018 06:30 PM EDT Reads: 13,331 |
By Pat Romanski ![]() Apr. 22, 2018 04:00 PM EDT Reads: 6,956 |
By Elizabeth White ![]() Apr. 22, 2018 03:00 PM EDT Reads: 13,198 |
By Pat Romanski Apr. 22, 2018 02:45 PM EDT Reads: 2,377 |
By Pat Romanski Apr. 22, 2018 02:30 PM EDT Reads: 1,406 |
By Liz McMillan Apr. 22, 2018 02:00 PM EDT Reads: 1,723 |
By Yeshim Deniz ![]() Apr. 22, 2018 12:45 PM EDT Reads: 2,023 |
By Elizabeth White Apr. 22, 2018 12:15 PM EDT Reads: 1,782 |
By Pat Romanski ![]() Apr. 22, 2018 12:00 PM EDT Reads: 5,455 |
By Elizabeth White ![]() Apr. 22, 2018 12:00 PM EDT Reads: 4,050 |
By Elizabeth White ![]() Apr. 22, 2018 10:45 AM EDT Reads: 6,957 |