The Curious Engineer

All blogs / Web development

Stoplight

blog.stoplight.io

Get tips and tricks for building APIs at any scale using the design-first approach.

Web developmentSoftware / engineering practice

’18’19’20’21’22’23’24’25’26
Posts
357 from 27 Nov 2018 to 14 Aug 2026
Posting
now and then (1 in the last year)
Kind
company blog
Feed
https://blog.stoplight.io/feed

2026 1

  1. An update on Spectral from SmartBear

2025 1

  1. Introducing Spectral’s New ‘OR’ Function

2024 8

  1. Spectral Governance for Arazzo and API Workflows
  2. Spectral OWASP API Security Ruleset
  3. Harnessing the Power of APIs in Healthcare: A Journey with Humana
  4. Navigating the SDK Landscape: A Deep Dive with Sid Maestre
  5. Navigating the Murky Waters of API Changes: Insights from Aidan Cunniffe
  6. Turn Your Docs Site into a Moneymaker
  7. Exploring the Evolution of Open Banking with Clyde Cutting
  8. How Did You Handle the Trends That Dominated 2023?

2023 86

  1. Down the API Authentication Rabbit Hole with Dan Moore from FusionAuth
  2. Why Should You Prioritize API Security?
  3. How to Read & Understand API Documentation
  4. APIs Aren’t Just Code. They’re Business Assets.
  5. The Power of API Consulting: A Journey with Simon Alen
  6. Build Better APIs with AI-Powered Testing Tools
  7. API Governance: Charting the Path to Success with Frank Kilcommins
  8. Don’t Be Afraid of the Docs!
  9. Strengthen API Security with OpenAPI
  10. API Passwords Stink! Freshen Up Your Security Practices
  11. Security September: Essential Pillars to Ensure API Security with Dan Barahona
  12. Using JSON Schema for Custom API Responses
  13. How to Build an API Using ChatGPT
  14. Designing the Catalog API: How Stoplight Thinks About Public APIs
  15. 2024 Planning Ahead: A Look at Shifting API Trends with APIDays Mehdi Medjaoui
  16. Navigating API Governance & Development
  17. Grade Your API Documentation with this Guide
  18. Stoplight Joins SmartBear: A CTO Perspective
  19. SmartBear to Acquire Stoplight to Deliver Industry’s Broadest Portfolio of API Development Capabilities
  20. 5 Top API Failure Reasons Disrupting Your Integration
  21. AI Tools for the Software Development Process
  22. Forward Momentum: Stoplight Recognized in Multiple 2023 Gartner® Hype Cycle™ Reports
  23. The API Security Hype: Debunking What’s Truly Relevant with Wib’s Chuck Herrin
  24. Using API Caching to Enhance Web Applications
  25. Pave a Smooth Path for API Stakeholders with Gateways and Stoplight
  26. Simplifying Video Streaming with APIs with CPTO of Daily, Varun Singh
  27. API Definition and Creation Best Practices
  28. Top 7 API Security Best Practices: Global Experts Weigh In
  29. Introducing the Stoplight Catalog API!
  30. Navigating Change and Cohesion: Transforming Large-Scale API Programs
  31. API Economy Trends and Lessons in Driving API Growth
  32. How to Select the Best API Gateway for Enhanced Connectivity
  33. 5 Tips to Become Fluent in the Language of API Design
  34. Mask On: Masking Now in Stoplight Platform!
  35. A Tale of 3 Challenges: Integrating and Standardizing APIs
  36. Building Better APIs: Why You Should Practice Product Thinking
  37. Build Cleaner, DRYer APIs with Component Libraries
  38. Healthcare API Solutions Improving Patient Outcomes
  39. The 4 C’s of Developer Relations Programs and Best Practices
  40. Superpower Your Applications with AI APIs
  41. 4 Keys to Success for API-Driven Transformations
  42. What API-as-a-Product Means for API Security
  43. The Definitive Guide to REST API Security: Best Practices
  44. Spring Cleaning: 5 API Program Advantages to Dust Off
  45. 3 Approaches to Apply to Your Business’s API Program with George Mitry
  46. Best Practices for Designing APIs for Mobile Apps
  47. Stoplight AND: Playing well with Postman
  48. Best Practices: API Rate Limiting vs. Throttling
  49. Introducing the IATA API Style Guide for the Aviation Industry
  50. Importance of API Documentation Quality for Citizen Developers
  51. Has Your Team Solved These 3 Common API Challenges?
  52. Supercharge Your API Program with LLMs
  53. Are APIs Becoming 2023’s New Cybersecurity Battleground?
  54. API-First and Automation Testing with ZAPTEST CEO Alex Cherynak
  55. Stoplight’s Continued Recognition as a Leader in API Design
  56. API Catalogs: What Are They Good For?
  57. Introducing the IATA Style Guide for the Airline Industry
  58. Why is Everyone Concerned with API Security?
  59. 7 Hacks That Will Make Your API Design Clear and Convenient
  60. 2 Years of API Intersection: Celebrating 50+ Episodes of the Podcast
  61. Platform Strategy: Maximizing API Creativity
  62. Building Reusable API Component Libraries for Your Organization
  63. Lean API Development with the APIOPs Cycle Method
  64. Mocking Helps You Get It Right the First Time
  65. API Monetization: How You Can Make a Profit With API Products
  66. API Products Need API Catalogs
  67. Platform Thinking: API Products, Tooling and Metrics
  68. Community Conversations that Count with Women in APIs: Season 3
  69. What to Know For Better API Security Beyond the Design Phase
  70. Using Component Libraries for Effective API Governance
  71. Introducing Component Libraries: Buh-Bye to Duplication & Inconsistencies in Your APIs
  72. Infrastructure Tools To Help You Do More With Less
  73. How API Integration Benefits Data Analysis and Reporting
  74. API Metrics: the Good, the Bad, and Beyond
  75. 8 Quick Tips for Creating an API Catalog
  76. Microservices: Pros and Cons
  77. Should I Utilize Usage-Based Billing or Subscription-Based For My APIs?
  78. Jira & Stoplight: Introducing Task Integrations
  79. Your API To-Do List for 2023
  80. Pickin’ up the Slack: Stoplight and Slack Now Integrated
  81. How to Best Support Your API Ecosystem
  82. Product Manager 101: Enhance Collaboration and Discoverability with Discussions
  83. Collaboration and Real-Time Reviews in Stoplight with Discussions
  84. Stoplight Named a 2023 Best Place to Work by Built In
  85. The Basics: Authenticating API Keys on Google Cloud
  86. API Aggregator Challenges in the Fintech and eCommerce World

