SlideShare a Scribd company logo
1
Jason Harmon
CTO @Stoplight.io
Tips for a Successful API Program
Why You Should Treat
Your APIs as Products
INTERFACE by apidays 2023 - API-as-a-product: The Key to a Successful API Program, Jason Harmon, Stoplight
2
Jason Harmon
Chief Technology Officer, Stoplight
Engineering, Product, Security, IT
Host of #APIIntersection Podcast
Background:
● Previously:
○ Senior Director of Platform Architecture @Expedia Group
○ Chief Platform Officer and CTO at @Typeform
○ Head of API Design @Paypal
○ API Architect @uShip
● Co-founded Austin API Meetup
● Founding member of OpenAPI Initiative
● Founding member of RAML Working Group
3
Stoplight.io - Collaborative
API Design Platform
Design
Mocking
Documentation
Governance
Visibility
Collaboration
Development
4
The Business
Value of APIs
5
“
Why Should Leaders
Care About APIs?
“Over a four-year period that firms using APIs
saw 12.7% more growth in market
capitalization compared to those that did not
adopt APIs”
(+38% growth over a 16-year period)
– Marshall Van Alstyne Forbes, 2021
6
APIs Help Your Business Become Composable
& Adaptable for Transformation
There’s a difference between a composable business and a marketplace.
● Technology leaders should seek a Composable business model.
○ Modularized architecture based on business capabilities,
i.e. “what do we do for customers, in their language?”
● Whereas a Marketplace focuses on supply and demand
connecting consumers and producers.
○ Usually implies composable architecture, but doesn’t
necessarily require it.
○ Understanding network effects is key to building
Marketplaces the right way
7
Ok, so APIs are
important.
How should we treat them?
8
Your API is
just another
product…
Let’s discuss
how to treat
them as such.
9
Treating APIs as a Product
Recognize
Relationships
Gain
Business
Buy-In
Enhance Your
Acceptance
Criteria
10
Recognize
Relationships
11
Identify Relationship Constituents
Step One: Create a customer-centric mindset - know who your customer is
and adopt their needs into your culture.
Step Two: Investigate API usage.
● Analyze data, and talk to power users.
Step Three: Answer these questions:
● Are there integration partners at play, and what is valuable to them?
● Do they need access to customers’ data with consent, or in aggregate?
● Do customers need to get their own data?
● Raw data may not be useful, are there aggregated or calculated aspects?
12
“
Product Managers: Know who the
consumer will be and the business
relationship that you will be building.
If you understand how you're
operating your business, with
adequate success measures, you’re
on your way to building a great API.”
13
One relationship type at a time.
Don’t boil the ocean.
14
Gain Executive
Buy In
15
“
“An API is no different than
an other product.
You need to help traditional
business management into
understanding the relevance
behind the API program.”
16
How to Gain Executive Buy In
● Before Approaching Execs:
→ Ask yourself — how does the API fit into the overall business model?
→ Understand how your revenue is shifting from traditional channels to integrated flows.
● Gaining Buy In: Demonstrating the Value of your API
→ Don’t focus on technical operation measures but on the bigger business picture.
→ Avoid focusing on API calls or operational aspects as a measurement of success.
● Recognize when you're operating a marketplace
→ If APIs are involved there could be some marketplace construct.
→ Thinking in supply and consumption may change your business fundamentals.
17
Most importantly…
18
“
“If you’re not putting the
business perspective around
why you're building APIs, it's
really easy to kill it from a
management POV."
19
If you don’t treat
your APIs as products…
It becomes just a commodity.
A tech artifact.
You end up with an engineered design experience
instead of designing for the end-user.
This is system-centric, not customer-centric.
20
Enhance Your
Acceptance
Criteria
21
Automate Your Signoff
Build Acceptance Criteria
scenarios in customer-
centric language
Repeatable
automated
testing raises the
bar on quality
Automate
by default, no
brittle UX!
22
For more tips
and tricks on the
API space...
23
Check out Stoplight’s
API Intersection Podcast
The podcast on the intersection between
API design and digital transformation.
Available Wherever You Listen to Podcasts
24
Questions?

