This is your regularly-scheduled reminder that OpenAPI 3.1 is more than 2 years old. If you're still working with older versions, you're holding back better developer experiences.
Ask your API providers to upgrade, or look into doing so for your own APIs. It's worth it. #DevX
vacuum is the worlds fastest OpenAPI 3, OpenAPI 2 / Swagger linter and quality analysis tool. Built in go, it tears through API specs faster than you can think. vacuum is compatible with Spectral r...
libopenapi is a fully featured, high performance, enterprise grade OpenAPI 3.1, 3.0 and Swagger 2.0 parser, library and toolkit for golang applications. - GitHub - pb33f/libopenapi: libopenapi is a...
Build, Validate, Route, Authenticate and Mock using OpenAPI - GitHub - anttiviljami/openapi-backend: Build, Validate, Route, Authenticate and Mock using OpenAPI
The info property of an OpenAPI document contains metadata that provides an overview of an API, but what does it represent exactly? How did it evolve across the OpenAPI Specification versions? And how to can it be used and misused? This is the second post in the OpenAPI Specification Reference series.
How using OpenAPI has led to being able to ship a new service more effectively, by removing the need to write scaffolding, and instead focus on the business logic.
I have JSON schema file where one of the properties is defined as either string or null:
"type":["string", "null"]
When converted to YAML (for use with OpenAPI/Swagger), it becomes:
type:
- 'n...
Generate Go client and server boilerplate from OpenAPI 3 specifications - GitHub - deepmap/oapi-codegen: Generate Go client and server boilerplate from OpenAPI 3 specifications
With Postman now supporting the latest version of OpenAPI, learn how to import OpenAPI 3.1 files and start working with them today. Postman Software Engineer Ankit Saini explains: blog.postman.com/postman-now-su…
Recommended read:
Contract Testing a Laravel API with OpenAPI | APIs You Won't Hate
https://apisyouwonthate.com/blog/contract-testing-apis-laravel-php-openapi
This is a really great idea - API gateways / ingress tooling utilising OpenAPI is much better than requiring duplication, and ensures that teams are building with API documentation first, but would be a barrier for those who need to backfill docs
Recommended read:
An OpenAPI-first Ingress Controller for Kubernetes - Kusk Gateway - Kubeshop
https://kubeshop.io/blog/configure-ingress-with-openapi
Sorry for the late reply - thanks for this info folks. That'd be useful, and would allow us to deprecate all sorts of things, especially going forward 👍🏽
I don't believe there is an official way of doing it. Just add a new mediatype object in the responses and add a deprecation notice in the description.
Folks who work a lot with #OpenApi - is there a way to specify different securitySchemes and different headers based on what type of server is being used? I.e. to clarify between local/integrated systems?
Jamie Tanna
.
#openapi.