2022 117

  1. API Keys: API Authentication Methods & Examples
  2. Bi-Directional Contract Testing: a Basic Guide to API Contract Testing Compatibilities
  3. How to Create an API in Three Steps
  4. Could ADRs Be the Sustainable Docs You Need?
  5. Learn from Three 2023 API Trends Shaping the New Year
  6. 4 Ways to Improve Your Enterprise API Strategy
  7. Stoplight Recognized Four Quarters in a Row by G2
  8. A Technical Writer’s Experience Using Mermaid in Stoplight
  9. Stoplight’s Public Style Guides: Resources for API Developers
  10. Create Better Quality API Documentation with Spectral
  11. Should I Use a Unified API Approach?
  12. Work Better with AWS API Gateway using Spectral
  13. Better Developer Experience Includes API Mocking AND Testing
  14. Ensuring API Consistency Across the Country: the Italian Government’s Spectral Story
  15. A DIYer’s Guide To API Tools
  16. Avoid API Versioning Pitfalls with Spectral
  17. What is API Management? Plus Five Principles to Maintain High-Functioning Products
  18. Flavor and Familiarity: the Two Sides of Both Style Guides and Company-Wide Process
  19. Recent Release Roundup: Fall 2022
  20. How Signing a Software Development Partnership Will Benefit Your Business
  21. I Want My API: the Benefits of Stoplight for Smaller Companies
  22. 4 Transformation Tips for Technology Leaders
  23. Design Security with Style (Guides)
  24. Full Lifecycle vs. Specialized: What to Consider When Creating APIs
  25. Your API Transformational Problems Aren’t Technical; They’re Cultural
  26. Setting up a Killer API Design Team: Part 2
  27. Celebrating Hacktoberfest 2022
  28. Stoplight Earns 2022 Workplace Excellence Awards
  29. Introducing Teams: Improve Collaboration Across Your API Program
  30. Opening the Door to OpenAPI and API Aggregator Benefits
  31. Spectral OWASP API Security Ruleset
  32. Stoplight Recognized Again as a Leader in the G2 Fall 2022 API Design Grid
  33. Shift Left and Watch Your API Security Be Right
  34. Where Security Fits in Your API Design Process
  35. Implementing “APIs as a Product” Strategy: a Real-Time Example
  36. Stoplight’s New Integration Powered By Microsoft Azure DevOps Services
  37. Stoplight and Microsoft Azure DevOps Services Deep Dive
  38. Tips on How to Become a Better Product Manager
  39. Identify, Edit, and Streamline API Collaboration with Proposals!
  40. Make Your Business Leaner and Meaner with APIs: Part Two
  41. The Role APIs Play in the Experience Economy and How to Get Ahead
  42. Make Your Business Leaner and Meaner with APIs: Part One
  43. Introducing the API Design Hub
  44. DevRel Deep Dive: Measuring Impact and Where Your Devs Should Be
  45. Style Guides Rulebook: Public Style Guides in Stoplight Platform
  46. 4 Ways Stoplight’s Platform Delivers High-Quality Features & Better Outcomes
  47. Linting the Stoplight Docs with Vale
  48. Setting Up a Killer API Design Team: Part 1
  49. 3 Tips to Kick-Start Your Journey in the API Industry
  50. How to Succeed as Both an API PM and as a DM
  51. Stoplight Announces New CEO, Harrison Yeager
  52. API Collaboration: Typical Governance Models
  53. Stakeholder Buy-In: How to Get Your Business Execs, Consumers, and Developers Hooked on Your APIs
  54. Tech Writers: Who You Need to Collaborate With
  55. Import Postman Collections into Stoplight with a Few Clicks
  56. Sync Your Security Teams and Developers for Secure and Effective APIs
  57. Stoplight Recognized as a Leader for G2 Summer 2022
  58. What an API Consultant Can Do for Your Business
  59. Introducing the Composable Business: How Customer-Centered APIs are Empowering Executives to Open New Markets
  60. 3 Ways to Create a More Inclusive API Program
  61. Style Guides Rulebook Series: Automated API Design checks in CI
  62. Design-First Auth: Choose a Strategy that Works: Auth Part 3
  63. Announcing ‘The API Roadmap: Secrets to Strategy Success from Industry Leaders’
  64. Consistent API URLs with OpenAPI and Style Guides
  65. How to Get Partners for Your APIs
  66. Governance for Asynchronous APIs: Announcing AsyncAPI and Spectral – Together!
  67. Style Guides Rulebook Series: Automating API Design Guidelines
  68. Invest Wisely: How to Get the Most Out of Your API Consultant
  69. Design First, Code Less: How Lessons from Lean Manufacturing Can be Applied to Your API Lifecycle
  70. Creating a Flourishing API Program: Tips from Microsoft
  71. Enable Strong Business Partnerships Through APIs
  72. Better Control Over URLs in Your API Documentation
  73. Plan Your API Auth Strategy with Careful Questions: Auth Part 2
  74. Improve Design, Development, and Delivery with a Proof of Concept
  75. Stoplight Hires Nicholas Muy as Chief Information Security Officer
  76. Introducing Style Guide Projects
  77. Fiserv’s Four Tips for Large API Teams
  78. Engineering Excellence: Stop Slow Release Schedules
  79. Ensure API Excellence with Free Data Validation Tools (like Prism!)
  80. Recent Release Roundup: Spring 2022
  81. The Fintech API Program Big Three
  82. The Foundation of Remote Work: APIs Drive HR Technology
  83. Enforcing Consistency Guidelines: Part 1
  84. Align Your API Teams on Auth Basics
  85. Implementation Made Easy: 3 Steps for Implementing Excellence in API Design
  86. API Security: 3 Trends and Where to Get Started
  87. Engineering Excellence: Why Predictability is Our Leading Metric
  88. Explore These Top API Style Guide Resources
  89. APIs as Your Catalyst for Transformational Change
  90. Stoplight Recognized as a Leader in the G2 Spring 2022 API Design Report
  91. On the Clock: Your Git Clone Repository Just Got Faster
  92. How Discoverability Leads to API Innovation
  93. Extend Your Reach with Documentation that Welcomes Diverse Users
  94. The Intersection of Tech, Education, and Impact with CTO Sally Eaves
  95. API Style Guides Through the Ages
  96. Six Women-Led, API-Driven Companies
  97. Aligning on Your API Design Using Jobs to Be Done
  98. Collaboration for Successful Scaling: Developer Experience and Style Guides from the Ground-Up with SPS Commerce
  99. The Wrong Way to API: What Happens When You Don’t Follow a Design-First Approach
  100. Celebrating Women’s Month: Profiling API Community Expertise in Partnership with Women in APIs
  101. 5 Places to Look for API Champions in Your Organization
  102. Ask the Doc(umentation Writer)
  103. API Style Guides We Love (and Why You Will, Too)
  104. Let’s Debate: GraphQL vs. REST
  105. Three Ways to See If Your APIs Have Style
  106. Stoplight Earns Spot on G2’s 2022 Best Software Awards for Fastest Growing Products
  107. Stoplight Promotes Harrison Yeager to VP of Strategy and Revenue
  108. 10 Organizations Working to Make the Tech Industry More Equitable
  109. Are There Gaps in Your API Workflow? Let’s Fix Them.
  110. Your Secret to Creating Home-Field Advantage: Design-First APIs
  111. What If Your API Program Had a Fresh Start?
  112. 30 Days of API Content: Takeaways with Director of Technology, Josh Austin
  113. Age of the API: Your Catalyst to Create!
  114. Back to Basics: What is an API?
  115. API Products That Help Developers Build APIs and Applications Faster
  116. You Made an API, Now Let’s Talk Adoption Strategy
  117. Stoplight Named a 2022 Best Place to Work by Built In

