SlideShare a Scribd company logo
1 of 45
Download to read offline
You don’t need SDKs,
wait maybe you do!
Sid Maestre
APIMatic
VP Developer Relations
The Truth
… another Truth
Other signals you may not need SDKs
● You are still proving the value of your API
● You only plan to service a handful of developers
● You don’t have many endpoints and simple data structures.
● You don’t have strong competitors
● Your offering is so compelling developers are willing to put in extra effort.
● Target users don’t use SDKs (10x engineers or low code/no code)
… wait, what about
Section Title | #
… what is an SDK?
Code Samples
Code Library
Use Case Guides
SDK Reference
Sample App
Getting Started
… why do developers want SDKs?
Stripe’s server-side helper libraries (also
known as server-side SDKs) reduce the
amount of work required to use Stripe’s
REST APIs, starting with reducing the
boilerplate code you have to write.
❝
❞
reduce complexity
OpenID and JWTs
Multipart MIME
API changes
Package managers
state of “flow”
Inline docs, hinting, code completion
API (w)rappers
Over 50% of support inquires were
authentication related
Our forums filled with developers sharing
code snippets and trying to help each
other.
More API wrappers built by community
and shared on GitHub - but they weren’t
well maintained.
Headaches all around
Signals we needed SDKs
● Time to first Hello World is subpar
● High support burden
● Developers asking for examples in different languages
● Community building their own libraries
● Key accounts are asking for SDKs
● Your competition have SDKs and offer a superior DX
Photo by Daniel Cartin on Unsplash
Where to start today?
What make a “good” SDK?
SDKs that are easy to use
● Implement a REST-agnostic design
● Design Consistent SDKs
SDKs that come with docs
● Create SDK specific documentation
● Provide Sample Code
SDKs that match the API
● Ensure API Coverage
● Provide End-to-End Typing
SDKs that work
● Create a Test Suite
● Share Test Coverage Reports
SDKs that are robust
● Transient Error Policy
● API Error Policy
SDKs that receive updates
● Timely API Updates
● Security & Maintenance Updates
SDKs that have support
● Handle support tickets
● Engage with the community
Who’s gonna build your
SDK program
● Architect or Program Lead
● Developers to create the SDKs in each language
● Content writers to create documentation
● Support staff who handle support tickets
● Developer(s) who owns SDK updates when API changes,
language changes, bug fixes, and dependency updates
● Developer Relations team or person to engage with the
community on SDK and API roadmap and their experience
Ways to Build SDKs
● Homegrown or Handwritten
● Open source code generators
● Commercial code generators
Recap
● SDKs are more than code libraries
● SDKs reduce boilerplate code, complexity, help with change
management and developer achieve “flow”
● Every API doesn’t need SDKs
● Signals to watch for that you might need SDKs
● Establish what a good SDK means for your community
● Use your criteria to evaluate ways to build SDKs.
Comparison matrix
https:/
/tinyurl.com/sdk-book
Sid Maestre
VP Developer Relations
sid.maestre@apimatic.io
@SidneyAllen
You Don't Need SDKs, Wait Maybe You Do?

More Related Content

Similar to You Don't Need SDKs, Wait Maybe You Do?

Sean Kerr Resume
Sean Kerr ResumeSean Kerr Resume
Sean Kerr Resume
Sean Kerr
 

Similar to You Don't Need SDKs, Wait Maybe You Do? (20)

PHPFrameworkDay 2020 - Different software evolutions from Start till Release ...
PHPFrameworkDay 2020 - Different software evolutions from Start till Release ...PHPFrameworkDay 2020 - Different software evolutions from Start till Release ...
PHPFrameworkDay 2020 - Different software evolutions from Start till Release ...
 
"Different software evolutions from Start till Release in PHP product" Oleksa...
"Different software evolutions from Start till Release in PHP product" Oleksa..."Different software evolutions from Start till Release in PHP product" Oleksa...
"Different software evolutions from Start till Release in PHP product" Oleksa...
 
