api 101 · pdf fileapis to deploy infrastructure, now known as cloud computing. these ... and...

14
API 101 By Kin Lane July 2013 What is an API? What are APIs used for? Why do you need an API? History of Modern Web APIs What technology goes into an API? API Design API Deployment Essential Building Blocks for API Providers API Management API Monetization API Evangelism API Discovery API Integration API Ecosystem What Are Benefits of an API Some Trends in API Usage Clear API Opportunities APIs Are Growing Part of Our Connected World

Upload: tranhuong

Post on 08-Mar-2018

213 views

Category:

Documents


1 download

TRANSCRIPT

Page 1: API 101 · PDF fileAPIs to deploy infrastructure, now known as Cloud Computing. These ... and while they didn't necessarily invent any of the technologies ... Designing APIs has evolved

API 101

By Kin Lane

July 2013

What is an API?What are APIs used for?Why do you need an API?History of Modern Web APIsWhat technology goes into an API?API DesignAPI DeploymentEssential Building Blocks for API ProvidersAPI ManagementAPI MonetizationAPI EvangelismAPI DiscoveryAPI IntegrationAPI EcosystemWhat Are Benefits of an APISome Trends in API UsageClear API OpportunitiesAPIs Are Growing Part of Our Connected World

 

Page 2: API 101 · PDF fileAPIs to deploy infrastructure, now known as Cloud Computing. These ... and while they didn't necessarily invent any of the technologies ... Designing APIs has evolved

What Is An API?An API ­­ Application Programming Interface ­­ at its most basic level, allows your product or service to talk to otherproducts or services. In this way, an API allows you to open up data and functionality to other developers, to otherbusinesses or even between departments and locations within your company. It is increasingly the way in whichcompanies exchange data, services and complex resources, both internally, externally with partners, and openly withthe public.

What Are APIs Used For?APIs are launched primarily to give partners that are outside the company firewall, access to internal data andresources. But recently, APIs are also being used by more of the general public, including non­developers. As APIs'ease­of­use and popularity increases ­­ and as APIs demonstrate their value and deliver efficiencies ­­ manycompanies have begun to consume their own APIs to build internal systems, websites, and mobile apps using thesame APIs that they make available to third­party developers and to the public.

APIs are a single endpoint, for programmatic access to a resource, that can be secured and tailored for differentuses. APIs originally were used to enable integration with distributed sites and systems by companies like SalesForce,Amazon and Ebay, but newer companies quickly realized APIs would enable new types of relationships, making theweb much more social.

Alongside this evolution in API usage, one of the early pioneers Amazon, was working on a new approach to usingAPIs to deploy infrastructure, now known as Cloud Computing. These APIs have forever changed how we buildapplications, just in time for a new way to use applications via our mobile phones.  

In 2013, the number one reason APIs are deployed, is to support mobile development.  While APIs can be used forcommerce, payments, social, cloud computing and much more, mobile phones and tablets are the biggest drivingforce for providing APIs and consuming them.

Why Do You Need An API?An API is the cornerstone of what is widely seen as the next iteration of business development, where having a well­developed API is poised to be the way in which business relationship are established and maintained in a online, 24/7digital economy. A decade ago, businesses were still working to understand the importance of having a website fordoing business. Today, businesses are beginning to understand the similar importance in having an API.

Whether your API provides programmatic access to information that is already on your website like company directoryor product catalog, providing secure access to trusted partners, an APIs is becoming essential for operating in currentmarkets, and effectively competing.

You currently put products and services on the Internet for your human consumers to access in the form of websitesand applications. APIs are the wholesale version of a web presence, allowing others to access and integrate your dataand resources into their public or private sites and applications.

Page 3: API 101 · PDF fileAPIs to deploy infrastructure, now known as Cloud Computing. These ... and while they didn't necessarily invent any of the technologies ... Designing APIs has evolved

History of Modern Web APIsAPIs have been around since the 1980s, when they were used in hardware and software development.  However, thehistory of the modern Web API is fairly short ­­ just a little over ten years.  There are several pioneers of Web APIs,and while they didn't necessarily invent any of the technologies at play here, they did popularize their usage andestablish some of the common practices.

