Mastodawn

The #mastodon #openapi parser now includes example response payloads, error types, and rate limiting headers.

https://abraham.github.io/mastodon-openapi/

Mastodon API

CouchDB also seems to be a technically simple solution—although it seems more difficult to use. And it's built with erlang!

1. Automatically generating OpenAPI documentation for your web resources doesn't seem doable, but there's perhaps CouchDB's own form of API documentation.
2. HTTP OPTIONS requests are accepted although poorly documented from what I could find.

It'd be nice if CouchDB supported learning about it's API through OpenAPI documentation.

#CouchDB #HTTP #REST #OpenAPI #erlang

Show thread

Richard Freeman 3d ago

Implementing this in as technically simple a manner as is possible can be done using postgREST, on top of postgres and nginx.

1. OpenAPI: https://docs.postgrest.org/en/v12/references/api/openapi.html
2. HTTP OPTIONS: https://docs.postgrest.org/en/v12/references/api/options.html

#postgres #postgREST #HTTP #REST #OpenAPI

OpenAPI

PostgREST automatically serves a full OpenAPI description on the root path. This provides a list of all endpoints (tables, foreign tables, views, functions), along with supported HTTP verbs and example payloads. For extra customization, the OpenAPI output contains a “description” field for every ...

PostgREST 12.2

DeployHQ 4d ago

Ready to streamline your API workflow? 🚀

Our latest blog post dives into how OpenAPI fosters seamless development and collaboration, helping you build better APIs, faster.

Read the deep dive: https://www.deployhq.com/blog/unlocking-seamless-development-and-collaboration-a-deep-dive-into-openapi

#OpenAPI #API #DevOps #Development

Unlocking Seamless Development and Collaboration: A Deep Dive into OpenAPI

Unlock seamless development with our deep dive into OpenAPI. Learn why exposing a specification is a game-changer for collaboration and automation, explore different creation methods (manual, automated, and AI-powered), and clarify the relationship between OpenAPI and Swagger.