I want to start doing programmy things, is there any documentation on API endpoints I can use for reference? Or do I just have to reverse-engineer the code from github?
I want to start doing programmy things, is there any documentation on API endpoints I can use for reference? Or do I just have to reverse-engineer the code from github?
See https://github.com/LemmyNet/lemmy/issues/2937 for a recent discussion about this.
The TLDR is that they used to, but they became unmaintained. They recommend autogenerating your openapi/library from the rust code directly, like their typescript library does.
Edge cases are undocumented at the moment, and the devs are focusing on keeping the site up atm instead of making more detailed docs.
There are over 250 endpoints, so don’t try to implement them all by hand, just use a code generator, Rust is very strongly typed and your code generator will get it right the first time.
could this be done in their Github Actions so it’s easily accessible? I think it’s possible to have Github Actions update a Github Wiki
That would be smart. I’m sure there is some sort of toolchain that can go from rust -> openAPI -> markdown -> docs page.
Could be worth looking into over the next few weeks, but personally, I’m very busy with building Lemmy instances at the moment.