First Mover

E-Commerce

Social

Cloud Computing

Mapping

Local

Many of these pioneers have shaped the way in which we develop, deploy, consume, and support APIs, sparking a lotof innovation within the API space in the last decade.

Page 4: API 101 · PDF fileAPIs to deploy infrastructure, now known as Cloud Computing. These ... and while they didn't necessarily invent any of the technologies ... Designing APIs has evolved

What Technology Goes Into An API?APIs are driven by a set of specific technologies, making them easily understood by developers.  This type of focusmeans that APIs can work with any common programming language, with the most popular approach to deliveringweb APIs being REST, or REpresentational State Transfer.

REST takes advantage of the same Internet mechanisms that are used to view regular web pages, giving it manyadvantages, that can result in faster implementations and easier for developers to understand and use. REST APIsallow you to take data and functionality that may already be available on your website and make them availablethrough a programmatic API, that both web and mobile applications can use. Then, instead of returning HTML torepresent the information like a website would, an API returns data in one of two possible formats:

Extensible Markup Language (XML)JavaScript Object Notation (JSON)

Developers can then take this data and use in web and mobile applications.  However XML and JSON are easilyconsumed by spreadsheets and other tools non­developers can use as well, making APIs accessible by potentiallyanyone.  

Easy access to all this data and resources is great, but sometimes we need to control access to APIs. There are twoprimary ways to secure an API by providing  authentication using:

Basic AuthOAuth

REST with JSON has become the favorite of developers and API owners, because it is easier to both deploy andconsume than other implementations. Even though REST + JSON is not a standard, it is seeing wide acceptanceacross the industry.

The technology that are commonly found in APIs was not designated by a single standards body or by a singlecompany, it is based upon emulating the best practices of existing, successful providers over the last 13 years.

API DesignDesigning APIs has evolved over the last decade and is becoming a highly skilled craft. APi design is about applyingforward thinking about how an API will be used and evolve over time, API deployment and management experience,all of which can go a long way in avoiding common pitfalls and ultimately saving time, money and headache.

In the past, API design was something developers did, and with the emergence of new approaches to API definitionslike Swagger and Mashery I/O Docs, and from service providers like Apiary.io, API design can truly be planned,designed and mocked up to find the most meaningful interfaces possible­­before implementation.

Web APIs use URLs, but to find the most meaningful strategy, sensible uses of HTTP verbs like GET, POST, PUT andDELETE, requires deep consideration about how a resource will be manipulated via a URL, not just retrieved. Thenalso providing a robust set of parameters and default values that will help make an API intuitive to use.

API design is often done in the trenches of API operations, iterating and perfecting as an API initiative evolves.However with a growing base of API expertise and design tools many API craftsmen are spending time designing theperfect interface before even writing a line of code.

Quality API design is proving to to be one of the best ways to mitigate risk, and help cost effectively execute on an APIimitative, wile also delivering the most value to end users.

Page 5: API 101 · PDF fileAPIs to deploy infrastructure, now known as Cloud Computing. These ... and while they didn't necessarily invent any of the technologies ... Designing APIs has evolved

API DeploymentDeploying APIs is sitll something that can be very technical, requiring a healthy understanding of what an API is, howto construct a RESTful framework, and deploy the APIs underlying architecture. However with the growing demand forAPIs and the potential for new service providers entering the space, we are seeing more tools and services availablefor assisting providers in deployment of web APIs in 2013.

When it comes to API deployment it is all about what resources you have. If you have technical talent within reach,that understands APIs and can custom design and deploy APIs­­this is the route to take. However as manycompanies are finding, they have the need, but no the resources to actually execute on the designing and deploymentof APIs.  

Existing Software VendorsAs the demand for APIs grows, the number of existing database and software vendors that are deploying APIdeployment tools and services are growing. Before looking externally for API deployment tools and services makesure and look at your existing software vendors. There is a good chance that you already have the capabilities fordeploying APIs or could easily add­on functionality that will assist in the process, as part of your current systems.