More Related Content

PDF
INTERFACE by apidays 2023 - API Design Governance, Nauman Ali, Stoplight
PDF
INTERFACE by apidays 2023 - Reverse Engineering Undocumented APIs, Dana Epp, ...
PDF
Richardson Maturity and OpenAPI 3.0
PPTX
Apigee Product Roadmap Part 2
PDF
API Management Solution Powerpoint Presentation Slides
PPTX
API Strategy Introduction
PPTX
API Frenzy: API Strategy 101
PPTX
API Management in Digital Transformation
INTERFACE by apidays 2023 - API Design Governance, Nauman Ali, Stoplight
INTERFACE by apidays 2023 - Reverse Engineering Undocumented APIs, Dana Epp, ...
Richardson Maturity and OpenAPI 3.0
Apigee Product Roadmap Part 2
API Management Solution Powerpoint Presentation Slides
API Strategy Introduction
API Frenzy: API Strategy 101
API Management in Digital Transformation

What's hot (20)

PPSX
APIs as a Product Strategy
PPTX
Apigee Edge Product Demo
PPTX
What do you mean by “API as a Product”?
PDF
Architecting an Enterprise API Management Strategy
PDF
How Secure Are Your APIs?
PDF
API Maturity Model (Webcast with Accenture)
PPTX
API Management Part 1 - An Introduction to Azure API Management
PPTX
Ariba Network Integration for Buyers and Suppliers
PDF
APIsecure 2023 - API orchestration: to build resilient applications, Cherish ...
PDF
Kong API Gateway.pdf
PPTX
Overview of API Management Architectures
PPTX
How to Execute a Successful API Strategy
PDF
Writing REST APIs with OpenAPI and Swagger Ada
PPTX
Api types
PDF
API Management - Why it matters!
PDF
Building and deploying LLM applications with Apache Airflow
PPTX
API Management
PPTX
Monetization: Unlock More Value from Your APIs
PDF
API-first design - Basis for an consistent API-Management approach
PPT
API Strategy Presentation
APIs as a Product Strategy
Apigee Edge Product Demo
What do you mean by “API as a Product”?
Architecting an Enterprise API Management Strategy
How Secure Are Your APIs?
API Maturity Model (Webcast with Accenture)
API Management Part 1 - An Introduction to Azure API Management
Ariba Network Integration for Buyers and Suppliers
APIsecure 2023 - API orchestration: to build resilient applications, Cherish ...
Kong API Gateway.pdf
Overview of API Management Architectures
How to Execute a Successful API Strategy
Writing REST APIs with OpenAPI and Swagger Ada
Api types
API Management - Why it matters!
Building and deploying LLM applications with Apache Airflow
API Management
Monetization: Unlock More Value from Your APIs
API-first design - Basis for an consistent API-Management approach
API Strategy Presentation
Ad

Similar to INTERFACE by apidays 2023 - API-as-a-product: The Key to a Successful API Program, Jason Harmon, Stoplight (20)