2021 101

  1. Dark and Light Magic of APIs: The Consumption Side of API Programs
  2. Documentation December: Celebrating Some of the Best in API Documentation
  3. Your API Reference is More than a List of Ingredients
  4. Three Documentation Trends to Share with Your Team in 2022
  5. 10 Trends Shaping the API Industry in 2022
  6. Developer Insights: Why You Should Conduct User Interviews
  7. Ford’s 5 Steps to Navigating the Digital Transformation Frontier via APIs
  8. The Right Way to API
  9. REST API Design Standards: Do They Even Exist?
  10. API Design Patterns for REST
  11. Evolving Security as an API Start-up
  12. Claiming Space in the API Market: Part 2
  13. Freemium Models and Partnerships: What to Consider When Launching a New API Company
  14. 3 Best Practices for Creating Internal APIs
  15. Claiming Space in the API Market, (Part One)
  16. Your Software is Only as Good as Your Support Team
  17. Pinned: API Strategy with Pinterest’s Jon Parise
  18. 10,000 Trees for 25 Pull Requests: Giving Back this Holiday Season
  19. Starting the Open-Source Journey: Tips from the Open-Source Queen, Erika Heidi
  20. A Deep Dive into Prism for Open-Source October
  21. API Specification Design with Spectral and Prism
  22. 3 Lessons from GitLab’s Open-Source Product Marketing
  23. Open-Source October: How to Bring Open-Source into Your Organization
  24. How to Create a Successful API Governance Program
  25. Open-Source Tools We Love
  26. Open-Source Spotlight: The API Platform Framework with Kevin Dunglas
  27. How to Get Started Building APIs: 4 Essential Ingredients for a Successful API Program
  28. Is Your Organization Ready to Build APIs? Answer These 3 Questions First
  29. Opening Up About Open-Source October: Time to Give Back!
  30. Making the Grade: Stoplight Recognized as the Early-Stage Winner at the Austin Chamber 2021 A-List Awards
  31. An Inside Look at eBay’s API Program
  32. Get Organized with Workspace Groups
  33. Drinking API Design-First Champagne
  34. Powering API Governance with Spectral: Part Two
  35. Automated API Style Guides: Linting, Versioning, and More
  36. Powering API Governance with Spectral: Part One
  37. Six Style Guide Tips to Level Up Your API Design
  38. Master the Elements: New Features in Open-Source Documentation
  39. APIs and the Power of Design
  40. Dependency Bump a Day Keeps the Code Crashes Away
  41. Six Things You Should Include in Your API Style Guide
  42. Stoplight Recognized as a Leader by G2
  43. Real-time API Design Collaboration in Stoplight Studio with YJS
  44. Five Things That Should be in Your Developer Toolbox
  45. Back to School: a Student Developer’s Experience with Stoplight
  46. The Unknown Unknowns: How to plan for global usage of your API
  47. API-First, API Design-First, or Code-First: Which Should You Choose
  48. People Will Love Your Consistent API Design
  49. Connection, Empathy, & Trust: Understanding the Business Value of APIs
  50. 7 (Not-So-Deadly) Steps to Create a Successful Developer Relations Program
  51. Stoplight and the OpenAPI Initiative: Community and Collaboration
  52. Stoplight Release Roundup
  53. Creating Connections: Join the New Stoplight Community
  54. API-First vs. API Design-First: A Comprehensive Guide
  55. How to Create Quality and Customer-Centric APIs
  56. API Linting with Spectral Keeps Getting Better
  57. Start Building Beautiful API Documentation
  58. How to Get the Most Out of Your API
  59. 4 Reasons Why You Should Approach APIs with a Design-First Mindset
  60. 3 Easy Ways to Improve Your API Documentation
  61. Unnatural API Calls and HTTP Follies
  62. Stoplight Recognized with Crozdesk Trusted Vendor 2021 Awards
  63. Your API Security Flaws are Intentional
  64. How to Build Great APIs: A Prescription from Dilip Krishnan
  65. Product Design at Stoplight
  66. Open Source API Documentation Tools (And Why They Matter)
  67. Fueling the Next Generation of Women in APIs
  68. What Makes a Great Developer Portal?
  69. Developing an Enterprise-Level API Strategy: Where to Put Your Focus
  70. How to Shape-Up Your API Strategy in 5 Steps
  71. Best Practices to Improving Remote Company Productivity
  72. Stoplight Hires Head of People
  73. Three Tips For Building Quality APIs That Your End-Users Will Love
  74. Three API Collaboration Patterns You Should Follow
  75. Three Ways to Better Understand Your APIs
  76. Why You Should View Your APIs as Products
  77. Build Beautiful API Docs Anywhere with Elements DevPortal
  78. YAML Is More Than JSON Without Brackets: Part 2
  79. Transforming Behavioral Health with APIs
  80. How to Deliver a Great Developer Experience with Your APIs
  81. How to Generate Serverless HTTP API Mocking Using Prism
  82. How Companies Are Exposing Their API Design Assets Internally
  83. The Conflicting Model Problem
  84. YAML Is More Than JSON Without Brackets (Part 1)
  85. Security Practices: The Key to Scaling Your API Strategy
  86. Stoplight Now Supports OpenAPI 3.1 Documents
  87. Three Collaborative Design Best Practices to Spruce Up Your API Design Process
  88. Five Ways JSON Schema Can Help You Create Better APIs
  89. How Many APIs Does It Take to Plant a Tree: Earth Day
  90. API Design and Governance Problems Are Not Always Technical
  91. How to Maximize Your API Strategy
  92. Collaborate on Your APIs with Real-Time Projects
  93. How to Bring Design-First APIs to Your Organization
  94. Accelerate Your End-to-End API Design with Stoplight Platform
  95. How Many APIs are We Running in Production?
  96. Why at Stoplight We “Choose to Challenge”
  97. API Documentation and Help Docs: Can They Live Together?
  98. Stoplight Secures $11 Million in Funding as Growth Accelerates
  99. A Practical Guide to API Design-First
  100. The Problem with Ubiquitous APIs
  101. Export API Documentation as a PDF