Platform as a ServicePlatform as a Service, also known as PaaS, has found success in delivering the resources developers are needing todeploy web and mobile applications. Having used APIs to grow their own platforms, they are quickly seeing thebenefits of providing API deployment tools for their existing customers to deploy APIs. If you use a common PaaSprovider, there are chances that you already have the ability to deploy web APIs as part of your offering.

API as a ServiceCloud providers are also emerging that assist companies in deploying APIs from common data source such as fromMySQL, SQL Server, PostGreSQL, Oracle and even new sources such as NoSQL or cloud computing databases. Ifyour need to deploy APIs is centered around resources available within existing data sources, take a ook at the rangeof existing services that are emerging to help companies deploy APIs.

Custom DeploymentMany companies will opt for deploying their own custom API platforms. Even if your company has the resourcesavailable to design develop your own custom APIs, there are plenty of REST frameworks, oAuth servers and otheropen resources to help get the job done.  There is no reason to reinvent the wheel with the wealth of custom APIdeployment resources currently available.

In the last six years, the case has been made for APIs. API pioneers have laid the groundwork proving the value isthere, and now it is time to refine and establish best practices of API deployment using common, open sourceframeworks and common patterns like REST, and Hypermedia. 

Good API design will make API deployment a sensible and efficient process. But even with deployment, the job isn'tdone and following well established practices for API management is next.

Page 6: API 101 · PDF fileAPIs to deploy infrastructure, now known as Cloud Computing. These ... and while they didn't necessarily invent any of the technologies ... Designing APIs has evolved

Essential Building Blocks for API ProvidersAfter 13 years of web API history, a common set of building blocks that are essential to API adoption have emerged.The following elements have become common across top providers, as part of their developer portals and developeroutreach efforts:

Overview / Landing PageGetting StartedDocumentationCode SamplesBlog with RSSSupported ForumFrequently Asked QuestionsPricing and Rate LimitsTerms and ConditionsSelf­Service Registration

API pioneers like Ebay, SalesForce, Flickr, Google and Twilio have established this common set of essential APIbuilding blocks through trial and error over the last decade.

These are not anything new, but very simple approaches to helping on­board developers and consumers of an API inthe quickest way possible, while also building a platform that can support hundreds or thousands of consumers andsupport an active community around an API.

Some building blocks work best for some providers over others, but these ten building blocks can be consideredessential to API deployment and management.

API ManagementEach of the pioneering API providers have established their own approach to API management through trial and error.But with the help of API management providers like 3Scale, Apigee, Mashery, there is no shortage of APImanagement services available on the market today for people looking to get into the game.

API management is not usally about a single API, but providing a portal where private, partner and public developerscan access a wide variety of API resources to use in many different applications. Common building blocks havemerged for delivering API resources to consumers, but exactly how you implement the technology and businessoperations of your API can be a significant amount of work.

Some API providers cobble together their API management using existing SaaS and PaaS or their existing hostingsituation. They will bind disparate service like Google Groups, Wordpress and Github into a web of online resourcesintended to deliver an API portal on a budget.

Other companies use existing API management as a service providers like 3Scale or Apiphany. These companiesbring the tools, resources and experience necessary to go from 0 to 60 in any API management campaign withoutreinventing the wheel, while also taking advantage of existing best practices.

API management has been well established in the last 3 years, if you have the resources to do yourself, at least takethe time to understand what has been done to date, and do your homework on best practices of API management. Ifyou do not have the experience and resources make sure and talk to one of the many API management providerscurrently available. They can help.

Page 7: API 101 · PDF fileAPIs to deploy infrastructure, now known as Cloud Computing. These ... and while they didn't necessarily invent any of the technologies ... Designing APIs has evolved

API MonetizationHopefully by the time you have put an API management plan in place, you already have a health business model inplace, which should provide framework for you monetization goals.

Its not just about how you are going to generate revenue via your API, it is also about how you will keep your API inoperation, and performing for consumers.

Not all APIs are created equal. The reasons for deploying an API can vary widely, but we are seeing some commonpatterns emerge.

