apidays LIVE New York 2021 - API-driven Regulations for Finance, Insurance, and Healthcare July 28 & 29, 2021 Design-First: How to champion an API culture shift Anna Daugherty, Product Marketing Manager at Stoplight

1. Design-First
Championing an API Culture Shift

2. About Me
Anna Daugherty is the Product Marketing
Manager for Stoplight. She has been
involved with technology marketing for
10 years, in everything from SaaS
to eCommerce to video games.
In her spare time, she enjoys tabletop RPGs,
Carly Rae Jepsen, and being a huge nerd.

3. “
APIs are here to stay ... So, it's
essential to treat an API as a
Product, even if it's just for
internal usage, and adopt the
same action mandate as you
would for other products.”
– API Friends

4. Design Maturity Delivers Results – InVision
Product Quality
Operational Efficiency
Product usability 81%
Customer satisfaction 71%
Employee productivity 33%
Time to market 29%
Business Profitability
Revenue 42%
Conversions 35%
Cost savings 30%
Market Position
Brand equity 39%
Entry into new markets 25%
Design patents 13%
Valuation 10%

5. “
Companies with high design
maturity are more likely to see
results like cost savings, revenue
gains, and market position
improvements.
– InVision

6. So what’s wrong with
API workflows
today?

7. Making APIs
Govern
Disconnected Workflows
Practice
Document

8. Wasted Effort, Quality, and Opportunity
Create and
Iterate
Discover Deprecate

9. How Are Products Created?
Discovery Design Test Build Measure

10. Product design is a
customer-first
mindset.

11. So how do you treat your
API as a Product and
change the workflow at
your organization?

12. API-First Approach Govern
Create a Connected
Workflow
Practice
Document

13. API
Evolution
New API
Discovery
Design Develop Release Monitor
Connect APIs to a Product Mindset
Deprecate

14. Become
customer-first in
API design and
development.

15. Design and prototype before
implementing to save time,
money, and stress.”
– James Higginbotham and Keith Casey
A Practical Approach to API Design
“

16. Design
→ Align Business Need with API
Success Criteria
→ Pilot and Prototype
→ Determine Design Spec
→ Speak Your Customers’ Language
→ Get API Consumer Feedback
→ Perform API Style Checks
→ Get Review and Approval

17. → Use Approved Code Samples
→ Perform Mocking
→ Show How Your API Works through a Demo
→ Get Developer / User Feedback
→ Undergo API Security Review
→ Pass Risk and Compliance
→ Utilize Version Control
→ Integrate Documentation
Develop

18. → Offer Documentation
→ Deploy
→ Announce
Release

19. → Establish API Change Success Criteria
→ Perform API Monitoring
→ Run Smoke Tests
→ Perform Governance Review
Monitor

20. Design Develop Release Monitor
New API
Discovery
API
Standards
Redundancy
Check
Business
Case
Design Spec
Pilot & Prototype
Business
Need/Success
Review &
Approval
Style Check
Consumer
Feedback
Security Review
Regression
Testing
Mocking
Documentation
Risk &
Compliance
Announcement
Deployment
Smoke Testing
Monitoring
Change Success
Criteria
Governance
Review

21. Adoption Checklist
Small Business/New
API Program
Medium
Business/Maturing
API Program
Enterprise/Mature
API Program
Workflow Tooling &
Instrumentation
Design-First Education
Find API Design Champions
Workflow SLA
API Governance Board / Center
of Excellence

22. Connect APIs to a product mindset.
Connect with customers.
Connect workflows.
Connect teams.

23. “
The Benefits of Using a Design-First Approach
“The design-first approach, for us, leads to a
higher quality implementation, consistency,
governance, and documentation that’s never
out of date.”
 Dmitry Pashkevich, Application Architect at Calendly
Click here to read the Calendly case study.

24. Change the workflow
from just making contact
to creating connections.

25. About
Stoplight Stoplight is an Austin, TX-based
technology startup that helps teams build
quality APIs and scalable API programs.
Stoplight offers a complete API design platform
that integrates seamlessly into existing
workflows to enable all stakeholders to be more
collaborative, productive, and effective.
Get started with up to 3 users for free at
stoplight.io.

26. The Stoplight Way
Drive the entire API lifecycle;
support today’s API-first process.
Build APIs faster with fewer errors,
and make them accessible to the
entire company.
Organization
Individual
Collaboration Discovery Governance
Design Testing Mocking

27. Govern
Promote reuse, consistency,
and quality
Design
Help architects design and create
beautiful, effective APIs
Integrate
Onboard with specification standards like
OpenAPI, JSON Schema, and Markdown
Develop
Build and test more quickly in parallel
using mocking and style guides
Collaborate
Collaborate via Git-less environments
and the Git workflows teams already
know and love
Document
Provide an amazing, integrated
developer experience
Scale
Build a leading, effective API program
across your organization

28. stoplight.io
Thank you