A server-side web API is a programmatic interface consisting of one or more publicly exposed endpoints to a defined request-response message system, typically expressed in JSON or XML, which is exposed via the web—most commonly by means of an HTTP-based web server. Mashups are web applications which combine the use of multiple server-side web APIs. Webhooks are server-side web APIs that take as input a Uniform Resource Identifier (URI) that is designed to be used like a remote named pipe or a type of callback such that the server acts as a client to dereference the provided URI and trigger an event on another server which handles this event thus providing a type of peer-to-peer IPC.
Endpoints are important aspects of interacting with server-side web APIs, as they specify where resources lie that can be accessed by third party software. Usually the access is via a URI to which HTTP requests are posed, and from which the response is thus expected.
Endpoints need to be static, otherwise the correct functioning of software that interacts with it cannot be guaranteed. If the location of a resource changes (and with it the endpoint) then previously written software will break, as the required resource can no longer be found at the same place. As API providers still want to update their web APIs, many have introduced a versioning system in the URI that points to an endpoint, for example the Clarifai API: The endpoint for the tagging functionality within the web API has the following URI: "https://api.clarifai.com/v1/tag/". The "/v1/" part of the URI specifies access to the first version of the web API. If clarifai decides to update to version two, they can do this while still maintaining support for third party software that uses the first version.
Resource vs. Service
While "web API" is sometimes considered a synonym for web service, Web 2.0 web applications have moved away from SOAP-based web services towards more cohesive collections of RESTful web resources. These RESTful web APIs are accessible via standard HTTP methods by a variety of HTTP clients including browsers and mobile devices. They have advantages over web services in that they tend to be less difficult to develop and less resource intensive (and thus usually run faster) since they do not need to perform as many data conversions as required by a SOAP-based service APIs.
Signs of these industry changes can be seen by:
- Yahoo provides REST for all their services
- Amazon and eBay provide both REST and SOAP
- Google used to only provide SOAP, but deprecated these resources, in favour of REST in 2006
Server-side web APIs are an interface for the outside world to interact with the internal business logic. For many companies this internal business logic and the intellectual property associated with it are what distinguishes them from other companies, and potentially what gives them a competitive edge. They do not want this internal information to be exposed. However, in order to provide a web API of high quality, there needs to be a sufficient level of documentation. One API provider that not only provides documentation, but also links to it in its error messages is Twilio.
However, there are now directories of popular documented server-side web APIs.
Growth and Impact
The number of available web APIs has grown consistently over the past years, as businesses realize the growth opportunities associated with running an open platform, that any developer can interact with. ProgrammableWeb tracks 9000 Web APIs that were available in 2013, up from 105 in 2005.
Web APIs have become ubiquitous. There are few major software applications/services that do not offer some form of web API. One of the most common forms of interacting with these web APIs is via embedding external resources, such as tweets, Facebook comments, YouTube videos, vines, etc. In fact there are very successful companies, such as Disqus, whose main service is to provide embedable tools, such as a feature-rich comment system. Any website of the TOP 100 Alexa Internet ranked websites uses APIs and/or provides its own APIs, which is a very distinct indicator for the prodigious scale and impact of web APIs as a whole.
There are a lot of companies, which heavily rely on their API infrastructure to serve their core business clients. In 2014 Netflix received around 5 billion API requests, most of them within their private API.
Many governments collect a lot of data, and some governments are now opening up access to this data. The interfaces through which this data is typically made accessible are web APIs. Web APIs allow for data, such as "budget, public works, crime, legal, and other agency data" to be accessed by any developer in a convenient manner.
The United States are one of the pioneers in opening up government data for anybody and everybody to use. On its website, data.gov, the following is stated: "Since his first full day in office, President Obama has prioritized making government more open and accountable and has taken substantial steps to increase citizen participation, collaboration, and transparency in government. Data.gov, the central site for U.S. Government data, is an important part of the Administration’s overall effort to open government."
Google created their Native Client architecture which is designed to help replace insecure native plug-ins with secure native sandboxed extensions and applications. They have also made this portable by employing a modified LLVM AOT compiler.
- "What is mash-up? - Definition from WhatIs.com". WhatIs.com. Retrieved 2015-11-04.
- "Mashup Dashboard". ProgrammableWeb.com. 2009.
- "An Online Platform for Web APIs and Service Mashups". IEEE Internet Computing 12 (5). Sep–Oct 2008. doi:10.1109/MIC.2008.92.
- "Clarifai API: Large Scale Visual Recognition". developer.clarifai.com. Retrieved 2015-11-04.
- "Runscope/httpbin". GitHub. Retrieved 2015-11-04.
- Benslimane, D.; Dustdar, S.; Sheth, A. (2008). "Services Mashups: The New Generation of Web Applications". IEEE Internet Computing 10 (5): 13–15. doi:10.1109/MIC.2008.110.
- "Difference between Web API and Web Service?". programmers.stackexchange.com. Retrieved 2015-11-03.
- "REST vs SOAP, the difference between soap and rest : spf13.com". spf13 is Steve Francia. 2010-01-15. Retrieved 2015-11-02.
- "Open APIs and the Semantic Web 2011". 2011-06-07.
- Mulloy, Brian. Web API Design - Crafting Interfaces that Developers Love (PDF). apigee. p. 11.
- "API Directory". ProgrammableWeb. Retrieved 2015-11-03.
- "9,000 APIs: Mobile Gets Serious". ProgrammableWeb. Retrieved 2015-11-03.
- "Disqus – The Web’s Community of Communities". Disqus. Retrieved 2015-11-04.
- "Alexa Top 500 Global Sites". www.alexa.com. Retrieved 2015-11-04.
- "Top 10 Lessons Learned from the Netflix API - OSCON 2014, Slide 73". 2014-07-24.
- "Tech Trends 2015, API economy". Deloitte University Press. Retrieved 2015-11-03.
- "Open Government - Data.gov". Data.gov. Retrieved 2015-11-03.
- WebMonkey News
- Mozilla WebAPI Wiki
- Jacobson, Daniel; Woods, Dan; Brail, Greg (November 2011). APIs a strategy guide. Sebastopol, Calif: O'Reilly Media. ISBN 978-1-4493-0892-6.
- Mulloy, Brian. Web API Design - Crafting Interfaces that Developers Love (PDF). Apigee.
- "Web APIs". Google Chrome.
- "Web API reference - Web technology reference". Mozilla Developer Network.