Openapi documentation of the API

I keep coming up empty when I search for openapi documentation of the ActivityPub standard or Mastadon API. So, I’ve cloned Mastodon and started it with vagrant, collected the routes from ruby, and used python to parse that output to yaml for openapi and slowly going through each of the URIs and documenting what I can.

The tricky part of this is I know very little about Ruby or Rails(I spent a few months learning it and don’t like the language), and I’m aware of their convention over configuration so I’m sure I’m missing a lot that’s implied.

Would anyone be interested in trying to fill out the documentation? or has anyone already created openapi documentation and I’m just not finding it?

Here’s what I have sofar:
https://app.swaggerhub.com/apis/mvanorder/Mastodon/1.0.0

2 Likes