FreeA popular way to provide access to an API, is by offering a free tier so that anyone can sign up, start using an API andunderstand the value an API delivers. This allows consumers to kick the tires, see if it will meet their needs beforespending money. While free is a good option for many API monetization strategies, it is just one tool in the toolbox ofAPI providers, and by itself, or without the proper up sell to higher levels can prove problematic.

Consumer PaysAfter providing free access, the most common approach to API monetization is establishing a price that APIconsumers will pay. Some API providers have done well by finding a fair price that developers are willing to pay fortheir resources. We are seeing three common approaches to APIs charging consumers:

Tiered ­ Providing multiple tiers of paid access, such as bronze, gold or platinum. Each tier has its own set orservices and allowances for access to API resources. With pricing, stepping up in cost for each tier.Pay as You Go ­ Other API providers prefer to offer a utility based model, where API consumers pay for whatthey use. Depending on the amount of bandwidth, storage and other hard costs, incurred around APIconsumption, providers charge based upon their cost, plus a logical profit.Unit Based ­ Other API providers define each API resource in terms of units, assign a unit price. API providerspay for the number of units they anticipate using, with the option for buying more when necessary.

Some API providers will mix and match different combinations of tiered, pay as you go and unit based API pricing torecover operational costs as well as generate revenue in many cases. 

Consumer Gets PaidIn some cases, an API will drive other revenue streams for companies and can actually share revenue with APIconsumers. This approach acts as an incentive model for API consumers, encouraging integration and qualityimplementation of resources that drive the high possible revenue for an API provider as possible. There are threedistinct models for sharing API revenue with consumers that have merged:

Ad Rev­Share ­ Some API providers offer advertising network as part of their platforms. API consumers embedadvertising in their sites and apps, providing revenue for API providers. In turn the API provider returns a portionof the revenue from advertising.Affiliate ­ Some approaches to monetization of websites have been applied to API ecosystems. Cost PerAcquisition (CPA), Cost Per Click (CPC) and one time or recurring revenue sharing models are commonly used.Once key aspects of where revenue is generated from an API driven platform, it is easy to carve of affiliatemodels for sharing revenue with API consumers.Credits to Bill ­ A smaller group of API providers will employ an API consumers pay model, but based uponadvertising revenue share or affiliate revenue will credit an API consumers bill, reducing a developers overhead for integration and eliminating the need to paycash out the door.

Indirect

Page 8: API 101 · PDF fileAPIs to deploy infrastructure, now known as Cloud Computing. These ... and while they didn't necessarily invent any of the technologies ... Designing APIs has evolved

Monetization of an API isn't always about directly generating revenue from API access, advertising or other revenue.There are often times indirect ways that an API can deliver value to a company. 

Marketing Vehicle ­ APIs can provide an excellent marketing vehicle for a company and its online presence.Through sensible branding strategies, developers can become 3rd party marketing agents, working on behalf ofa core company and its brand.Brand Awareness ­ As a new tool in an overall marketing and branding strategy, an API can provide a typetype of brand exposure via 3rd party websites and applications. Extending the reach of a brand, using 3rd partyAPI consumers as the engine.Content Acquisition ­ Not all APIs are about delivering content, data and other resources to their consumers.APIs often allow for writing, updating and deleting of content, as well as pulling. Content acquisition via an APIcan be a great way to build value within a company and its platform if done right.SaaS ­ Software as a Service (SaaS) has become a common approach to selling software online to consumersand businesses.  Often times an API will compliment the core software and its offering, providing value to SaaSusers. API access is often included as part of core SaaS platform, but also can be delivered as an up­sell forpremium SaaS users.Traffic Generation ­ APIs can also be used to drive traffic to an existing website or application. By designing anAPI to use hyperlinks directed at central websites or apps, and encouraging consumers to build their ownwebsites and apps that are integrated with the API, the opportunity for driving traffic to other sites is verydesirable to many companies who are providing APIs.

Many companies start by focusing on launching and evolving their API strategy and gaining essential experience,before fully executing on their API monetization strategy­­relying completely on indirect value from an API. While it isbetter to have a monetization strategy in place early, many are finding success by prioritizing the API first andmonetziation second.

