By using this site, you agree to the Privacy Policy and Terms of Use.
Accept
SmartData Collective
  • Analytics
    AnalyticsShow More
    predictive analytics in dropshipping
    Predictive Analytics Helps New Dropshipping Businesses Thrive
    12 Min Read
    data-driven approach in healthcare
    The Importance of Data-Driven Approaches to Improving Healthcare in Rural Areas
    6 Min Read
    analytics for tax compliance
    Analytics Changes the Calculus of Business Tax Compliance
    8 Min Read
    big data analytics in gaming
    The Role of Big Data Analytics in Gaming
    10 Min Read
    analyst,women,looking,at,kpi,data,on,computer,screen
    Promising Benefits of Predictive Analytics in Asset Management
    11 Min Read
  • Big Data
  • BI
  • Exclusive
  • IT
  • Marketing
  • Software
Search
© 2008-23 SmartData Collective. All Rights Reserved.
Reading: All APIs are not created equal.
Share
Notification Show More
Latest News
ai digital marketing tools
Top Five AI-Driven Digital Marketing Tools in 2023
Artificial Intelligence
ai-generated content
Is AI-Generated Content a Net Positive for Businesses?
Artificial Intelligence
predictive analytics in dropshipping
Predictive Analytics Helps New Dropshipping Businesses Thrive
Predictive Analytics
cloud data security in 2023
Top Tools for Your Cloud Data Security Stack in 2023
Cloud Computing
become a data scientist
Boosting Your Chances for Landing a Job as a Data Scientist
Jobs
Aa
SmartData Collective
Aa
Search
  • About
  • Help
  • Privacy
Follow US
© 2008-23 SmartData Collective. All Rights Reserved.
SmartData Collective > Data Management > Best Practices > All APIs are not created equal.
Best Practices

All APIs are not created equal.

JoeMcKendrick
Last updated: 2012/04/25 at 9:00 AM
JoeMcKendrick
3 Min Read
SHARE

Anyone on the cutting edge of service orientation and cloud lives in a universe of application programming interfaces (APIs), which serve as the gateways to functionality across the Web as well as enterprise systems.

The perception and ideal is that APIs can be readily snapped into an architecture to complete a process, much as Lego blocks can be snapped together. That’s the ideal, mind you.

Anyone on the cutting edge of service orientation and cloud lives in a universe of application programming interfaces (APIs), which serve as the gateways to functionality across the Web as well as enterprise systems.

More Read

database compliance guide

Four Strategies For Effective Database Compliance

How The Explosive Growth Of Data Access Affects Your Engineer’s Team Efficiency
What Are the Most Serious Privacy Concerns Regarding Big Data?
7 Consequences of a Data Intrusion: Insights From Asiaciti Trust & MGM International
How To Improve Incident Response Time for Data Breaches

The perception and ideal is that APIs can be readily snapped into an architecture to complete a process, much as Lego blocks can be snapped together. That’s the ideal, mind you.

Matt Mullen provides a reality check with this kind of thinking, reminding us again that APIs do not offer themselves to quick assembly in the style of Lego blocks.  The problem is, he says, no two APIs are alike:

“Not only are APIs certainly not like Lego, they are not equal. Talk to a developer and you’ll find out pretty quickly that they range from the well-formed and functional to the fiendishly complex and arcane. Then ask about the documentation. Then probably buy them a beer to recover from having to relive personal nightmares.”

The key to successfully working with APIs, Mullen continues, is to thoroughly understand the business process that will flow through the APIs. Then, be sure to get the documentation to share with your team, and be ready for the integration and customization work required to make the service work with your existing systems.

What should a well-designed API look like? For those on the design side of APIs, Layer 7’s Scott Morrison shares some resources in a new post. “APIs are a little like cockroaches in that they will likely outlive the human race,” he muses. Morrison points to recommendations from Martin Fowler and a YouTube video of Joshua Bloch’s Google TechTalk on How to Design A Good API & Why it Matters. (From 2007, but more timely than ever — Video embedded below.)

“You have one chance to get it right,” Bloch said, noting that once done and deployed, an entire enterprise may wire itself into the existing API. “A bad API can cause an unending stream of support phone calls because people cannot make the thing do what it ought to do.”

 

JoeMcKendrick April 25, 2012
Share this Article
Facebook Twitter Pinterest LinkedIn
Share

Follow us on Facebook

Latest News

ai digital marketing tools
Top Five AI-Driven Digital Marketing Tools in 2023
Artificial Intelligence
ai-generated content
Is AI-Generated Content a Net Positive for Businesses?
Artificial Intelligence
predictive analytics in dropshipping
Predictive Analytics Helps New Dropshipping Businesses Thrive
Predictive Analytics
cloud data security in 2023
Top Tools for Your Cloud Data Security Stack in 2023
Cloud Computing

Stay Connected

1.2k Followers Like
33.7k Followers Follow
222 Followers Pin

Sign Up for Our Newsletter

Subscribe to our newsletter to get our newest articles instantly!

[mc4wp_form id=”1616″]

You Might also Like

database compliance guide
Data Management

Four Strategies For Effective Database Compliance

8 Min Read
data access for engineers
Big Data

How The Explosive Growth Of Data Access Affects Your Engineer’s Team Efficiency

11 Min Read
big data privacy concerns
Privacy

What Are the Most Serious Privacy Concerns Regarding Big Data?

8 Min Read
painful lessons from major data breaches
Security

7 Consequences of a Data Intrusion: Insights From Asiaciti Trust & MGM International

6 Min Read

SmartData Collective is one of the largest & trusted community covering technical content about Big Data, BI, Cloud, Analytics, Artificial Intelligence, IoT & more.

giveaway chatbots
How To Get An Award Winning Giveaway Bot
Big Data Chatbots Exclusive
data-driven web design
5 Great Tips for Using Data Analytics for Website UX
Big Data

Quick Link

  • About
  • Contact
  • Privacy
Follow US

© 2008-23 SmartData Collective. All Rights Reserved.

Removed from reading list

Undo
Go to mobile version
Welcome Back!

Sign in to your account

Lost your password?