Software Engineering Radio - the podcast for professional software developers SE Radio 542: Brendan Callum on Contract-Driven APIs
6 snips
Dec 15, 2022 Pinterest’s move to spec-first API development tackles partner complaints about unpredictable interfaces and undocumented changes. Explore the trade-offs of enforcing consistency, how V5 brings APIs, sandboxes, and SDKs together, and how teams gather developer feedback while scaling reviews. The conversation also covers OpenAPI tooling, REST and GraphQL, reliability metrics, and the roles product teams play in building APIs.
Chapters
Transcript
Episode notes
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18
Introduction
00:00 • 4min
Is Your API Not Consistent?
03:50 • 2min
API First - What Changes Did You Need?
06:01 • 3min
Is There a Con or a Cons?
09:00 • 2min
Pinterest API Launch - What Have You Learned Since Launching the API?
10:30 • 3min
V5 APIs - What's New?
13:55 • 2min
How Do You Get Qualitative Feedback From Partners?
15:37 • 2min
The Challenge of Scalability and Complexity in the API
18:05 • 5min
Pinterest API - What Are the Building Blocks of the API?
22:53 • 2min
Scaling the Approval Process?
24:47 • 3min
Open API Tooling
28:13 • 3min
GraphQL V5 API
31:07 • 2min
How Do You Measure Performance and Reliability?
32:47 • 2min
DevOps Spec First Approach - What's the Difference?
34:41 • 2min
APIs
36:22 • 2min
APIs - Do They Have UX Designers and UX Developers?
38:21 • 2min
Are You Responsible for Unit Testing and Integration Testing?
39:52 • 3min
APIs - APIs Are Made for You!
43:08 • 2min