Redocly CLI is a brilliant new tool from the folks who made ReDoc, the first beautiful API reference documentation tool powered by OpenAPI. This CLI tool goes a lot further than documentation, and helps with “linting” (automated API Style Guides), and solves the biggest problem that I had previously been
@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 OpenAPI 3.1, 3.0 and Swagger parser, library, validator and toolkit for golang applications. - pb33f/libopenapi
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