OpenAPI Tips

Everything You Need to Know About OpenAPI

Webhooks & Callbacks in OpenAPI/Swagger

How to correctly use webhooks & callbacks in your OpenAPI/Swagger specification.

Defining OpenAPI Servers - The Where To Your API's How

Tips and best practices for defining servers in your OpenAPI document

Tags Best Practices in OpenAPI

An actionable guide on how to correctly set tags in your OpenAPI schema to organize your API endpoints.

OneOf, AllOf, AnyOf Oh my! How to define union types in OpenAPI

How to effectively use oneOf, allOf and anyOf in your OpenAPI 3.X OADs.

OpenAPI Tips - Query Parameters & Serialization

Tips & Best practices for working with query parameters & serialization in your OpenAPI spec.

OpenAPI tips - Data types and formats

Tips and best practices for working with data types and formats in your OpenAPI spec.

OpenAPI Tips - How to Handle Auth

Tips & Best practices for how to correctly configure auth in your OpenAPI spec.

OpenAPI Tips - How to set operationId

Notes on how to correctly set OperationId in your OpenAPI spec.