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
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
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
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.
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