Table Of Content.d
e
vre
se
r sth
g
ir llA
.d
e
tim
iL
,g
n
ih
silb
u
P
tkca
P
.9
1
0
2
©
th
g
iryp
o
C
Weir, Luis, and Nemec, Zdenek "Z". Enterprise API Management : Design and Deliver Valuable Business APIs, Packt Publishing, Limited, 2019. ProQuest Ebook
Central, http://ebookcentral.proquest.com/lib/nyulibrary-ebooks/detail.action?docID=5839366.
Created from nyulibrary-ebooks on 2022-10-16 18:59:52.
Enterprise API Management
Design and deliver valuable business APIs
Luis Weir
.d
e
vre
se
r sth
g
ir llA
.d
e
tim
iL
,g
n
ih
silb
u
P
tkca
P
.91 BIRMINGHAM - MUMBAI
0
2
©
th
g
iryp
o
C
Weir, Luis, and Nemec, Zdenek "Z". Enterprise API Management : Design and Deliver Valuable Business APIs, Packt Publishing, Limited, 2019. ProQuest Ebook
Central, http://ebookcentral.proquest.com/lib/nyulibrary-ebooks/detail.action?docID=5839366.
Created from nyulibrary-ebooks on 2022-10-16 18:59:52.
Enterprise API Management
Copyright © 2019 Packt Publishing
All rights reserved. No part of this book may be reproduced, stored in a retrieval system, or transmitted in any form
or by any means, without the prior written permission of the publisher, except in the case of brief quotations
embedded in critical articles or reviews.
Every effort has been made in the preparation of this book to ensure the accuracy of the information presented.
However, the information contained in this book is sold without warranty, either express or implied. Neither the
author, nor Packt Publishing or its dealers and distributors, will be held liable for any damages caused or alleged to
have been caused directly or indirectly by this book.
Packt Publishing has endeavored to provide trademark information about all of the companies and products
mentioned in this book by the appropriate use of capitals. However, Packt Publishing cannot guarantee the accuracy
of this information.
Acquisition Editor: Dominic Shakeshaft
Acquisition Editor – Peer Reviews: Suresh Jain
Project Editor: Kishor Rit
Development Editor: Joanne Lovell
Technical Editor: Aniket Shetty
Proofreader: Safis Editing
Indexer: Pratik Shirodkar
Production Designer: Sandip Tadge
First published: July 2019
Production reference: 4091019
Published by Packt Publishing Ltd.
.d Livery Place
evre 35 Livery Street
se Birmingham
r sth B3 2PB, UK.
g
ir llA
.de ISBN 978-1-78728-443-2
tim
iL
,g
nih www.packtpub.com
silb
u
P
tkca
P
.9
1
0
2
©
th
g
iryp
o
C
Weir, Luis, and Nemec, Zdenek "Z". Enterprise API Management : Design and Deliver Valuable Business APIs, Packt Publishing, Limited, 2019. ProQuest Ebook
Central, http://ebookcentral.proquest.com/lib/nyulibrary-ebooks/detail.action?docID=5839366.
Created from nyulibrary-ebooks on 2022-10-16 18:59:52.
Packt.com
Subscribe to our online digital library for full access to over 7,000 books and videos, as well
as industry leading tools to help you plan your personal development and advance your
career. For more information, please visit our website.
Why subscribe?
Spend less time learning and more time coding with practical eBooks and Videos
from over 4,000 industry professionals
Improve your learning with Skill Plans built especially for you
Get a free eBook or video every month
Fully searchable for easy access to vital information
Copy and paste, print, and bookmark content
Did you know that Packt offers eBook versions of every book published, with PDF and
ePub files available? You can upgrade to the eBook version at www.packt.com and as a print
book customer, you are entitled to a discount on the eBook copy. Get in touch with us at
.d [email protected] for more details.
e
vre
se At www.packt.com, you can also read a collection of free technical articles, sign up for a
r sthg range of free newsletters, and receive exclusive discounts and offers on Packt books and
ir llA eBooks.
.d
e
tim
iL
,g
n
ih
silb
u
P
tkca
P
.9
1
0
2
©
th
g
iryp
o
C
Weir, Luis, and Nemec, Zdenek "Z". Enterprise API Management : Design and Deliver Valuable Business APIs, Packt Publishing, Limited, 2019. ProQuest Ebook
Central, http://ebookcentral.proquest.com/lib/nyulibrary-ebooks/detail.action?docID=5839366.
Created from nyulibrary-ebooks on 2022-10-16 18:59:52.
Foreword
Do you remember the days when businesses were considering whether they should invest
in a website? Would building an online presence have any impact on their bottom line?
Getting on the web merely involved moving from the Yellow Pages and printed
advertisements to a new channel. But this still left the potential of offering every business
capability digitally untapped.
The web revolution was a kick-start for the next era for businesses – digital transformation.
And APIs are the connective fabric of this much-debated digital transformation. Under API
transformation, you deliver your organizational capabilities – your products – via APIs.
Your communication, information exchange, innovation, and adaptation to ever-changing
market conditions happens through well-laid-out APIs. The APIs become the backbone of
your company. You can even leverage your partner sales channels with the right APIs!
API transformation does not start with building APIs, which were previously the technical
creations of engineers. It begins with changing the mindset of the entire organization. It
means embracing the culture of API first.
API first implies that everything produced and consumed in the organization is, and has,
an API. Companies such as Adidas, DHL, or Volkswagen have already embarked on the
API-first journey. Do you ever wonder whether there is an API for Adidas Stan Smith
Sneakers? There is, and not just one! Adidas product, order, inventory, and other APIs are
all about physical products. Every product has an API!
And we are still only scratching the surface. APIs no longer live isolated in silos; they are
forming landscapes on every level: team, organization, domain, and even cross-domain. In
the coming years, autonomous APIs will completely change how we discover, close, and
.d
evre implement deals. How do you find the best logistics service to ship a container from
se Wakkanai Port every month? What if you can perform this search and make the order in a
r sthg fraction of a second? What if you can look for and close better deals a thousand times a
ir llA day? Do you still think that, in 10 years' time, businesses will be asking whether they
.d
etim should invest in APIs?
iL
,g
n Of course, embarking on an API journey requires preparation, learning new skills, and
ih
silb avoiding roadblocks. Many organizations naively start with the purchase of an expensive
u
P
tkca API solution in the hope of getting on the right track, only to later find themselves in a
P .9 vendor lock-in trap, with a lack of product ownership and the infamous pitfall of "build it
1
0 (an API), and they will come."
2
©
th
g
iryp
o
C
Weir, Luis, and Nemec, Zdenek "Z". Enterprise API Management : Design and Deliver Valuable Business APIs, Packt Publishing, Limited, 2019. ProQuest Ebook
Central, http://ebookcentral.proquest.com/lib/nyulibrary-ebooks/detail.action?docID=5839366.
Created from nyulibrary-ebooks on 2022-10-16 18:59:52.
Executing a successful API transformation is a matter of building upon the three pillars:
business, organization, and technology. Ignore one of them, and the project will fail. Each
pillar has to understand the role and importance of APIs, rally under the API-first flag and
carefully plan the API strategy. Only when all three elements are acting together can you
hope for a prosperous API landscape.
This book will take you on an API journey that avoids common traps. It is the handbook for
every API program owner, enterprise architect, and forward-thinking business person.
Wherever you are, I am sure this book will prove to be an excellent companion.
The author (Luis) does an incredible job of explaining the business aspects of APIs in
chapters one, three, and eight, while providing a great deal of technical background in
chapter two, and then building on these foundations with architectural and technological
concepts in the subsequent sections. The learning process then culminates in chapter seven,
which presents the framework for the API life cycle process before closing with the grand
finale on API products, business, and organizational impacts.
This book is the missing API manual for everybody interested in executing API
transformation. It provides a holistic, concise look at the business, organization, and
technical aspects of APIs like no other book before it.
API styles, tools, and vendors come and go. However, the concepts as presented in this
book will help you to create a culture and values that last.
Good luck on your API journey!
Zdenek "Z" Nemec
Founder of Good API Consulting, and the author of API Blueprint and supermodel.io
.d
e
vre
se
r sth
g
ir llA
.d
e
tim
iL
,g
n
ih
silb
u
P
tkca
P
.9
1
0
2
©
th
g
iryp
o
C
Weir, Luis, and Nemec, Zdenek "Z". Enterprise API Management : Design and Deliver Valuable Business APIs, Packt Publishing, Limited, 2019. ProQuest Ebook
Central, http://ebookcentral.proquest.com/lib/nyulibrary-ebooks/detail.action?docID=5839366.
Created from nyulibrary-ebooks on 2022-10-16 18:59:52.
Contributors
About the author
Luis Augusto Weir is a director of software development at Oracle and a former chief
architect at Capgemini, Oracle Ace Director, and Oracle Groundbreaker Ambassador. An
API management and microservices evangelist, Luis has over 17 years' experience in
implementing complex distributed systems around the world.
Having always had a natural talent for software, computers, and engineering in general,
Luis' career in software began from an early age. Even before starting university, Luis'
entrepreneurial spirit led him to start several ventures, including one of the very first social
media websites in his country of origin (Venezuela), as well as a small software
development firm. Although none of these ventures turned into multi-million
dollar corporations, the experience and knowledge gained during this period led him to
develop a passion for distributed software computing that inevitably led to service-oriented
architectures (SOA).
In recent years, Luis has been helping some of the largest Fortune 500 companies in
industries such as retail, the supply chain, and agriculture to define and implement their
API and microservice strategies, his experience of which served as a foundation for this
book.
A co-author of three other books as well as numerous articles and white papers, Luis has
been a frequent speaker at events such as CodeOne, Devoxx, Gartner AAD&I, Oracle
OpenWorld, Java2Days, and many user groups and meetups.
.de Luis holds an MS in corporate networks and systems integration from the Universitat
vre
se Politecnica de Valencia (UPV) and a BS in electronics engineering from the Universidad
r sth Nueva Esparta.
g
ir llA
.d
e
tim
iL
,g
n
ih
silb
u
P
tkca
P
.9
1
0
2
©
th
g
iryp
o
C
Weir, Luis, and Nemec, Zdenek "Z". Enterprise API Management : Design and Deliver Valuable Business APIs, Packt Publishing, Limited, 2019. ProQuest Ebook
Central, http://ebookcentral.proquest.com/lib/nyulibrary-ebooks/detail.action?docID=5839366.
Created from nyulibrary-ebooks on 2022-10-16 18:59:52.
I want to dedicate this book to my beautiful family: my wife, Elena, and my three gorgeous
daughters, Helena, Clara, and Alicia. Thank you once again for allowing dad to be stuck at
a computer when I could have been spending time with you. I would also like to give
special thanks to all the co-authors and editors of this book.
.d
e
vre
se
r sth
g
ir llA
.d
e
tim
iL
,g
n
ih
silb
u
P
tkca
P
.9
1
0
2
©
th
g
iryp
o
C
Weir, Luis, and Nemec, Zdenek "Z". Enterprise API Management : Design and Deliver Valuable Business APIs, Packt Publishing, Limited, 2019. ProQuest Ebook
Central, http://ebookcentral.proquest.com/lib/nyulibrary-ebooks/detail.action?docID=5839366.
Created from nyulibrary-ebooks on 2022-10-16 18:59:52.
About the reviewers
Phil Wilkins has spent over 30 years in the software industry, acquiring a wealth of
experience in different businesses and environments, from multinationals to software start-
ups, and from customer organizations to specialist consulting. He started out as a
developer on real-time, mission-critical solutions, and has worked his way up through
technical and development leadership roles, primarily in Java-based environments.
He now works for Capgemini's multi-award-winning team specializing in cloud integration
and API technologies and, more generally, with Oracle technologies.
Phil has contributed his knowledge and experience by providing input and support to the
development of technical books (particularly with Packt Publishing), including co-
authoring Implementing Oracle Integration Cloud Service, and Implementing Oracle API
Platform, as well as online training on API best practices.
In addition to this, he has also had articles published in technical journals and is an active
blogger. He has presented at a broad range of industry events, from large conferences
around the world to user group and developer meetups. Phil’s expertise and contributions
to the Oracle community have been acknowledged by Oracle by accrediting him as an
Oracle Ace.
I would like to thank Luis Weir for the opportunity to contribute to this book, and for the
time we spent working and presenting together at Capgemini. I would also like to take this
opportunity to thank my wife, Catherine, and our two sons, Christopher and Aaron, for
their understanding, given that many of the contributions I make to books and other
activities mean spending extra hours in front of a computer.
.d
e
vre
se
r sth
g
ir llA
.d
e
tim
iL
,g
n
ih
silb
u
P
tkca
P
.9
1
0
2
©
th
g
iryp
o
C
Weir, Luis, and Nemec, Zdenek "Z". Enterprise API Management : Design and Deliver Valuable Business APIs, Packt Publishing, Limited, 2019. ProQuest Ebook
Central, http://ebookcentral.proquest.com/lib/nyulibrary-ebooks/detail.action?docID=5839366.
Created from nyulibrary-ebooks on 2022-10-16 18:59:52.
Kshitij Mehrotra is an expert and thought leader in "digital transformation" with extensive
experience in APIs, cloud applications, SOA, analytics, security, business activity
monitoring (BAM), and business process management (BPM). He has helped several
customers and employers to define and execute transformation and growth strategies by
recommending the right architecture and validating strategic investment in a variety of
technologies most relevant to customers' requirements.
Kshitij shares his experience with customers, helping them to shape digital initiatives and
highlighting pitfalls that could affect implementation, as well as identifying the digital tools
and technologies designed to ensure that the program is aligned with the businesses'
strategy.
A blogger and speaker, he is Axway’s chief architect for platforms and products. He has
more than 19 years' experience of implementing solutions across the world and has
successfully delivered large and complex digital and SOA solutions to Fortune 500
companies.
He has led middleware programs for renowned organizations, including Oracle
Consulting, Wipro, and HCL Axon.
Thanks to everyone who inspired me to contribute to this book. And special thanks to my
parents and family.
.d
e
vre
se
r sth
g
ir llA
.d
e
tim
iL
,g
n
ih
silb
u
P
tkca
P
.9
1
0
2
©
th
g
iryp
o
C
Weir, Luis, and Nemec, Zdenek "Z". Enterprise API Management : Design and Deliver Valuable Business APIs, Packt Publishing, Limited, 2019. ProQuest Ebook
Central, http://ebookcentral.proquest.com/lib/nyulibrary-ebooks/detail.action?docID=5839366.
Created from nyulibrary-ebooks on 2022-10-16 18:59:52.
