1. Comparison

OpenAPI

The OpenAPI description is incredibly flexible, but as a result, the SDK generators are notorious for generating code that isn’t idiomatic and sometimes doesn’t even compile.

When it comes to docs, some companies will generate beautiful API documentation from your OpenAPI description. But because they don’t own the SDK generation, good luck finding one that’ll automatically include examples of how to use your SDKs.

It’s not really a single source of truth because your OpenAPI description can easily drift from your backend - OpenAPI’s generated “server stubs” aren’t helpful once you make the first change to your API.

Smithy

Work in progress

Conjure

Work in progress

Hand-rolling

Work in progress