apidays New York 2022 - Demystifying API Onboarding: A Focus on SDKs, Mehdi R...
apidays New York 2022 - Demystifying API Onboarding: A Focus on SDKs, Mehdi R...apidays New York 2022 - Demystifying API Onboarding: A Focus on SDKs, Mehdi R...
apidays New York 2022 - Demystifying API Onboarding: A Focus on SDKs, Mehdi R...
 
Mobile-Enabling Enterprise APIs: A Case Study with MasterCard
Mobile-Enabling Enterprise APIs: A Case Study with MasterCardMobile-Enabling Enterprise APIs: A Case Study with MasterCard
Mobile-Enabling Enterprise APIs: A Case Study with MasterCard
 
TOP 10 WEB APP TOOLS FOR EFFICIENT DEVELOPMENT.pdf
TOP 10 WEB APP TOOLS FOR EFFICIENT DEVELOPMENT.pdfTOP 10 WEB APP TOOLS FOR EFFICIENT DEVELOPMENT.pdf
TOP 10 WEB APP TOOLS FOR EFFICIENT DEVELOPMENT.pdf
 
How ring central sdk changing the game
How ring central sdk changing the gameHow ring central sdk changing the game
How ring central sdk changing the game
 
Ring central sdk
Ring central sdkRing central sdk
Ring central sdk
 
Red Hat OpenShift App Dev meetup - Operator SDK
Red Hat OpenShift App Dev meetup - Operator SDK Red Hat OpenShift App Dev meetup - Operator SDK
Red Hat OpenShift App Dev meetup - Operator SDK
 
Content Strategy and Developer Engagement for DevPortals
Content Strategy and Developer Engagement for DevPortalsContent Strategy and Developer Engagement for DevPortals
Content Strategy and Developer Engagement for DevPortals
 
Kotlin native for iOS and Android
Kotlin native for iOS and AndroidKotlin native for iOS and Android
Kotlin native for iOS and Android
 
Sean Kerr Resume
Sean Kerr ResumeSean Kerr Resume
Sean Kerr Resume
 
Student Developer Kit for Developing Applications
Student Developer Kit for Developing ApplicationsStudent Developer Kit for Developing Applications
Student Developer Kit for Developing Applications
 
Delivering Developer Tools at Scale
Delivering Developer Tools at ScaleDelivering Developer Tools at Scale
Delivering Developer Tools at Scale
 
Ring central sdk overview
Ring central sdk overviewRing central sdk overview
Ring central sdk overview
 
Swagger for-your-api
Swagger for-your-apiSwagger for-your-api
Swagger for-your-api
 
Kunal bhatia resume mass
Kunal bhatia   resume massKunal bhatia   resume mass
Kunal bhatia resume mass
 
The Decoupled CMS in Financial Services
The Decoupled CMS in Financial ServicesThe Decoupled CMS in Financial Services
The Decoupled CMS in Financial Services
 
Introduction to the source{d} Stack
Introduction to the source{d} Stack Introduction to the source{d} Stack
Introduction to the source{d} Stack
 
Mobile SDK: Considerations & Best Practices
Mobile SDK: Considerations & Best Practices Mobile SDK: Considerations & Best Practices
Mobile SDK: Considerations & Best Practices
 
Top 10 IDEs for React.js Developers in 2021
Top 10 IDEs for React.js Developers in 2021Top 10 IDEs for React.js Developers in 2021
Top 10 IDEs for React.js Developers in 2021
 

More from Nordic APIs

The Federated Future: Pioneering Next-Gen Solutions in API Management - Marku...
The Federated Future: Pioneering Next-Gen Solutions in API Management - Marku...The Federated Future: Pioneering Next-Gen Solutions in API Management - Marku...
The Federated Future: Pioneering Next-Gen Solutions in API Management - Marku...
Nordic APIs
 
Inclusive, Accessible Tech: Bias-Free Language in Code and Configurations - A...
Inclusive, Accessible Tech: Bias-Free Language in Code and Configurations - A...Inclusive, Accessible Tech: Bias-Free Language in Code and Configurations - A...
Inclusive, Accessible Tech: Bias-Free Language in Code and Configurations - A...
Nordic APIs
 

More from Nordic APIs (20)

