Professional Documents
Culture Documents
API Management: An Architect's Guide to Developing and Managing APIs for Your Organization 2nd Edition Brajesh De full chapter instant download
API Management: An Architect's Guide to Developing and Managing APIs for Your Organization 2nd Edition Brajesh De full chapter instant download
https://ebookmass.com/product/postman-for-api-testing-a-
beginners-guide-learn-to-test-apis-like-a-pro-with-postman-with-
real-world-examples-and-step-by-step-guidance-parvin/
https://ebookmass.com/product/conflict-management-a-practical-
guide-to-developing-negotiation-strategies-barbara-a-budjac-
corvette/
https://ebookmass.com/product/managing-your-money-all-in-one-for-
dummies-2nd-edition-the-experts-at-dummies/
https://ebookmass.com/product/chatgpt-for-java-a-hands-on-
developers-guide-to-chatgpt-and-open-ai-apis-bruce-hopkins/
Excellence in Human Service Organization Management,
(Standards for Excellence Series) 2nd Edition – Ebook
PDF Version
https://ebookmass.com/product/excellence-in-human-service-
organization-management-standards-for-excellence-series-2nd-
edition-ebook-pdf-version/
https://ebookmass.com/product/chatgpt-for-java-a-hands-on-
developers-guide-to-chatgpt-and-open-ai-apis-1st-edition-bruce-
hopkins/
https://ebookmass.com/product/chatgpt-for-java-a-hands-on-
developers-guide-to-chatgpt-and-open-ai-apis-1st-edition-bruce-
hopkins-2/
https://ebookmass.com/product/dental-practice-transition-a-
practical-guide-to-management-2nd-edition/
https://ebookmass.com/product/building-an-api-product-design-
implement-and-release-api-products-that-meet-user-needs-pedro/
API Management
An Architect’s Guide
to Developing and Managing
APIs for Your Organization
Second Edition
Brajesh De
API Management: An Architect’s Guide to Developing and Managing APIs
for Your Organization
Brajesh De
Bangalore, Karnataka, India
v
Table of Contents
Developer Portal��������������������������������������������������������������������������������������������43
API Lifecycle Management����������������������������������������������������������������������������������45
API Creation���������������������������������������������������������������������������������������������������45
API Publication����������������������������������������������������������������������������������������������46
Version Management�������������������������������������������������������������������������������������46
Change Notification���������������������������������������������������������������������������������������46
Issue Management����������������������������������������������������������������������������������������47
vi
Table of Contents
vii
Table of Contents
viii
Table of Contents
ix
Table of Contents
x
Table of Contents
xi
Table of Contents
xii
Table of Contents
Social Forums����������������������������������������������������������������������������������������������290
Federated Developer Communities�������������������������������������������������������������291
Developer Portal Users�������������������������������������������������������������������������������������292
API Developer Portal Features��������������������������������������������������������������������������295
The Relationship Between a Developer Portal and an API Gateway�����������������299
Developer Portal Deployment Patterns�������������������������������������������������������������299
xiii
Table of Contents
xiv
Table of Contents
xv
Table of Contents
Index�������������������������������������������������������������������������������������������������413
xvi
About the Author
Brajesh De is the global lead for API
Management and Integration, and Digital
Application Development capabilities at Blue
Altair.
He has over 25 years of experience in
delivering large scale digital transformation
projects with expertise in technology
leadership, consulting, architecture, design,
and implementation. He has architected and
designed several distributed, cloud native, highly-scalable and secure
applications leveraging API-Led architecture on cloud involving large
scale data transformation. He acquired professional cloud certifications on
both AWS and GCP. He is also expert in architecting security solutions and
possess MIT Application Security Architect certification.
Prior to joining Blue Altair, he was capability lead for API,
Microservices, and Cloud Native Technologies at Accenture, where he was
primarily responsible for supporting sales, delivery, thought leadership,
and building reusable delivery assets and accelerators. During his tenure
with Accenture, he obtained the highly coveted ‘Master Technology
Architect’ certification offered by Accenture. Earlier, he worked with
companies like Apigee, Dell and Wipro leading some of their large scale
digital transformation and integration programs.
He also holds two published patents across multiple countries for his
work in API Assessment and Data Intelligence. He received his bachelor’s
degree in Electrical Engineering from IIT-BHU Varanasi and was the
recipient of multiple university gold medals during his tenure.
xvii
About the Technical
Reviewers
Chandresh Pancholi is SDE-3 at nnnow.com (Arvind Internet group).
Prior to that, he worked with Flipkart Internet Pvt. Ltd. as a senior software
developer. He has worked on multiple back-end frameworks like Spring,
Dropwizard, Flask, Golang, and Spring Boot. Chandresh graduated from
LNMIIT, Jaipur, and received a master’s degree from BITS, Pilani. He is also
a keen contributor to Apache open source foundations projects.
xix
CHAPTER 1
Introduction to APIs
An Application programming interface (API) exposes a business service
or an enterprise asset to the application developers. Applications can be
installed and accessed from a variety of devices, such as smartphones,
tablets, kiosks, gaming consoles, connected cars, and so forth. Google
Maps APIs for locating a place on a map, Facebook APIs for gaming or
sharing content, and Amazon APIs for product information are some
examples of APIs. Developers use these APIs to build cool and innovative
apps that enrich the user experience. For example, developers can use
APIs from different travel companies to build an app that compares and
displays each travel company’s price for the same hotel. A user can then
make an informed decision and book the hotel through the company
providing the best offer. This saves users from comparing on their own—
thus improving the overall experience. APIs thus provide an improved user
experience.
An API is a software-to-software interface that defines the contract for
applications to talk to each other over a network without user interaction.
When you book a hotel room online from a travel portal with your credit
card, the travel portal/application sends your booking information to the
hotel’s reservation system to block the room. It also sends the credit card
information to a payment application. The payment application interacts
with a remote banking application to validate the credit card details
and process the payment. If the processing is successful, the hotel room
is reserved for you. The interaction of the travel portal with the hotel’s
reservation system and the payment application both use APIs.
© Brajesh De 2023 1
B. De, API Management, https://doi.org/10.1007/979-8-8688-0054-2_1
Chapter 1 Introduction to APIs
As a user, you see only one interaction to collect the booking and credit
card information. But behind the scenes, the applications work together
using APIs. An API does this by “exposing” some of the business functions
to the outside world in a limited fashion. That makes it possible to share
business services, assets, and data so that other applications can easily
consume without sharing the code base. APIs can be thought of as
windows to the code base. They clearly define how a program interacts
with the rest of the software application—saving time and resources and
avoiding potential legal entanglements. The API contract defines how the
service is provided by the provider and consumed by a consumer. The
contract can include the definition and terms of service, SLAs like uptime/
availability, licensing agreements for service usage and pricing, and the
support model.
Consumer Applications
Network
The contract defines the protocol, the input and output formats,
and the underlying data types for the software components to interact.
It defines the functionality independent of the component’s underlying
2
Another random document with
no related content on Scribd:
Escena VII
(Els mateixos, més la Madrona)
Madrona Aon?
Fidel De què?
Fidel Sí.
Fidel No vau quedar amb aquell senyor que vindria per allà a les
onze?
Xic Anem.
Boira Salut, nois! (En Fidel i el Xic desapareixen per la primera porta
de la dreta.)
Escena VIII
(La Madrona i en Boira)
Madrona (després d’un curt silenci) Me temo que en Fidel farà tard
expressament.
Boira Quan ell ha dit que tornarà aviat, ja s’hi pot pujar de peus. De
formal ho és!
Passarell Lo que?
Boira Home, deixa-m explicar… Entre l’un i l’altre me feu anar com
una llençadora.
Passarell Tu, sempre penses com jo; però ara, no sé, me sembla que
si gosessis me faries la contra.
Boira Qui sap lo que un hom faria!
Passarell (amb ironia i indignació) Ah, ja! Tu vols dir que en comptes
de viure com nosaltres, nosaltres, a costa d’ella…
Passarell (am sarcasme) Diria que som dos pobres treballadors. Com
l’alabarien, encara!
Passarell (energicament) Jo’t dic que sí! Som més, però molt més!
Boira Jo?
Passarell Sí! I, si no, veiam, digues: ¿qui és més mare d’un noi: la
dòna que’l posa al món i el llença, o aquella que’l recull?
Boira Els drets de la Madrona són d’una mena, i els d’aquella senyora
d’una altra.
Passarell Això seria fer negoci amb el noi! Seria pitjor que vendre-l!
Passarell Prou se l’hauria tret del davant desseguida. Sinó que, amb
allò del passament, li va posar la mèl a la boca, i, noi, és tant dolça la
mèl!…
Passarell (am molta emoció) Sí, que m’hi afecto, sí! Me fa rabia que
la Madrona no’m cregui!
Boira Vols dir que en Fidel tindrà un cor tant petit que no vulga
regonèixer la seva mare?
Boira Digues.
Boira No sé si parlant-li…
Passarell Per ell no hi ha més mare que ta germana, ni més pare que
jo. Això no s’ho calla mai! (Excitant-se.) I, si’m contradius, mai més
vui tractes am tu! A tu no t’escau contradir-me!
Passarell Doncs per què no’m dones la raó? Que no ho veus que la
tinc tota?
Passarell Sí: m’hi enfondo perquè m’agradaria que tot-hom fes com
jo. Ja saps que no m’he vengut mai la dignitat. Es una joia que me
l’estimo molt, però molt! Que’t consti! (Torna la Madrona per la
primera porta de l’esquerra. Està molt trista.)
Escena XI
(Els mateixos, més la Madrona)
Boira Doncs, sent així, tot xano, xano, me’n aniré a veure què diu la
pagesa de casa.
Boira Visca!
Boira (am molta fruició) A casa també. Aquella m’ha promès que’m
faria un arrocet amb una mica de peix, i ja voldria ser-hi.
Madrona Igualment.
Boira Entesos.
Madrona Adéu, noi. (En Boira se’n va, apesarat, brandant el cap, per
la primera porta de la dreta.)