A presentation given by Sidney Maestre, VP Developer Relations at APIMatic, at our 2024 Austin API Summit, March 12-13.
Session Description: As API adoption becomes increasingly pivotal for companies, understanding the evolution from cURL commands to robust Software Development Kits (SDKs) is paramount. Your initial developer experience may focus on API reference docs with cURL commands, but as you scale, you’ll need to help developers beyond “Hello World.” Discover the pivotal role SDKs play in propelling developers towards production-ready solutions. However, building and maintaining an effective SDK program can be resource-intensive. This talk will address this challenge by demonstrating the key – SDK generation. Learn how your OpenAPI definition can serve as a source of truth, enabling the automated generation of SDK libraries in multiple languages, comprehensive documentation, and illustrative code samples. We delve into seamlessly integrating “docs as code” principles and SDK package publishing to streamline the process. Join us as we explore the transformative potential of SDK generation as the linchpin in crossing the API Adoption Chasm.
7. Stages of Developer Journey
DISCOVER
Stage 1
API Reference
cURL Commands
Authentication Narrative
8. 8
8
Stages of Developer Journey
DISCOVER
API Reference
cURL Commands
Authentication Narrative
Stage 1
Stage 2
EVALUATE
9. 9
9
Stages of Developer Journey
DISCOVER
API Reference
cURL Commands
Authentication Narrative
Stage 1
Stage 2
EVALUATE
Getting Started
Postman Collection
Generic Code Samples
10. 10
10
Stages of Developer Journey
DISCOVER
Stage 1
Stage 2
EVALUATE
Stage 3
INTEGRATE
API Reference
cURL Commands
Authentication Narrative
Getting Started
Postman Collection
Generic Code Samples
11. 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.
❝
❞
12. 12
12
Stages of Developer Journey
DISCOVER
Stage 1
Stage 2
EVALUATE
Stage 3
INTEGRATE
API Reference
cURL Commands
Authentication Narrative
Getting Started
Postman Collection
Generic Code Samples
13. 13
13
Stages of Developer Journey
DISCOVER
Stage 1
Stage 2
EVALUATE
Stage 3
INTEGRATE
SDK Library & Reference
Runnable Code Samples
Guided Walkthrough
An AI Assistant
API Reference
cURL Commands
Authentication Narrative
Getting Started
Postman Collection
Generic Code Samples
14. Case Study
VISA
14
● Integration time went down by 4x
○ from 12 months to just 3 months
● Support tickets reduced by 45%
○ Eliminated white-glove support
○ Enabled self-service
15. 15
15
Stages of Developer Journey
DISCOVER
Stage 1
Stage 2
EVALUATE
Stage 3
INTEGRATE
Stage 4
IMPROVE
SDK Library & Reference
Runnable Code Samples
Guided Walkthrough
An AI Assistant
API Reference
cURL Commands
Authentication Narrative
Getting Started
Postman Collection
Generic Code Samples
16. 16
16
Stages of Developer Journey
DISCOVER
Stage 1
Stage 2
EVALUATE
Stage 3
INTEGRATE
Stage 4
IMPROVE
Package managers
OpenAPI tools
SDK Library & Reference
Runnable Code Samples
Guided Walkthrough
An AI Assistant
API Reference
cURL Commands
Authentication Narrative
Getting Started
Postman Collection
Generic Code Samples