How I Built Bill, the AI-Powered Chatbot That Reads Our Docs for Fun , by Tod...
How I Built Bill, the AI-Powered Chatbot That Reads Our Docs for Fun , by Tod...How I Built Bill, the AI-Powered Chatbot That Reads Our Docs for Fun , by Tod...
How I Built Bill, the AI-Powered Chatbot That Reads Our Docs for Fun , by Tod...
 
The Art of API Design, by David Biesack at Apiture
The Art of API Design, by David Biesack at ApitureThe Art of API Design, by David Biesack at Apiture
The Art of API Design, by David Biesack at Apiture
 
ABAC, ReBAC, Zanzibar, ALFA… How Should I Implement AuthZ in My APIs? by Dav...
ABAC, ReBAC, Zanzibar, ALFA…  How Should I Implement AuthZ in My APIs? by Dav...ABAC, ReBAC, Zanzibar, ALFA…  How Should I Implement AuthZ in My APIs? by Dav...
ABAC, ReBAC, Zanzibar, ALFA… How Should I Implement AuthZ in My APIs? by Dav...
 
Crafting a Cloud Native API Platform to Accelerate Your Platform Maturity - B...
Crafting a Cloud Native API Platform to Accelerate Your Platform Maturity - B...Crafting a Cloud Native API Platform to Accelerate Your Platform Maturity - B...
Crafting a Cloud Native API Platform to Accelerate Your Platform Maturity - B...
 
The Federated Future: Pioneering Next-Gen Solutions in API Management - Marku...
The Federated Future: Pioneering Next-Gen Solutions in API Management - Marku...The Federated Future: Pioneering Next-Gen Solutions in API Management - Marku...
The Federated Future: Pioneering Next-Gen Solutions in API Management - Marku...
 
API Authorization Using an Identity Server and Gateway - Aldo Pietropaolo, SGNL
API Authorization Using an Identity Server and Gateway - Aldo Pietropaolo, SGNLAPI Authorization Using an Identity Server and Gateway - Aldo Pietropaolo, SGNL
API Authorization Using an Identity Server and Gateway - Aldo Pietropaolo, SGNL
 
API Discovery from Crawl to Run - Rob Dickinson, Graylog
API Discovery from Crawl to Run - Rob Dickinson, GraylogAPI Discovery from Crawl to Run - Rob Dickinson, Graylog
API Discovery from Crawl to Run - Rob Dickinson, Graylog
 
Productizing and Monetizing APIs - Derric Gilling, Moseif
Productizing and Monetizing APIs - Derric Gilling, MoseifProductizing and Monetizing APIs - Derric Gilling, Moseif
Productizing and Monetizing APIs - Derric Gilling, Moseif
 
Securely Boosting Any Product with Generative AI APIs - Ruben Sitbon, Sipios
Securely Boosting Any Product with Generative AI APIs - Ruben Sitbon, SipiosSecurely Boosting Any Product with Generative AI APIs - Ruben Sitbon, Sipios
Securely Boosting Any Product with Generative AI APIs - Ruben Sitbon, Sipios
 
Security of LLM APIs by Ankita Gupta, Akto.io
Security of LLM APIs by Ankita Gupta, Akto.ioSecurity of LLM APIs by Ankita Gupta, Akto.io
Security of LLM APIs by Ankita Gupta, Akto.io
 
I'm an API Hacker, Here's How to Go from Making APIs to Breaking Them - Katie...
I'm an API Hacker, Here's How to Go from Making APIs to Breaking Them - Katie...I'm an API Hacker, Here's How to Go from Making APIs to Breaking Them - Katie...
I'm an API Hacker, Here's How to Go from Making APIs to Breaking Them - Katie...
 
Unleashing the Potential of GraphQL with Streaming Data - Kishore Banala, Net...
Unleashing the Potential of GraphQL with Streaming Data - Kishore Banala, Net...Unleashing the Potential of GraphQL with Streaming Data - Kishore Banala, Net...
Unleashing the Potential of GraphQL with Streaming Data - Kishore Banala, Net...
 