With APIs being deployed in various capacities, within a company, privately between partners or in the public, a widemix of monetization strategies can be used. Some API resources just lend themselves better to a pay as you gomodel, while some markets demand that data be freely accessible with the need to register or be charged for access.There is no one size fits all approach to API monetization.

One way to think about an API is as an external research & development lab within a company. A lab that acceptsideas and integrations from partners, incubates these ideas, applications and business relationships.  Companies areusing APIs to bring allow the introduction of outside ideas and talent into the mix, in hopes of inciting innovation. SomeAPI providers will hand select the best integrations, invest in their individuals and companies, sometimes resulting inacquisitions of technology and the talent they possess­­creating entirely new approaches to monetization you may nothave thought of.

Just like there is no on size fits all approach to API monetization, there are few constants in pricing or access. Eventhe pioneers in the space like Amazon Web Services are constantly adjusting, tweaking and experimenting, trying tofind the most competitive approach possible. APIs are about business development and finding new ways to monetizeyour new and existing resources.

Page 9: API 101 · PDF fileAPIs to deploy infrastructure, now known as Cloud Computing. These ... and while they didn't necessarily invent any of the technologies ... Designing APIs has evolved

API EvangelismAn API is useless if nobody knows about it. Evangelism has emerged as the approach to selling, marketing andsupport an API platform. While the intent of evangelism can be sales and marketing, the philosophy that has provedsuccessful is to find a balance that is more about focusing on API support and engagement with consumers oversales.

A healthy API evangelism strategy brings together a mix of business, marketing, sales and technology disciplines intoa new approach to doing business.

GoalsHealthy API evangelism is centered around clear goals. Goals usually start with targets like new user registration, butneed to be set higher around active API consumers, expanding how your existing users consume your API resources,all the way to clear definition of how your API will extend and expand your brand. 

Consumer EngagementWhile it may seem obvious, actively engaging API consumers often gets lost in the shuffle. Have a strategic approachto reaching out to new users in a meaningful way, establishing healthy practices for reaching out to existingdevelopers at various stages of integration, is essential to growing an API initiative. Without planned engagement ofAPI consumers, a canyon will grow between API provider and API consumer, one that may never be able to bereversed.

BloggingAn active blog, with an RSS feed has the potential to be the face of an API and developer evangelism campaign. Ablog will be the channel you tell the stories that help consumers understand the value that an API delivers, how otherdevelopers are integrating with it, ultimately leaving an SEO exhaust that will bring in new consumers. If commentsare in place, a blog can also provide another channel for opening up conversation with API consumers and thepublic. 

LandscapeWithout an understanding of the industry an API is operating in, an API will not effectively serve any business sector.By establishing and maintaining a relevant keyword list, you can monitor competitors, companies that complimentyour platform, and establish an active understanding of the business sector you are trying to serve. Regularmonitoring and analysis of the business landscape is necessary to tailor a meaningful API evangelism campaign. 

SupportWhen it comes to evangelism, support is one of the most critical elements. There is no better word of mouth for anAPI, than an existing consumer talking about how good the API is, and the support. Engage and support all APIconsumers. This will drive other vital parts of API evangelism, including creating positive stories for the blog, healthyconversations on social networks and potentially creating evangelists within a community.

GitHub I recommend a lot of online services and tools for API providers and consumers to put to use. But there is not anysingle platform that delivers as much value to the API space as Github. I would put AWS as close second, but Githubprovides a wealth of resources you can tap when both providing APIs or building applications around them.  Github isa critical piece of any API strategy, allowing social relationships with developers that is centered around codesamples, libraries or even documentation and resources for an API.

Social NetworkingTwitter, Facebook, LinkedIn, Google+ and Github are essential to all API evangelism strategies. If an API does nothave a presence on these platforms, it will miss out on a large segment of potential API consumers. Depending on the

Page 10: API 101 · PDF fileAPIs to deploy infrastructure, now known as Cloud Computing. These ... and while they didn't necessarily invent any of the technologies ... Designing APIs has evolved

business sector an API is targeting, the preferred social network will vary. Providing an active, engaging social supportpresence when operating an API is vital to any API ecosystem. 

