Defining an API Specification: A Step-by-Step Guide

Janani Subbiah

Friday 24 October 2025 from 10:00 to 10:50

Talk in English - US at Longhorn PHP 2025
Track Name: Main Ballroom
Short URL: https://joind.in/talk/0f767 (QR-Code (opens in new window))

Avg. Rating

As developers, we frequently create and consume APIs, whether in mobile, web, or backend development. APIs are crucial for data interchange between services and interfaces. This presentation will focus on the critical first step in API development: defining a robust API specification.  

We will explore a step-by-step process for creating an API spec, covering where to begin, the essential components to consider, and valuable resources to utilize. Additionally, we’ll discuss common pitfalls and how to avoid them. By the end of this session, attendees will have a clear understanding of best practices in API specification design, ensuring smoother implementation and integration in their projects.

Comments

Please login to leave a comment

Joe Ferguson at 11:16 on 24 Oct 2025 (via Web2 LIVE)

Great intro into working with APIs and a lot of guidance on best practices and how to avoid common pitfalls

Michael Miles at 14:55 on 25 Oct 2025 (via Web2 LIVE)

The talk was straight forward and clear. Very helpful for people new to creating APIs.