Reigniting the API Description Wars with TypeSpec and the Next Generation of ...
Reigniting the API Description Wars with TypeSpec and the Next Generation of...Reigniting the API Description Wars with TypeSpec and the Next Generation of...
Reigniting the API Description Wars with TypeSpec and the Next Generation of ...
 
Establish, Grow, and Mature Your API Platform - James Higginbotham, LaunchAny
Establish, Grow, and Mature Your API Platform - James Higginbotham, LaunchAnyEstablish, Grow, and Mature Your API Platform - James Higginbotham, LaunchAny
Establish, Grow, and Mature Your API Platform - James Higginbotham, LaunchAny
 
Inclusive, Accessible Tech: Bias-Free Language in Code and Configurations - A...
Inclusive, Accessible Tech: Bias-Free Language in Code and Configurations - A...Inclusive, Accessible Tech: Bias-Free Language in Code and Configurations - A...
Inclusive, Accessible Tech: Bias-Free Language in Code and Configurations - A...
 
Going Platinum: How to Make a Hit API by Bill Doerrfeld, Nordic APIs
Going Platinum: How to Make a Hit API by Bill Doerrfeld, Nordic APIsGoing Platinum: How to Make a Hit API by Bill Doerrfeld, Nordic APIs
Going Platinum: How to Make a Hit API by Bill Doerrfeld, Nordic APIs
 
Getting Better at Risk Management Using Event Driven Mesh Architecture - Ragh...
Getting Better at Risk Management Using Event Driven Mesh Architecture - Ragh...Getting Better at Risk Management Using Event Driven Mesh Architecture - Ragh...
Getting Better at Risk Management Using Event Driven Mesh Architecture - Ragh...
 
GenAI: Producing and Consuming APIs by Paul Dumas, Gartner
GenAI: Producing and Consuming APIs by Paul Dumas, GartnerGenAI: Producing and Consuming APIs by Paul Dumas, Gartner
GenAI: Producing and Consuming APIs by Paul Dumas, Gartner
 
The SAS developer portal – developer.sas.com 2.0: How we built it by Joe Furb...
The SAS developer portal –developer.sas.com 2.0: How we built it by Joe Furb...The SAS developer portal –developer.sas.com 2.0: How we built it by Joe Furb...
The SAS developer portal – developer.sas.com 2.0: How we built it by Joe Furb...
 
How Netflix Uses Data Abstraction to Operate Services at Scale - Vidhya Arvin...
How Netflix Uses Data Abstraction to Operate Services at Scale - Vidhya Arvin...How Netflix Uses Data Abstraction to Operate Services at Scale - Vidhya Arvin...
How Netflix Uses Data Abstraction to Operate Services at Scale - Vidhya Arvin...
 

Recently uploaded

Modular Monolith - a Practical Alternative to Microservices @ Devoxx UK 2024
Modular Monolith - a Practical Alternative to Microservices @ Devoxx UK 2024Modular Monolith - a Practical Alternative to Microservices @ Devoxx UK 2024
Modular Monolith - a Practical Alternative to Microservices @ Devoxx UK 2024
Victor Rentea
 
Cloud Frontiers: A Deep Dive into Serverless Spatial Data and FME
Cloud Frontiers:  A Deep Dive into Serverless Spatial Data and FMECloud Frontiers:  A Deep Dive into Serverless Spatial Data and FME
Cloud Frontiers: A Deep Dive into Serverless Spatial Data and FME
Safe Software
 
TrustArc Webinar - Unified Trust Center for Privacy, Security, Compliance, an...
TrustArc Webinar - Unified Trust Center for Privacy, Security, Compliance, an...TrustArc Webinar - Unified Trust Center for Privacy, Security, Compliance, an...
TrustArc Webinar - Unified Trust Center for Privacy, Security, Compliance, an...
TrustArc
 

Recently uploaded (20)

JavaScript Usage Statistics 2024 - The Ultimate Guide
JavaScript Usage Statistics 2024 - The Ultimate GuideJavaScript Usage Statistics 2024 - The Ultimate Guide
JavaScript Usage Statistics 2024 - The Ultimate Guide
 
