@lukas@indieweb.social @lornajane@indieweb.social @Philsturgeon@mastodon.green How about a swear jar for API conferences. Every time a speaker says Swagger, they have to pay Phil to plant another tree.
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…
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
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.
Jamie Tanna
.
#swagger
#openapi.
