![\"\"](\"https:\/\/www.amalgaminsights.com\/wp-content\/uploads\/2017\/03\/TomPetrocelliAI-150x150.jpg\")
API management is a necessary but boring practice. As developers make use of a mix of public cloud, purchased or open source libraries, and homegrown services, the number of APIs used by developers quickly renders pouring through documentation impractical.<\/p>\n
Microservices, usually accessed via RESTFul APIs, cause API calls to rapidly proliferate. Even modest-sized microservices-based systems experience API overload quickly. Agile development can exacerbate the problem of understanding and using APIs. The rapid pace of Agile, especially Scrum, leaves little time for proper documentation of APIs. Documentation often takes a back seat to continuous deployment.
\n<\/p>\n
There are a number of other concerns with API management aside from simply documenting APIs. Once APIs are in widespread use, they need to be actively managed to ensure that they haven\u2019t changed and are only accessed securely. Access control of APIs becomes especially important when these are exposed to customer, partners, and the developer community, and monitoring of API performance.<\/p>\n
For a developer to use an API properly they must understand the following:
\n\u2022 which API calls exist
\n\u2022 how the API are used and function
\n\u2022 what parameters are available and what data structures the API call expects
\n\u2022 is access to API calls restricted and what controls exist on that access
\n\u2022 how the API calls are authenticated
\n\u2022 error conditions and error codes
\n\u2022 what the expected result sets and data structures are<\/p>\n
That\u2019s a lot to remember. Good documentation and reference books exist for major open source and commercial services but not for homegrown and lesser-known APIs.<\/p>\n
At the heart of API management is a data problem, more accurately a data management problem. The APIs themselves are a form of data \u2013 information that tells a developer how to access a service \u2013 and the documentation and controls the metadata. Managing APIs, which are sources of services, is not much different than cataloging, exposing, monitoring, and otherwise managing data sources.<\/p>\n
It\u2019s not that surprising then that Informatica has entered the API management market, alongside IBM, Microsoft, MuleSoft, and a host of others. Finding, managing, and securing data sources are Informatica\u2019s bread and butter competency. With developers already using their software to manage data sources, it\u2019s natural for those same customers to want Informatica to help them manage the APIs for the services they create to access and manipulate that data.<\/p>\n
As microservices architectures become more prevalent and companies need to expose APIs both internally and to their partners and customers, the need for API management will only grow. Sure, it\u2019s dull but so is changing the oil in your car. It\u2019s not good practice to ignore either.<\/p>\n","protected":false},"excerpt":{"rendered":"
API management is a necessary but boring practice. As developers make use of a mix of public cloud, purchased or open source libraries, and homegrown services, the number of APIs used by developers quickly renders pouring through documentation impractical. Microservices, usually accessed via RESTFul APIs, cause API calls to rapidly proliferate. Even modest-sized microservices-based systems […]<\/p>\n","protected":false},"author":4,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"jetpack_post_was_ever_published":false,"_jetpack_newsletter_access":"","_jetpack_newsletter_tier_id":0,"footnotes":""},"categories":[2],"tags":[],"class_list":["post-663","post","type-post","status-publish","format-standard","hentry","category-data-science"],"jetpack_sharing_enabled":true,"jetpack_featured_media_url":"","_links":{"self":[{"href":"https:\/\/amalgaminsights.com\/wp-json\/wp\/v2\/posts\/663","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/amalgaminsights.com\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/amalgaminsights.com\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/amalgaminsights.com\/wp-json\/wp\/v2\/users\/4"}],"replies":[{"embeddable":true,"href":"https:\/\/amalgaminsights.com\/wp-json\/wp\/v2\/comments?post=663"}],"version-history":[{"count":1,"href":"https:\/\/amalgaminsights.com\/wp-json\/wp\/v2\/posts\/663\/revisions"}],"predecessor-version":[{"id":13123,"href":"https:\/\/amalgaminsights.com\/wp-json\/wp\/v2\/posts\/663\/revisions\/13123"}],"wp:attachment":[{"href":"https:\/\/amalgaminsights.com\/wp-json\/wp\/v2\/media?parent=663"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/amalgaminsights.com\/wp-json\/wp\/v2\/categories?post=663"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/amalgaminsights.com\/wp-json\/wp\/v2\/tags?post=663"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}