AWS Community Day CPH - Three problems of Terraform
AWS Community Day CPH - Three problems of TerraformAWS Community Day CPH - Three problems of Terraform
AWS Community Day CPH - Three problems of Terraform
 
Decarbonising Commercial Real Estate: The Role of Operational Performance
Decarbonising Commercial Real Estate: The Role of Operational PerformanceDecarbonising Commercial Real Estate: The Role of Operational Performance
Decarbonising Commercial Real Estate: The Role of Operational Performance
 
API Governance and Monetization - The evolution of API governance
API Governance and Monetization -  The evolution of API governanceAPI Governance and Monetization -  The evolution of API governance
API Governance and Monetization - The evolution of API governance
 
Modular Monolith - a Practical Alternative to Microservices @ Devoxx UK 2024
Modular Monolith - a Practical Alternative to Microservices @ Devoxx UK 2024Modular Monolith - a Practical Alternative to Microservices @ Devoxx UK 2024
Modular Monolith - a Practical Alternative to Microservices @ Devoxx UK 2024
 
Modernizing Legacy Systems Using Ballerina
Modernizing Legacy Systems Using BallerinaModernizing Legacy Systems Using Ballerina
Modernizing Legacy Systems Using Ballerina
 
Repurposing LNG terminals for Hydrogen Ammonia: Feasibility and Cost Saving
Repurposing LNG terminals for Hydrogen Ammonia: Feasibility and Cost SavingRepurposing LNG terminals for Hydrogen Ammonia: Feasibility and Cost Saving
Repurposing LNG terminals for Hydrogen Ammonia: Feasibility and Cost Saving
 
Cloud Frontiers: A Deep Dive into Serverless Spatial Data and FME
Cloud Frontiers:  A Deep Dive into Serverless Spatial Data and FMECloud Frontiers:  A Deep Dive into Serverless Spatial Data and FME
Cloud Frontiers: A Deep Dive into Serverless Spatial Data and FME
 
Connector Corner: Accelerate revenue generation using UiPath API-centric busi...
Connector Corner: Accelerate revenue generation using UiPath API-centric busi...Connector Corner: Accelerate revenue generation using UiPath API-centric busi...
Connector Corner: Accelerate revenue generation using UiPath API-centric busi...
 
Understanding the FAA Part 107 License ..
Understanding the FAA Part 107 License ..Understanding the FAA Part 107 License ..
Understanding the FAA Part 107 License ..
 
WSO2's API Vision: Unifying Control, Empowering Developers
WSO2's API Vision: Unifying Control, Empowering DevelopersWSO2's API Vision: Unifying Control, Empowering Developers
WSO2's API Vision: Unifying Control, Empowering Developers
 
WSO2 Micro Integrator for Enterprise Integration in a Decentralized, Microser...
WSO2 Micro Integrator for Enterprise Integration in a Decentralized, Microser...WSO2 Micro Integrator for Enterprise Integration in a Decentralized, Microser...
WSO2 Micro Integrator for Enterprise Integration in a Decentralized, Microser...
 
Introduction to Multilingual Retrieval Augmented Generation (RAG)
Introduction to Multilingual Retrieval Augmented Generation (RAG)Introduction to Multilingual Retrieval Augmented Generation (RAG)
Introduction to Multilingual Retrieval Augmented Generation (RAG)
 
MINDCTI Revenue Release Quarter One 2024
MINDCTI Revenue Release Quarter One 2024MINDCTI Revenue Release Quarter One 2024
MINDCTI Revenue Release Quarter One 2024
 
[BuildWithAI] Introduction to Gemini.pdf
[BuildWithAI] Introduction to Gemini.pdf[BuildWithAI] Introduction to Gemini.pdf
[BuildWithAI] Introduction to Gemini.pdf
 
Quantum Leap in Next-Generation Computing
Quantum Leap in Next-Generation ComputingQuantum Leap in Next-Generation Computing
Quantum Leap in Next-Generation Computing
 
Corporate and higher education May webinar.pptx
Corporate and higher education May webinar.pptxCorporate and higher education May webinar.pptx
Corporate and higher education May webinar.pptx
 