PPTX
API-as-a-product: The Key to a Successful API Program
PPTX
API_Strategy_Architecture_Development.pptx
PDF
apidays Helsinki & North 2023 - How can data-driven DevRel help identify gaps...
PDF
5 Things Every Product Leader Needs to Know About API
PDF
SlideShare Test-1
PDF
apidays LIVE Australia 2020 - Building the right API team for right now by Cl...
PDF
Building API Products
PDF
apidays New York 2023 - Governance Doesn't Have to be a Dirty Word, Jason Har...
PPT
Effective API Design
PDF
What is an api, why should you care + the curse of knowledge
PDF
API-Consumption compressed (1)
PDF
API360 – A How-To Guide for Enterprise APIs - Learn how to position your ente...
PDF
I am sorry Developer, your API just became a Product.pdf
PDF
apidays Australia 2022 - Accelerate business innovation by improving API prog...
PDF
apidays Singapore 2025 - From API Intelligence to API Governance by Harsha Ch...
PDF
Introduction to The 6 Insights of API Practice (Bill Doerrfeld)
PDF
apidays LIVE New York 2021 - Design-First: How to champion an API culture shi...
PDF
API Management For Building Software Applications Powerpoint Presentation Slides
PPTX
Why an Innovative Mobile Strategy Requires a Robust API
PPTX
Why an innovative mobile strategy needs a robust API
API-as-a-product: The Key to a Successful API Program
API_Strategy_Architecture_Development.pptx
apidays Helsinki & North 2023 - How can data-driven DevRel help identify gaps...
5 Things Every Product Leader Needs to Know About API
SlideShare Test-1
apidays LIVE Australia 2020 - Building the right API team for right now by Cl...
Building API Products
apidays New York 2023 - Governance Doesn't Have to be a Dirty Word, Jason Har...
Effective API Design
What is an api, why should you care + the curse of knowledge
API-Consumption compressed (1)
API360 – A How-To Guide for Enterprise APIs - Learn how to position your ente...
I am sorry Developer, your API just became a Product.pdf
apidays Australia 2022 - Accelerate business innovation by improving API prog...
apidays Singapore 2025 - From API Intelligence to API Governance by Harsha Ch...
Introduction to The 6 Insights of API Practice (Bill Doerrfeld)
apidays LIVE New York 2021 - Design-First: How to champion an API culture shi...
API Management For Building Software Applications Powerpoint Presentation Slides
Why an Innovative Mobile Strategy Requires a Robust API
Why an innovative mobile strategy needs a robust API
Ad

More from apidays (20)