Social BookmarkingDiscovery and curation of bookmarks to relevant news and information via social bookmarking platforms is essentialto an active API evangelism strategy. Using Reddit, Hacker News and StumbleUpon will provide discovery and accessto a wealth of resources for understanding the API space, but also provide an excellent channel for broadcasting blogposts, news and other resources about API operations, keeping consumers informed, while also opening up otheropportunities for discovery. 

Road­mapAPI providers, and API consumers are constantly building trust and establishing a long term relationship with eachother. One key facet of this trust, and the foundation for the relationship is sharing a common road­map. APIproviders need to actively involve API consumers with where the API resources are going, so that consumers canprepare, adjust and even give feedback that may, or may not, influence the road­map. Nothing will piss off APIconsumers faster than keeping them in the dark about what is coming down the pipes, and surprising them withchanges or breaks in their applications. 

EventsA healthy online presence is critical to any successful API strategy, but giving attention to a strong in­person presenceat events is also a proven tactic of successful API providers. Evangelism involves a coordinated presence at relevantconferences, hackathons and local meetups. Events are necessary for building personal relationships with partnersand API consumers that can be re­enforced online.

ReportingMeasuring every aspect of an API operations is necessary to understand what is happening in any API operations.Reporting on every aspect of API operations is how you visualize and make sense of some often, very fast movingAPI activity. It is important to quantify API operations, and develop reports that are crafted to inform key stakeholdersabout an API initiative.  

InternalExternal facing activities will dominate any active API operations. However, an essential aspect of sustainable APIprograms is internal evangelism. Making sure co­workers across all departments are aware and intimate with APIoperations, while also informing management, leadership and budget decision makers is critical to keeping API doorsopen, healthy and active. 

RepeatAPI and developer evangelism is an iterative cycle. Successful API operations will measure, assess and plan for theroad­map in an ongoing fashion, often repeating on a weekly and monthly basis to keep cycles small, reducing thepotential for friction in operations and minimizing failures when they happen.

A healthy API evangelism strategy will be something that is owned partially by all departments in a company. IT was asilo, APIs are about interoperability internally and externally.

API DiscoveryIn the early days of the web API movement (2005­2010), to find APIs, you went to ProgrammableWeb (PW), whichwas the only site on the web that was exclusively dedicated to web APIs. Discovery happened via the PW directoryand constant stream of news and analysis about the space.

ProgrammableWeb is still relevant in 2013, but as the number of APIs grows, the directory model is not meeting thedemand for finding the best of breed APIs that developers are needing to build web and mobile apps.

Page 11: API 101 · PDF fileAPIs to deploy infrastructure, now known as Cloud Computing. These ... and while they didn't necessarily invent any of the technologies ... Designing APIs has evolved

Within the API tech sector there has always discussion around the need for programmatic discovery of APIs.Something that uses a machine readable approach to describing APIs, so that the next generation of API directories,integrated development environments (IDE) and other systems can discover, understand, monitor and integrate withAPIs­­with less human involvement. In short, this vision has never been realized.

API discovery has two sides, finding the APIs you need and having your API be found. While there has been anevolution in the API discovery game, much of it is still done manually, with a lot of legwork by both API providers andconsumers.

As we move beyond 10K public APIs in the original API directory at ProgrammableWeb, the need for solid approachesto API discovery will emerge. API discovery is the bridge between API provider and consumer.

API IntegrationIntegrating with a single API can be tough, let alone multiple APIs. API integration involves on­boarding, exploration,education, authentication, code samples, testing, monitoring and sandboxing. An average API integration projectinvolves everything between the discovery of APIs and when the application goes into production.

As the average web or mobile application evolves from using one or two APIs, to potential 10 or 20, the need toescalate and streamline the integration will become critical. Developers are already feeling the pain, and a new breedof API integration services and tools are emerging to meet the demand.

This new breed of API service providers are looking to aid developers in finding the best of breed APIs, learn abouthow they work, and get up and running as fast as possible.

Once a developer has successfully integrated with API resources, there is a transition from integration to operation,and a whole other opportunity to provide tools and services that will ensure success for developers. 

