Post details
Framework for building high quality, interactive API documentation. - zuplo/zudoku
Framework for building high quality, interactive API documentation. - zuplo/zudoku
I'm on Go Time! (3 mins read).
Announcing my first podcast appearance on Go Time, talking about OpenAPI, oapi-codegen
, versioning, and some fun Unpopular Opinions.
New release of #oapi-codegen is out 🚀
Big changes are:
net/http
enhanced routingAnd a whole host of other changes, check out the full release notes at https://github.com/deepmap/oapi-codegen/releases/tag/v2.2.0
I'm on Cup o' Go! (2 mins read).
Announcing my appearance on Cup o' Go, talking about oapi-codegen
, OpenAPI, working on Open Source and blogging.
Very excited to be a guest on tomorrow's @cupogo and to chat about oapi-codegen
, #OpenAPI and Go!
Enhance and enrich your OpenAPI descriptions without creating conflicts in the source code using filters and overlays.
Terminal UI to list, browse and run APIs defined with openapi spec. - zaghaghi/openapi-tui
Beautiful API references from Swagger/OpenAPI files ✨ - scalar/scalar
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
Making sense of the technology, business, and politics of APIs that is impact all stages of our physical and digital worlds.
@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.
Introducing openapi-sorbet
, a command-line tool for generating Sorbet types from OpenAPI (2 mins read).
How to generate Sorbet type-checked models from OpenAPI specifications.
Cli tool (and library) for converting JSON mock objects to OpenAPI schemas - GitHub - OzzyCzech/mock-to-openapi: Cli tool (and library) for converting JSON mock objects to OpenAPI schemas
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. #DevXLorna Mitchell (@lornajane)Mon, 13 Feb 2023 20:52 GMT
OpenAPI data types for problem messages. Contribute to belgif/openapi-problem development by creating an account on GitHub.
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...
Retrofitting OpenAPI documentation to your Rails codebase (12 mins read).
How to take a Rails codebase and introduce OpenAPI documentation and contract tests, in a test-driven manner.
libopenapi is a fully featured, high performance OpenAPI 3.1, 3.0 and Swagger parser, library, validator and toolkit for golang applications. - pb33f/libopenapi
RapiDoc is Web Component for viewing Swagger & OpenAPI Spec. Supports themes, styling and various rendering styles
Rack middlewares to create OpenAPI based HTTP APIs - GitHub - ahx/openapi_first: Rack middlewares to create OpenAPI based HTTP APIs
Build, Validate, Route, Authenticate and Mock using OpenAPI - GitHub - anttiviljami/openapi-backend: Build, Validate, Route, Authenticate and Mock using OpenAPI
Generate TypeScript types from Swagger OpenAPI specs - GitHub - drwpow/openapi-typescript: Generate TypeScript types from Swagger OpenAPI specs
I'm excited to be talking at the #Deliveroo summer tech event tonight - I'll be covering #OpenAPI and we've got a tonne of stickers thanks to the awesome OpenAPI Initiative!
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.
Building a Go RESTful API with design-first OpenAPI contracts (6 mins read).
How to use oapi-codegen
to generate an RESTful API using design-first OpenAPI and code generation.
Well this is exciting, my first blog post for Deliveroo Engineering is all about OpenAPI and how we're using it to ship services quicker 🚀 https://deliveroo.engineering/2022/06/27/openapi-design-first.html
Shipping services more quickly with design-first OpenAPI contracts (8 mins read).
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.
Describing a multi-value querystring parameter in OpenAPI (1 mins read).
How to define a querystring parameter that has multiple values, in OpenAPI.
Setting up OpenAPI Contract Tests with a Rails and RSpec codebase (2 mins read).
How to run OpenAPI-driven contract tests against a Rails API.
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...
This tutorial shows how to reuse the OpenAPI specification to validate requests and responses in a Rails application using the gem Committee.
rails and committee are good friends. Contribute to willnet/committee-rails development by creating an account on GitHub.
A collection of Rack middleware to support JSON Schema. - GitHub - interagent/committee: A collection of Rack middleware to support JSON Schema.
Describing JSON Patch operations with OpenAPI (2 mins read).
How to describe your JSON Patch endpoints using OpenAPI.
Introducing a library for OpenAPI contract testing with Go's net/http
package (2 mins read).
Creating a Go library that can verify net/http
handlers implement an OpenAPI contract, for use with testing.
Generating a Go HTTP Client from OpenAPI schemas (2 mins read).
How to generate a Go HTTP client really quickly and easily, with no manual work, using the oapi-codegen project.
Generating Go structs from OpenAPI schemas (2 mins read).
How to generate Go structs really quickly and easily, with no manual work, using the oapi-codegen project.
Generate Go client and server boilerplate from OpenAPI 3 specifications - GitHub - deepmap/oapi-codegen: Generate Go client and server boilerplate from OpenAPI 3 specifications
Accessing the OpenAPI Specification for a Kubernetes Cluster (1 mins read).
How to get the OpenAPI specification for your Kubernetes Cluster.
Generate a running mock server from an OpenAPI specification using Prism (3 mins read).
Using Stoplight's prism
tool to run a stubbed server from an OpenAPI specification, for better testing.
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…Postman (@getpostman)Thu, 17 Feb 2022 18:00 GMT
Bundling Multi-File OpenAPI Documents into a Single File (2 mins read).
Looking at the options we have for converting a multi-file OpenAPI specification to a single document.
Announcing openapi.tanna.dev
, a client-side OpenAPI Viewer (1 mins read).
Creating a hosted version of a local and client-side only OpenAPI viewer.
Generate Plain Old Java Objects (POJOs) from OpenAPI Model Definitions with Gradle (2 mins read).
How to generate POJOs really quickly and easily, with no manual work, using the Gradle openapi-generator Plugin.
Running Elements API Viewer to Verify Local OpenAPI/Swagger Documents (2 mins read).
How to run Elements UI locally to visualise OpenAPI documents.
You're currently viewing page 1 of 2, of 70 posts.