Post details
@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.
@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, enterprise grade OpenAPI 3.1, 3.0 and Swagger 2.0 parser, library and toolkit for golang applications. - GitHub - pb33f/libopenapi: libopenapi is a...
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.
Running Swagger UI to Verify Local OpenAPI/Swagger Documents (2 mins read).
How to run Swagger UI locally to visualise OpenAPI documents.
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.
Darrel Miller (@darrel_miller)Mon, 17 May 2021 12:18 +0000
You're currently viewing page 1 of 2, of 60 posts.