2020 17

  1. Deprecating API Endpoints
  2. Stoplight Studio Desktop v2.1 Released
  3. How OpenAPI Data Types Enable Robust APIs
  4. Generating API Documentation from Code with Stoplight
  5. What’s the Difference Between OpenAPI Types 2.0, 3.0, and 3.1?
  6. Stoplight Platform and Studio Desktop v2.0
  7. Is API Planning the same thing as API Design?
  8. Introducing Stoplight’s New CEO
  9. What is the Meaning of API Testing?
  10. Just a Simple API: List of APIs with Fun Data for Quick Mock-ups
  11. Rethinking API Design at Scale with the Stoplight Platform
  12. API Design-First vs. Code First
  13. Keeping OpenAPI DRY and Portable
  14. API Experts Share How They Organize Thousands of APIs
  15. Companies Supporting Open-Source
  16. Open Source Mock Server Gets Smarter
  17. API Development Demystified

2019 24

  1. Mocking Callbacks with OpenAPI and Prism
  2. Sample Web & REST API Documentation Template Examples
  3. Automated Style Guides for REST, GraphQL and gRPC
  4. How to Mock API Calls in Test Environments
  5. Using Studio OpenAPI GUI Designer – Your Webinar Questions Answered
  6. OpenAPI and JSON Schema: When to Use Which
  7. Why You Shouldn’t Ignore Internal API Documentation
  8. Prism v3 Adds OpenAPI 3.0 and Goes Open Source
  9. More Flexible JSON Linting with Spectral 4.0
  10. REST API Security Design Best Practices
  11. Don’t Waste Your Time Building Fake APIs in Code
  12. A Simple API Design Walkthrough
  13. Stoplight Named a Cool Vendor by Gartner
  14. Reusing Definitions Across Methods in OpenAPI
  15. How to Build a Python REST API Server for Quick Mocking
  16. CRUD API Design & CRUD API Recommendations
  17. JSON Generator for Mock API Data
  18. Introducing Spectral
  19. RAML vs YAML Vs Swagger for API Specifications
  20. Beyond Static Docs: Interactive API Documentation
  21. Swagger to OAS
  22. Open Banking, Regulation, and API Design Standards
  23. What’s Missing From Your API Documentation
  24. Designing APIs for Microservices

2018 2

  1. Stop Calling Your APIs Microservices
  2. API Proxy vs API Gateway