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.

1. cURL to SDK
Navigating the API Adoption Chasm
1

3. 3
3
The API Adoption Chasm
Photo by Tim Johnson on Unsplash

4. 4 Stages of the Developer Journey
4

5. Sid Maestre
5

6. Stages of Developer Journey
DISCOVER
Stage 1

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

18. Section Title | #

19. Building & Maintaining SDKs is Hard
19

20. 20% of API definitions are invalid
50% won’t produce high quality code
20

21. APIMatic VSCode
21
Free download
+1200 rules for CodeGen
Auto-fix 5 common errors
Audit report

22. Show and Tell with Spotify
22

23. sid.maestre@apimatic.io
23