PDF
apidays Munich 2025 - The Physics of Requirement Sciences Through Application...
PDF
apidays Munich 2025 - Developer Portals, API Catalogs, and Marketplaces, Miri...
PDF
apidays Munich 2025 - Making Sense of AI-Ready APIs in a Buzzword World, Andr...
PDF
apidays Munich 2025 - Integrate Your APIs into the New AI Marketplace, Senthi...
PDF
apidays Munich 2025 - The Double Life of the API Product Manager, Emmanuel Pa...
PDF
apidays Munich 2025 - Let’s build, debug and test a magic MCP server in Postm...
PDF
apidays Munich 2025 - The life-changing magic of great API docs, Jens Fischer...
PDF
apidays Munich 2025 - Automating Operations Without Reinventing the Wheel, Ma...
PDF
apidays Munich 2025 - Geospatial Artificial Intelligence (GeoAI) with OGC API...
PPTX
apidays Munich 2025 - GraphQL 101: I won't REST, until you GraphQL, Surbhi Si...
PPTX
apidays Munich 2025 - Effectively incorporating API Security into the overall...
PPTX
apidays Munich 2025 - Federated API Management and Governance, Vince Baker (D...
PPTX
apidays Munich 2025 - Agentic AI: A Friend or Foe?, Merja Kajava (Aavista Oy)
PPTX
apidays Munich 2025 - Streamline & Secure LLM Traffic with APISIX AI Gateway ...
PPTX
apidays Munich 2025 - Building Telco-Aware Apps with Open Gateway APIs, Subhr...
PPTX
apidays Munich 2025 - Building an AWS Serverless Application with Terraform, ...
PDF
apidays Helsinki & North 2025 - REST in Peace? Hunting the Dominant Design fo...
PDF
apidays Helsinki & North 2025 - Monetizing AI APIs: The New API Economy, Alla...
PDF
apidays Helsinki & North 2025 - How (not) to run a Graphql Stewardship Group,...
PDF
apidays Helsinki & North 2025 - APIs in the healthcare sector: hospitals inte...
apidays Munich 2025 - The Physics of Requirement Sciences Through Application...
apidays Munich 2025 - Developer Portals, API Catalogs, and Marketplaces, Miri...
apidays Munich 2025 - Making Sense of AI-Ready APIs in a Buzzword World, Andr...
apidays Munich 2025 - Integrate Your APIs into the New AI Marketplace, Senthi...
apidays Munich 2025 - The Double Life of the API Product Manager, Emmanuel Pa...
apidays Munich 2025 - Let’s build, debug and test a magic MCP server in Postm...
apidays Munich 2025 - The life-changing magic of great API docs, Jens Fischer...
apidays Munich 2025 - Automating Operations Without Reinventing the Wheel, Ma...
apidays Munich 2025 - Geospatial Artificial Intelligence (GeoAI) with OGC API...
apidays Munich 2025 - GraphQL 101: I won't REST, until you GraphQL, Surbhi Si...
apidays Munich 2025 - Effectively incorporating API Security into the overall...
apidays Munich 2025 - Federated API Management and Governance, Vince Baker (D...
apidays Munich 2025 - Agentic AI: A Friend or Foe?, Merja Kajava (Aavista Oy)
apidays Munich 2025 - Streamline & Secure LLM Traffic with APISIX AI Gateway ...
apidays Munich 2025 - Building Telco-Aware Apps with Open Gateway APIs, Subhr...
apidays Munich 2025 - Building an AWS Serverless Application with Terraform, ...
apidays Helsinki & North 2025 - REST in Peace? Hunting the Dominant Design fo...
apidays Helsinki & North 2025 - Monetizing AI APIs: The New API Economy, Alla...
apidays Helsinki & North 2025 - How (not) to run a Graphql Stewardship Group,...
apidays Helsinki & North 2025 - APIs in the healthcare sector: hospitals inte...

Recently uploaded (20)

PDF
Lecture1 pattern recognition............
PDF
Capcut Pro Crack For PC Latest Version {Fully Unlocked 2025}
PDF
.pdf is not working space design for the following data for the following dat...
PPTX
Supervised vs unsupervised machine learning algorithms
PDF
Data Engineering Interview Questions & Answers Cloud Data Stacks (AWS, Azure,...
PDF
Transcultural that can help you someday.
PPTX
Introduction to Knowledge Engineering Part 1
PPT
ISS -ESG Data flows What is ESG and HowHow
PPTX
AI Strategy room jwfjksfksfjsjsjsjsjfsjfsj
PDF
168300704-gasification-ppt.pdfhghhhsjsjhsuxush
PPTX
Database Infoormation System (DBIS).pptx
PPTX
iec ppt-1 pptx icmr ppt on rehabilitation.pptx
PDF
Mega Projects Data Mega Projects Data
PPTX
oil_refinery_comprehensive_20250804084928 (1).pptx
PPT
Predictive modeling basics in data cleaning process
PPTX
Computer network topology notes for revision
PDF
Business Analytics and business intelligence.pdf
PPTX
Microsoft-Fabric-Unifying-Analytics-for-the-Modern-Enterprise Solution.pptx
PDF
[EN] Industrial Machine Downtime Prediction
PPTX
Introduction-to-Cloud-ComputingFinal.pptx
Lecture1 pattern recognition............
Capcut Pro Crack For PC Latest Version {Fully Unlocked 2025}
.pdf is not working space design for the following data for the following dat...
Supervised vs unsupervised machine learning algorithms
Data Engineering Interview Questions & Answers Cloud Data Stacks (AWS, Azure,...
Transcultural that can help you someday.
Introduction to Knowledge Engineering Part 1
ISS -ESG Data flows What is ESG and HowHow
AI Strategy room jwfjksfksfjsjsjsjsjfsjfsj
168300704-gasification-ppt.pdfhghhhsjsjhsuxush
Database Infoormation System (DBIS).pptx
iec ppt-1 pptx icmr ppt on rehabilitation.pptx
Mega Projects Data Mega Projects Data
oil_refinery_comprehensive_20250804084928 (1).pptx
Predictive modeling basics in data cleaning process
Computer network topology notes for revision
Business Analytics and business intelligence.pdf
Microsoft-Fabric-Unifying-Analytics-for-the-Modern-Enterprise Solution.pptx
[EN] Industrial Machine Downtime Prediction
Introduction-to-Cloud-ComputingFinal.pptx

INTERFACE by apidays 2023 - API-as-a-product: The Key to a Successful API Program, Jason Harmon, Stoplight

  • 1. 1 Jason Harmon CTO @Stoplight.io Tips for a Successful API Program Why You Should Treat Your APIs as Products
  • 3. 2 Jason Harmon Chief Technology Officer, Stoplight Engineering, Product, Security, IT Host of #APIIntersection Podcast Background: ● Previously: ○ Senior Director of Platform Architecture @Expedia Group ○ Chief Platform Officer and CTO at @Typeform ○ Head of API Design @Paypal ○ API Architect @uShip ● Co-founded Austin API Meetup ● Founding member of OpenAPI Initiative ● Founding member of RAML Working Group
  • 4. 3 Stoplight.io - Collaborative API Design Platform Design Mocking Documentation Governance Visibility Collaboration Development
  • 6. 5 “ Why Should Leaders Care About APIs? “Over a four-year period that firms using APIs saw 12.7% more growth in market capitalization compared to those that did not adopt APIs” (+38% growth over a 16-year period) – Marshall Van Alstyne Forbes, 2021
  • 7. 6 APIs Help Your Business Become Composable & Adaptable for Transformation There’s a difference between a composable business and a marketplace. ● Technology leaders should seek a Composable business model. ○ Modularized architecture based on business capabilities, i.e. “what do we do for customers, in their language?” ● Whereas a Marketplace focuses on supply and demand connecting consumers and producers. ○ Usually implies composable architecture, but doesn’t necessarily require it. ○ Understanding network effects is key to building Marketplaces the right way
  • 8. 7 Ok, so APIs are important. How should we treat them?
  • 9. 8 Your API is just another product… Let’s discuss how to treat them as such.
  • 10. 9 Treating APIs as a Product Recognize Relationships Gain Business Buy-In Enhance Your Acceptance Criteria
  • 12. 11 Identify Relationship Constituents Step One: Create a customer-centric mindset - know who your customer is and adopt their needs into your culture. Step Two: Investigate API usage. ● Analyze data, and talk to power users. Step Three: Answer these questions: ● Are there integration partners at play, and what is valuable to them? ● Do they need access to customers’ data with consent, or in aggregate? ● Do customers need to get their own data? ● Raw data may not be useful, are there aggregated or calculated aspects?
  • 13. 12 “ Product Managers: Know who the consumer will be and the business relationship that you will be building. If you understand how you're operating your business, with adequate success measures, you’re on your way to building a great API.”
  • 14. 13 One relationship type at a time. Don’t boil the ocean.
  • 16. 15 “ “An API is no different than an other product. You need to help traditional business management into understanding the relevance behind the API program.”
  • 17. 16 How to Gain Executive Buy In ● Before Approaching Execs: → Ask yourself — how does the API fit into the overall business model? → Understand how your revenue is shifting from traditional channels to integrated flows. ● Gaining Buy In: Demonstrating the Value of your API → Don’t focus on technical operation measures but on the bigger business picture. → Avoid focusing on API calls or operational aspects as a measurement of success. ● Recognize when you're operating a marketplace → If APIs are involved there could be some marketplace construct. → Thinking in supply and consumption may change your business fundamentals.
  • 19. 18 “ “If you’re not putting the business perspective around why you're building APIs, it's really easy to kill it from a management POV."
  • 20. 19 If you don’t treat your APIs as products… It becomes just a commodity. A tech artifact. You end up with an engineered design experience instead of designing for the end-user. This is system-centric, not customer-centric.
  • 22. 21 Automate Your Signoff Build Acceptance Criteria scenarios in customer- centric language Repeatable automated testing raises the bar on quality Automate by default, no brittle UX!
  • 23. 22 For more tips and tricks on the API space...
  • 24. 23 Check out Stoplight’s API Intersection Podcast The podcast on the intersection between API design and digital transformation. Available Wherever You Listen to Podcasts