API integration has moved beyond the hobby mashup and the challenges of single API integration, and is becomingabout building essential applications around mission critical, API driven resources that reside internally, via partnersystems and across the Internet.

API EcosystemAPIs start with deploying an API area to hang and manage a handful of APIs, where they can be accessed and put touse by consumers. But the goal is take an API area, evolve it into an active community of API consumers in hopes oftransforming it into a self service, self managing ecosystem of passionate partners and consumers.

Sustainable API ecosystems are a two way street. They are not just about about API providers generating value, it isalso about API consumers getting the resources they need to be successful and engaging in a new approach tobusiness development.

An API ecosystem will start within a single portal of API providers and consumers working together, but an ecosystemwill never exist in just a single place. In this new connected world, API ecosystems will exit on Twitter, StackExchange, Quora and anywhere else an API consumer will frequent.

Developing and growing an API from area to ecosystem takes years of work, lots of communication, support andhustle by everyone involved. An active API will attract new users, and the users who get the value they are looking for,and the support they need, will ultimately spread the word.  

A viable API ecosystem is equal parts technology, business and politics. A balance will need to be struck that doesn'tjust deliver value for API providers and consumers, but also end users of any web or mobile apps that are integratedwith API resources.

Page 12: API 101 · PDF fileAPIs to deploy infrastructure, now known as Cloud Computing. These ... and while they didn't necessarily invent any of the technologies ... Designing APIs has evolved

We all want an ecosystem around our API, but few of use will actually achieve one.

What Are The Benefits of An APIThe most direct benefits of an API are quicker, easier and more re­usable technical access to your companies assetsand resources.  APIs will allow your company to rapidly develop web, mobile and tablet applications from a singletechnical stack of machine readable resources.  

Using an API, you will be able to take better advantage of outside and 3rd party resources. Giving developers accessto only the resources they need to build applications that will be used to expand the reach of a business. It is theperfect balance of opening up access to your resources while also keeping things secure, and within control. This willallow a company to eliminate traditional IT resource bottlenecks, in a sensible way. 

Beyond the technical benefits of an API, an API can bring an entirely new way of thinking to your business operations. APIs will allow you to think differently about your companies most valuable assets and resources, enabling you todecouple them and allow them to be used independently and in new ways you never imagined before.  As you takeinventory and prepare your resources to be deployed as APIs, it will give you a new way of looking at a way ofoperating that encourages transparency, interoperability and scalability by default, without costing you security.

This will ultimately transform business operations more agile, nimble and flexible and able to take on any challenge inthis new digital economy.  

Some Trends in API UsageIts not the early days of API mashups anymore, there are numerous new ways that API usage is evolving­­furtherconnecting the data and resources we need to build the next generation of web and mobile apps.  Here are just a fewof the emerging trends in the API space:

API AggregationInnovative startups are applying API aggregation concepts using social and personal data, combining services likeTwitter, Facebook, LinkedIn, Instagram and other services into single API stacks. The goal of API aggregators is toshorten time for developers to go from on­boarding to finished app, by providing devs a fabric that weaves togethercommon objects like friends, images, status and check­in into a aggregate API platform.

API ReciprocityAPI reciprocity allows for the flow of information between the common platforms we depend on for our dailyoperations. In the enterprise this has been known as Extract Transform and Load (ETL), but in this new API world it isnot about data sources, but cloud services across the Internet. This new approach requires acknowledging terms ofservice and user privacy agreements made via oAuth­­allowing for reciprocity for platform owners, but also end users,alowing anyone, even non­developers to take advantage of APIs.

Backend as a ServiceWith the growth in the number of mobile devices like iPhone from Apple, Android from Google, Windows Phones fromMicrosoft and the historic contender Blackberry, a new breed of mobile backend as a service or BaaS providers areemerging to meet the demand for building, deploying and managing the mobile app life­cycle.

Reai­TimeReal­time approaches to deploying APIs involve technological approaches like PubSubHub, Websockets andWebhooks, can be as simple as an SMS or email sent when there is an update or utilizing streaming APIs to createfull, two­way communications between application and platforms using APIs. Real­time functionality is being expectedby end­users, and developers are using APIs to meet this demand.

