Altaf Shaikh | February 1, 2016
WARNING: while the author tried to make the following topic understandable by those less technical, there may be some rather nerdy talk ahead. We hope you find it informative. May the Force be with you.
An API, or Application Program Interface, can be used to greatly enhance the functionality and interoperability of software like the Salesforce Marketing Cloud. But what exactly is an API and how can it benefit you?
Used in computer programming, an API is a set of routines, protocols and tools for building applications. In plain language, a routine is a sequence of computer code that performs a function action. It can be a single line of code or many lines. A protocol is simply a set of rules that exists for any system. A simple example might be updating a value in a database using an email address as a key, or lookup value, for a record.
An API can be used with:
The Marketing Cloud offers two types of APIs which enable customers to integrate with existing systems, extend functionality, or remotely control it. These are:
Both APIs share a common authentication method based on OAuth 2.
The difference between SOAP and REST is that SOAP initiates an operation and with REST, you are accessing a resource (data). In other words, SOAP sends a complete command, including attributes, whereas REST is more like a simple request. Both use HTTP (standard web protocol) over standard ports but only REST can be cached. Both support SSL, but only SOAP also supports WS-Security, WS-AtomicTransaction, and WS-ReliableMessaging – all three of which are required for high security applications like banking.
Google used to provide only SOAP for all of their services, but in 2006 they switched to REST, and their Search and Maps APIs now only support REST. Yahoo, Flickr, and del.ici.ous use REST but Amazon and eBay provide both.
Which API you use depends on what you need to accomplish. In most cases, REST is the way to go. It’s more scalable, easier to use and more flexible. There may be some functions that SOAP can execute that REST cannot, but the ListEngage team can almost always find a workaround in those rare instances. Of course, we can and have built applications with SOAP. If you are transferring sensitive financial information or need an even higher level of security, SOAP may be a better fit.
Here are a few examples of what you can do with an API. These are very simple, common examples. APIs are extremely powerful and flexible. They can be used to solve countless business problems and are only limited by your imagination.
Altaf Shaikh is ListEngage’s Founder and CEO. Altaf has been in software development and digital marketing for more than 25 years. He started ListEngage in 2003 to help businesses transform their email and digital marketing. ListEngage has supported the Salesforce Marketing Cloud since 2003 when it was ExactTarget. As a dedicated Salesforce Partner, ListEngage has served 900+ customers and earned multiple awards, such as: 2013 ExactTarget Global Services Award, the Inc. 5000 three consecutive years, and the Boston Business Journal's FAST 50 two years in a row. Contact Altaf at firstname.lastname@example.org.