ChatGPT and Beyond - Elevating DevOps Productivity
ChatGPT and Beyond - Elevating DevOps ProductivityChatGPT and Beyond - Elevating DevOps Productivity
ChatGPT and Beyond - Elevating DevOps Productivity
 
TrustArc Webinar - Unified Trust Center for Privacy, Security, Compliance, an...
TrustArc Webinar - Unified Trust Center for Privacy, Security, Compliance, an...TrustArc Webinar - Unified Trust Center for Privacy, Security, Compliance, an...
TrustArc Webinar - Unified Trust Center for Privacy, Security, Compliance, an...
 
DEV meet-up UiPath Document Understanding May 7 2024 Amsterdam
DEV meet-up UiPath Document Understanding May 7 2024 AmsterdamDEV meet-up UiPath Document Understanding May 7 2024 Amsterdam
DEV meet-up UiPath Document Understanding May 7 2024 Amsterdam
 

You Don't Need SDKs, Wait Maybe You Do?

  • 1. You don’t need SDKs, wait maybe you do! Sid Maestre APIMatic VP Developer Relations
  • 2.
  • 3.
  • 6.
  • 7.
  • 8. Other signals you may not need SDKs ● You are still proving the value of your API ● You only plan to service a handful of developers ● You don’t have many endpoints and simple data structures. ● You don’t have strong competitors ● Your offering is so compelling developers are willing to put in extra effort. ● Target users don’t use SDKs (10x engineers or low code/no code)
  • 10.
  • 12. … what is an SDK?
  • 13. Code Samples Code Library Use Case Guides SDK Reference Sample App Getting Started
  • 14. … why do developers want SDKs?
  • 15. Stripe’s server-side helper libraries (also known as server-side SDKs) reduce the amount of work required to use Stripe’s REST APIs, starting with reducing the boilerplate code you have to write. ❝ ❞
  • 17.
  • 23. Inline docs, hinting, code completion
  • 24.
  • 25.
  • 27. Over 50% of support inquires were authentication related Our forums filled with developers sharing code snippets and trying to help each other. More API wrappers built by community and shared on GitHub - but they weren’t well maintained. Headaches all around
  • 28.
  • 29.
  • 30. Signals we needed SDKs ● Time to first Hello World is subpar ● High support burden ● Developers asking for examples in different languages ● Community building their own libraries ● Key accounts are asking for SDKs ● Your competition have SDKs and offer a superior DX
  • 31. Photo by Daniel Cartin on Unsplash
  • 32. Where to start today?
  • 33.
  • 34. What make a “good” SDK?
  • 35. SDKs that are easy to use ● Implement a REST-agnostic design ● Design Consistent SDKs SDKs that come with docs ● Create SDK specific documentation ● Provide Sample Code
  • 36. SDKs that match the API ● Ensure API Coverage ● Provide End-to-End Typing SDKs that work ● Create a Test Suite ● Share Test Coverage Reports
  • 37. SDKs that are robust ● Transient Error Policy ● API Error Policy SDKs that receive updates ● Timely API Updates ● Security & Maintenance Updates
  • 38. SDKs that have support ● Handle support tickets ● Engage with the community
  • 39. Who’s gonna build your SDK program
  • 40. ● Architect or Program Lead ● Developers to create the SDKs in each language ● Content writers to create documentation ● Support staff who handle support tickets ● Developer(s) who owns SDK updates when API changes, language changes, bug fixes, and dependency updates ● Developer Relations team or person to engage with the community on SDK and API roadmap and their experience
  • 41. Ways to Build SDKs ● Homegrown or Handwritten ● Open source code generators ● Commercial code generators
  • 42. Recap ● SDKs are more than code libraries ● SDKs reduce boilerplate code, complexity, help with change management and developer achieve “flow” ● Every API doesn’t need SDKs ● Signals to watch for that you might need SDKs ● Establish what a good SDK means for your community ● Use your criteria to evaluate ways to build SDKs.
  • 44. https:/ /tinyurl.com/sdk-book Sid Maestre VP Developer Relations sid.maestre@apimatic.io @SidneyAllen