www.digitalml.com
Open in
urlscan Pro
104.198.14.88
Public Scan
Submitted URL: https://email.digitalml.com/e3t/Ctc/RJ+113/d2pNQ904/VX5LTT8YTrwGW3KrhYm5WGctWW48Yhp74GrN48N1h3ys13pdskV1-WJV7CgLSGW4vrVT63DS...
Effective URL: https://www.digitalml.com/api-abstraction-is-key-to-an-api-first-strategy/?utm_campaign=General%20Cataloging%20Story&utm_m...
Submission: On March 10 via api from SE — Scanned from DE
Effective URL: https://www.digitalml.com/api-abstraction-is-key-to-an-api-first-strategy/?utm_campaign=General%20Cataloging%20Story&utm_m...
Submission: On March 10 via api from SE — Scanned from DE
Form analysis 2 forms found in the DOM
POST https://forms.hsforms.com/submissions/v3/public/submit/formsnext/multipart/20434743/7ae03d20-74ec-451c-a98c-de62fd0ea404
<form novalidate="" accept-charset="UTF-8" action="https://forms.hsforms.com/submissions/v3/public/submit/formsnext/multipart/20434743/7ae03d20-74ec-451c-a98c-de62fd0ea404" enctype="multipart/form-data"
id="hsForm_7ae03d20-74ec-451c-a98c-de62fd0ea404" method="POST"
class="hs-form stacked hs-form-private hsForm_7ae03d20-74ec-451c-a98c-de62fd0ea404 hs-form-7ae03d20-74ec-451c-a98c-de62fd0ea404 hs-form-7ae03d20-74ec-451c-a98c-de62fd0ea404_2becd350-5614-436a-8a81-0f72b880d60e"
data-form-id="7ae03d20-74ec-451c-a98c-de62fd0ea404" data-portal-id="20434743" target="target_iframe_7ae03d20-74ec-451c-a98c-de62fd0ea404" data-reactid=".hbspt-forms-0" data-hs-cf-bound="true">
<div class="hs_email hs-email hs-fieldtype-text field hs-form-field" data-reactid=".hbspt-forms-0.1:$0"><label id="label-email-7ae03d20-74ec-451c-a98c-de62fd0ea404" class="" placeholder="Enter your Email"
for="email-7ae03d20-74ec-451c-a98c-de62fd0ea404" data-reactid=".hbspt-forms-0.1:$0.0"><span data-reactid=".hbspt-forms-0.1:$0.0.0">Email</span><span class="hs-form-required" data-reactid=".hbspt-forms-0.1:$0.0.1">*</span></label>
<legend class="hs-field-desc" style="display:none;" data-reactid=".hbspt-forms-0.1:$0.1"></legend>
<div class="input" data-reactid=".hbspt-forms-0.1:$0.$email"><input id="email-7ae03d20-74ec-451c-a98c-de62fd0ea404" class="hs-input" type="email" name="email" required="" placeholder="What's your Email? *" value="" autocomplete="email"
data-reactid=".hbspt-forms-0.1:$0.$email.0" inputmode="email"></div>
</div><noscript data-reactid=".hbspt-forms-0.2"></noscript>
<div class="hs_submit hs-submit" data-reactid=".hbspt-forms-0.5">
<div class="hs-field-desc" style="display:none;" data-reactid=".hbspt-forms-0.5.0"></div>
<div class="actions" data-reactid=".hbspt-forms-0.5.1"><input type="submit" value="Subscribe" class="hs-button primary large" data-reactid=".hbspt-forms-0.5.1.0"></div>
</div><noscript data-reactid=".hbspt-forms-0.6"></noscript><input name="hs_context" type="hidden"
value="{"rumScriptExecuteTime":1637.8999996185303,"rumServiceResponseTime":2001.5,"rumFormRenderTime":3,"rumTotalRenderTime":2473,"rumTotalRequestTime":340.1000003814697,"renderRawHtml":"true","lang":"en","clonedFromForm":"3be12aca-9596-4f08-bd54-5a73d48d3ab5","embedType":"REGULAR","sfdcCampaignId":"7011W0000025sbjQAA","embedAtTimestamp":"1646921289555","formDefinitionUpdatedAt":"1646854135492","pageUrl":"https://www.digitalml.com/api-abstraction-is-key-to-an-api-first-strategy/?utm_campaign=General%20Cataloging%20Story&utm_medium=email&_hsmi=206206557&_hsenc=p2ANqtz-8-7-jw8xZRcgtN-aaBfxdTvmxehFJfqfFrqwNkXwEUO6t3L467rZGc768jiCHx6tsqeJx4l_oEpubjmxtk2GFRLHZWbte3D-MKJATC7jaWjcN3jGM&utm_content=206206469&utm_source=hs_email","pageTitle":"API Abstraction is key to an API first strategy | digitalML","source":"FormsNext-static-5.458","sourceName":"FormsNext","sourceVersion":"5.458","sourceVersionMajor":"5","sourceVersionMinor":"458","timestamp":1646921289555,"userAgent":"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/99.0.4844.51 Safari/537.36","originalEmbedContext":{"region":"na1","portalId":"20434743","formId":"7ae03d20-74ec-451c-a98c-de62fd0ea404","sfdcCampaignId":"7011W0000025sbjQAA","target":"#hbspt-form-1646921289360-6020548829"},"urlParams":{"utm_campaign":"General Cataloging Story","utm_medium":"email","_hsmi":"206206557","_hsenc":"p2ANqtz-8-7-jw8xZRcgtN-aaBfxdTvmxehFJfqfFrqwNkXwEUO6t3L467rZGc768jiCHx6tsqeJx4l_oEpubjmxtk2GFRLHZWbte3D-MKJATC7jaWjcN3jGM","utm_content":"206206469","utm_source":"hs_email"},"renderedFieldsIds":["email"],"formTarget":"#hbspt-form-1646921289360-6020548829","correlationId":"aedd7d93-37d4-46b1-ab8a-1356663f1669","captchaStatus":"NOT_APPLICABLE"}"
data-reactid=".hbspt-forms-0.7"><iframe name="target_iframe_7ae03d20-74ec-451c-a98c-de62fd0ea404" style="display:none;" data-reactid=".hbspt-forms-0.8"></iframe>
</form>POST https://forms.hsforms.com/submissions/v3/public/submit/formsnext/multipart/20434743/7ae03d20-74ec-451c-a98c-de62fd0ea404
<form novalidate="" accept-charset="UTF-8" action="https://forms.hsforms.com/submissions/v3/public/submit/formsnext/multipart/20434743/7ae03d20-74ec-451c-a98c-de62fd0ea404" enctype="multipart/form-data"
id="hsForm_7ae03d20-74ec-451c-a98c-de62fd0ea404" method="POST"
class="hs-form stacked hs-form-private hsForm_7ae03d20-74ec-451c-a98c-de62fd0ea404 hs-form-7ae03d20-74ec-451c-a98c-de62fd0ea404 hs-form-7ae03d20-74ec-451c-a98c-de62fd0ea404_6709024d-c654-4f8b-8c33-ddccbe998d32"
data-form-id="7ae03d20-74ec-451c-a98c-de62fd0ea404" data-portal-id="20434743" target="target_iframe_7ae03d20-74ec-451c-a98c-de62fd0ea404" data-reactid=".hbspt-forms-1" data-hs-cf-bound="true">
<div class="hs_email hs-email hs-fieldtype-text field hs-form-field" data-reactid=".hbspt-forms-1.1:$0"><label id="label-email-7ae03d20-74ec-451c-a98c-de62fd0ea404" class="" placeholder="Enter your Email"
for="email-7ae03d20-74ec-451c-a98c-de62fd0ea404" data-reactid=".hbspt-forms-1.1:$0.0"><span data-reactid=".hbspt-forms-1.1:$0.0.0">Email</span><span class="hs-form-required" data-reactid=".hbspt-forms-1.1:$0.0.1">*</span></label>
<legend class="hs-field-desc" style="display:none;" data-reactid=".hbspt-forms-1.1:$0.1"></legend>
<div class="input" data-reactid=".hbspt-forms-1.1:$0.$email"><input id="email-7ae03d20-74ec-451c-a98c-de62fd0ea404" class="hs-input" type="email" name="email" required="" placeholder="What's your Email? *" value="" autocomplete="email"
data-reactid=".hbspt-forms-1.1:$0.$email.0" inputmode="email"></div>
</div><noscript data-reactid=".hbspt-forms-1.2"></noscript>
<div class="hs_submit hs-submit" data-reactid=".hbspt-forms-1.5">
<div class="hs-field-desc" style="display:none;" data-reactid=".hbspt-forms-1.5.0"></div>
<div class="actions" data-reactid=".hbspt-forms-1.5.1"><input type="submit" value="Subscribe" class="hs-button primary large" data-reactid=".hbspt-forms-1.5.1.0"></div>
</div><noscript data-reactid=".hbspt-forms-1.6"></noscript><input name="hs_context" type="hidden"
value="{"rumScriptExecuteTime":1758.599998474121,"rumServiceResponseTime":2002,"rumFormRenderTime":1.6999988555908203,"rumTotalRenderTime":2500.699998855591,"rumTotalRequestTime":234,"renderRawHtml":"true","lang":"en","clonedFromForm":"3be12aca-9596-4f08-bd54-5a73d48d3ab5","embedType":"REGULAR","sfdcCampaignId":"7011W0000025sbjQAA","embedAtTimestamp":"1646921289570","formDefinitionUpdatedAt":"1646854135492","pageUrl":"https://www.digitalml.com/api-abstraction-is-key-to-an-api-first-strategy/?utm_campaign=General%20Cataloging%20Story&utm_medium=email&_hsmi=206206557&_hsenc=p2ANqtz-8-7-jw8xZRcgtN-aaBfxdTvmxehFJfqfFrqwNkXwEUO6t3L467rZGc768jiCHx6tsqeJx4l_oEpubjmxtk2GFRLHZWbte3D-MKJATC7jaWjcN3jGM&utm_content=206206469&utm_source=hs_email","pageTitle":"API Abstraction is key to an API first strategy | digitalML","source":"FormsNext-static-5.458","sourceName":"FormsNext","sourceVersion":"5.458","sourceVersionMajor":"5","sourceVersionMinor":"458","timestamp":1646921289570,"userAgent":"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/99.0.4844.51 Safari/537.36","originalEmbedContext":{"region":"na1","portalId":"20434743","formId":"7ae03d20-74ec-451c-a98c-de62fd0ea404","sfdcCampaignId":"7011W0000025sbjQAA","target":"#hbspt-form-1646921289489-1238187504"},"urlParams":{"utm_campaign":"General Cataloging Story","utm_medium":"email","_hsmi":"206206557","_hsenc":"p2ANqtz-8-7-jw8xZRcgtN-aaBfxdTvmxehFJfqfFrqwNkXwEUO6t3L467rZGc768jiCHx6tsqeJx4l_oEpubjmxtk2GFRLHZWbte3D-MKJATC7jaWjcN3jGM","utm_content":"206206469","utm_source":"hs_email"},"renderedFieldsIds":["email"],"formTarget":"#hbspt-form-1646921289489-1238187504","correlationId":"105d1367-cfff-4f03-8dc6-3422ecbb2f1f","captchaStatus":"NOT_APPLICABLE"}"
data-reactid=".hbspt-forms-1.7"><iframe name="target_iframe_7ae03d20-74ec-451c-a98c-de62fd0ea404" style="display:none;" data-reactid=".hbspt-forms-1.8"></iframe>
</form>Text Content
API ABSTRACTION IS KEY TO AN API FIRST STRATEGY
* Product & Solutions
THE IGNITE PLATFORM
IGNITE
FEATURES
HOLISTIC API & SERVICE CATALOG
A single location to discover, reuse and manage
EXTENDED API LIFECYCLE
Scale your APIs fast and safe
Learn More
OUR SOLUTIONS
BY INDUSTRY
* Banking and Payments
* Healthcare
* Insurance
* Travel and Hospitality
* Retail
View All
BY ROLE
* Leadership
* Digital Product Owners
* Architects
View All
BY GOAL
* Digital Recombination and Product Innovation
* Accelerated IT Modernization
* Self-Service API Governance and Standards at Scale
View All
FORRESTER REPORT: API PRODUCT MANAGEMENT IS KEY TO API SUCCESS
This report helps ensure that your API strategy has proper direction as you
build out the thousands of APIs that unlock business capabilities.
Download Report
* Resources
RESOURCES
* Upcoming Webinars
* Downloadable Webinars
* Product Sheets
* Reports
* Whitepapers
* Videos
View All
FEATURED RESOURCE
REPORTS
REPORT: 7 DIGITAL TRANSFORMATION PREDICTIONS FOR 2022
Read More
LEARN THE BEST API PRACTICES AND
GET THE LATEST IGNITE UPDATES
View All Resources
* Insights
* About
COMPANY
* About
* Careers
* Contact Us
FEATURED RESOURCE
REPORTS
REPORT: 7 DIGITAL TRANSFORMATION PREDICTIONS FOR 2022
Read More
FUEL THE DIGITAL TRANSFORMATION INITIATIVES OF
YOUR ENTERPRISE WITH INSIGHTFUL INDUSTRY CONTENT
View All Insights
* ···
Login
Book a Demo
Insights
API Strategy
API ABSTRACTION IS KEY TO AN API FIRST STRATEGY
* January 7, 2021
· 4 Min Read
6 benefits of using API abstraction in an API first strategy.
API abstraction provides a unique solution for large enterprises looking to
scale their API efforts as part of an API first digital strategy. In this post
we look at what abstraction is, why it’s needed, and the 6 key benefits of using
abstracted APIs as your system of record and main API objects, rather than code.
LARGE ENTERPRISES HAVE A GAP IN THEIR API EFFORTS: HOLDING APIS AS CODE IS THE
CAUSE
As a large enterprise trying to scale your API efforts as part of an API first
digital strategy, you’re likely now at a stage where you need to:
* 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’s more, you likely want all of the above in a single unified view,
understandable by both business and IT. But, relying on the implementation code
for your APIs makes this near impossible – that’s because API code is hard to
interrogate and understand beyond a handful of skilled developers, and it’s
likely held in disparate systems across the enterprise’s architecture.
Abstracting your APIs provides an unique solution and can be used to deliver all
of the needs above, in supporting API first at scale.
What is API abstraction?
Simply put, abstraction can take your APIs away from their complex code and
implementation specifics, into a common metadata framework, to make them
understandable by everyone in the enterprise in a standardized format.
When working with abstraction, two objects are involved to ensure your APIs are
usable by both business and technical users:
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
Your catalog of APIs and Services becomes understandable by an extended audience
as the detail and business logic is not locked away in the code. Many more roles
internally in your enterprise, as well as approved external users can discover,
understand, and use your APIs and Services – all with a reliable consumer
experience:
* Business users such as product owners
* Other technical users
* Partners
Users of your abstracted APIs can easily learn:
* 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
As APIs are abstracted into a common framework and therefore standardized
format, they can be easily combined together, and repurposed into what we call
Product Bundles (which includes API products, composite APIs etc.). These
bundles can be used to quickly build, test, and launch innovative new digital
products using your existing capabilities.
3. NORMALIZED, CONSISTENT AND WELL-GOVERNED API CODE AND DOCUMENTATION
The metadata in the abstracted APIs can be used directly to generate normalized
and consistent code, contracts, configuration, and documentation; in formats
that can be used and digested by different runtime systems e.g. API gateways or
code repositories like an SCM configuration.
Alternatively, if only API documentation is needed, this can be generated in
easy-to-read formats like word or excel.
Abstraction also allows your APIs to easily be aligned to an API governance
model upstream in the API lifecycle.
4. FLEXIBILITY ON ALTERNATIVE/FUTURE CODING STANDARDS AND FORMATS
With abstraction, the system of record for your APIs is the Design (pure
abstraction) and Specification (service representation), rather than the runtime
code. This means that the abstracted API can easily be redeployed, and pointed
to a different downstream target, increasing responsiveness for your enterprise
to the ever changing digital landscape, and preventing vendor lock-in.
This flexibility also makes IT modernization efforts easier like legacy SOAP to
REST or wrapping REST in GraphQL, and futureproofs your APIs for whatever
technology or coding standard comes next.
5. ENABLES YOU TO BUILD A HOLISTIC CATALOG OF YOUR API AND SERVICE LANDSCAPE
Once your APIs are abstracted into a common standard, you can organize them and
create types of service (e.g. business capability API, system IT API,
facade/experience API, 3rd party API) and map them to business and technical
taxonomies. You can also record inter-dependencies and relationships (e.g.
lineage and mappings) between your APIs and their versions, as well as
understand their conformance to data models and security policies etc. This
gives you a holistic catalog view of your API landscape; all the different
sources of each API and where they are in the lifecycle, which are suitable for
reuse and can be approved to do so, and which are not reusable and are just
registered into the catalog.
6. EASE OF ABSTRACTED API REPORTING
With abstraction comes easy reporting on API coverage, maturity, governance and
regulatory compliance. This enables better tracking of KPIs and business value
that your APIs are delivering; something which is extremely difficult to do if
your APIs are held in code.
THE IGNITE PLATFORM PROVIDES A UNIQUE ABILITY TO ABSTRACT YOUR APIS AND REAP
THESE BENEFITS
The ignite platform from digitalML provides a holistic API and Service catalog
with extended lifecycle. Your existing APIs and Services can be imported and
automatically abstracted into the common metadata framework we’ve discussed in
this post, along with taxonomies, information models, and business glossaries.
Once you have imported, organized, and normalized your APIs into Designs and
Specifications, ignite’s robust integrations with CI/CD and runtime systems, and
template-driven artifact generation enables you to deploy your APIs directly
from the catalog.
ABOUT THE AUTHOR
GEMMA SINDALL
Hello! I'm Marketing Manager here at digitalML. I'm passionate about creating
content and resources that guides large enterprises to a business-led API
strategy, and helps them leverage APIs to achieve digital market leadership. My
experience spans Marketing and Client Services in the Technology and Financial
Services industries.
RELATED POSTS
Latest Post
5 API VERSIONING BEST PRACTICES
* February 16, 2022
Read More
Latest Post
2022 DIGITAL TRANSFORMATION TRENDS IN LARGE ENTERPRISES [FREE REPORT]
* January 24, 2022
Read More
LEARN THE BEST API PRACTICES AND GET THE LATEST IGNITE UPDATES
Email*
ignite Overview
Request a Trial
SOLUTIONS BY INDUSTRY
* Banking and Payments
* Healthcare
* Insurance
* Travel and Hospitality
* Retail
SOLUTIONS BY ROLE
* Leadership
* Digital Product Owners
* Architects
SOLUTIONS BY GOAL
* Digital Recombination and Product Innovation
* Accelerated IT Modernization
* Self-Service API Governance and Standards at Scale
KNOWLEDGE
* Resources
* Insights
ABOUT
* About Us
* Careers
SUPPORT
* Contact Us
LEARN THE BEST API PRACTICES
& GET THE LATEST IGNITE UPDATES
PRIVACY POLICY
Email*
USA +1 415 373 0300
UK +44 1344 424257
Linkedin-in Twitter Youtube
PRIVACY POLICY
DOWNLOAD LATEST FORRESTER REPORT: API PRODUCT MANAGEMENT IS KEY TO API SUCESS
This report helps ensure that your API strategy has proper direction as you
create thousands of APIs that unlock business capabilities.
Download
USE OF COOKIES
We use cookies to make the website optimal and to continuously improve it. By
continuing to use the site, you consent to the use of cookies. Please refer to
the privacy policy for more information.
Privacy Policy
I Agree