Page 13: API 101 · PDF fileAPIs to deploy infrastructure, now known as Cloud Computing. These ... and while they didn't necessarily invent any of the technologies ... Designing APIs has evolved

These are just a handful of the trends emerging around APIs. There are over 10K public APIs available currently, withmany more private APIs being used to drive business at the SMB, SME and Enterprise levels. APIs are not just drivingdevelopers to innovate while building web and mobile applications. APIs, and the resulting trends are empoweringanyone, even non­developers to put valuable API driven resources to work every day.

Clear API OpportunitiesBeyond the newer trends in API usage, there are several opportunities emerging for both businesses and developersto take advantage of. The simplistic, web­based approach to providing access to resources is moving into new andexciting areas:

3D Printing3D printing, with the help of web APIs are moving beyond hobby and art, and have serious potential for re­defining theglobal manufacturing landscape. There are several platforms focusing on providing APIs for 3D printing. In thissection I will be tracking on news and companies that are doing interesting things around 3D printing and APIs, whilealso sharing blog analysis as well.

AutomobilesThink of the amount of time the average person spends in their car? It makes sense that the automobile would be anopportunity for delivering API driven data and resources. Major automakers like Ford and GM are turning our vehiclesinto API driven platforms, providing opportunities for businesses and developers to provide new products and servicesin­vehicle.

HomeDevices play a central roles in our daily lives. We carry our smart devices from home to work, and everywhere else wego in the world. It makes sense that APIs will eventually make their way beyond our computers in the corner andintegrate directly with our homes. A new wave of companies are emerging to develop the next generation of homeautomation technology ranging from thermostats for heating and air conditioning to lighting and home security. Whilemuch of the home automation technology is still without API, many new providers have seen the potential ofintroducing developer ecosystems and are using APIs to stimulate innovation around home technology integration.

BuildingsBuildings play a large role in our personal and professional lives. Many buildings already have automated heating, air,electrical, water and other system, and these building equipment manufacturers are quickly seeing the importance ofallowing API access to their hardware and software. Imagine if all of our buildings thought for themselves, and wereable to teach us to reduce energy consumption, diagnose problems in real­time, allowing them to self correct whennecessary or call a service provider when they need repair or tuning.

Quantified SelfThere is a new wave of devices that allow the wearer to understand more about themselves, ranging from heart rateto location and speed. While sports is a common model for many devices, because they have APIs, it opens up thisnew wave of quantified self devices that can be used for everything from life style tracking to health care.

These five areas represent just a handful of the opportunities available with APIs. APIs are not just about applicationson the Internet, they are connecting our physical worlds to this wondrous new cloud world we are increasinglybecoming dependent on.

Page 14: API 101 · PDF fileAPIs to deploy infrastructure, now known as Cloud Computing. These ... and while they didn't necessarily invent any of the technologies ... Designing APIs has evolved

APIs Are Growing Part Our Connected WorldIn 1995 the question was, should we have a website? By 2000 it was clear, to compete in business you had to have awebsite. By 2010 the question was, should we have an API? And by 2015 it will be mandatory for business to have anAPI or they won't be able to compete in this new global, API driven landscape.

Our business worlds moved online by 2000, by 2005 things were getting social, then with introduction of cloudcomputing we were able to start delivering the scalable resources we would need to power the next generation ofcomputing, via mobile smart phones. All of this is made possible by APIs, delivering the modular, valuable resourcesthat are needed to build web, mobile and tablet sites and applications the world demands.

APIs are something that every business owner will have to understand by 2015, and are something that any techsavvy individual can use for business or even personal use. APIs are beginning to connect every day objects to theInternet, making the physical world around us potentially seamless with our personal and professional online worlds.

APIs are being used in almost every business sector to connect them internally, with partners and the public. Ourfederal, state and city governments are putting APIs to use to better engage with the public.

As API take hold in both our online and offline worlds, they are becoming something everyone needs to be educatedon, making sure there is a wide awareness of the pros and cons of API access, and how to take advantage of, anddemand the best practices in technology, business and politics of APIs.

APIs have left the realm of information technology (IT), and is something that impacts all of us.  There is no avoiding itnow.