API Abstraction is key to an API first strategy

Large enterprises have a gap in their API efforts: holding APIs as code is the cause

  • Open up your APIs to a wider audience — to be discovered and consumed by internal (e.g LoBs, product owners) and external (e.g. partners in your API ecosystem) stakeholders
  • Manage, organize and group together thousands of APIs which encapsulate your business capabilities and IT functions, not just 10–100 open APIs
  • Manage different types of APIs and versions for different technologies/runtime environments (e.g. business capability, internal IT, public/partner/3rd party APIs, but also REST, SOAP, events, emerging technologies)
  • Store artifacts which are related to those APIs; such as lineage, mappings, conformance to data models, and security policies (and other common shared services)

What is API abstraction?

  1. A pure abstracted view of the API: This is what we call a Design. A code- and implementation-agnostic view which contains abstracted capabilities of what the API does/will do once realized. Designs are a representation of your business capabilities and technical functions.
  2. A semi-abstracted service representation of the Design: This is what we call a Specification. A technical view of your API which contains implementation-specific technical details e.g. methods with a de-coded payload structure and non-functional requirements. These are versioned, and importantly contain enough detail to be used to generate runtime artifacts off-of (API code, contract, configuration, and documentation), enabling you to get back to the code to actually run the APIs.

Benefits of using API abstraction for a successful API strategy

1. An extended audience for your APIs

  • Business users such as product owners
  • Other technical users
  • Partners
  • What APIs your organization already has
  • How the APIs work
  • Who owns the APIs
  • What the upcoming API versions are

2. APIs can be reused to support new digital products

3. Normalized, consistent and well-governed API code and documentation

--

--

Large enterprises use our ignite Platform for digital recombination, APIs & Services at scale, Rapid IT Modernization, and Business & IT alignment

Love podcasts or audiobooks? Learn on the go with our new app.

Get the Medium app

A button that says 'Download on the App Store', and if clicked it will lead you to the iOS App store
A button that says 'Get it on, Google Play', and if clicked it will lead you to the Google Play store