Ah yes, all though I ve never really experienced HTTP days in their full glory
I’ll look into using it. If it has a github action or easy way to publish it from cli
I do not see how critisms for the JS API docs are relevant for my openapi documentation.
This documentation aims to solve all those problems in a language agnostic way. It descibes the endpoints, the request object, the status, the response object, the authentication needed in visual/text. It allows you test it right from the browser, allows you to copy a working curl command, search for endpoints based on keywords, allows you to import the entire spec into postman/alts.
I ve never had any problems with CF instances but I mostly test with voyager.lemmy.ml
Looks like the best openapi front. I looked into using it, but it didn’t seem free. Too bad this one is outdated. Lemmys API has changed quiet a bit since then.
(Author btw)
Can you expand on this? This was written for Kotlin usage. It automates generating API based on this spec.
I have no idea what you mean with ‘using other approaches to calling the endpoints’
Lemmy has only one API. It’s same API used for lemmy-ui.
This is just a “better” documentation for it.
The API works for for cloudfare instances too.
There is also a swagger ui variant
Ah I misunderstood, you want list without the thumbnail at all?
In the feed you can find the post view mode in the top right more options menu.
Yeah anywhere were you would use Java. Scala has a too high adoption cost. Kotlin is better suited for enterprise, has a stronger ecosystem and better interop with Java. I did enjoy scala though when experimented with it. The only thing I missed was the lack of control flow, no labels, continue, break
Yes but now it must wait for acknowledgement of a request (activity), before sending the next one. If one request takes 333ms means you can do max 3 requests per second. Now big instances like lemmy.world have activity above that so instances too far will perpetual lag behind
https://github.com/LemmyNet/lemmy/issues/4529
What’s your ping with Lemmy.world?
Mostly because Lemmy has a hard time keeping up with the federation
I genuinely don’t understand how there can be so many languages and all of them be painful to use
What about kotlin?
The swipe gesture feature uses a new experimental component. As far as I am aware we can’t configure the sensitivity. We have decided to have it off by default. We also fixed the swipe direction not being aligned with the description.
Probably tommorow
There is a bug that in communityview of an 0.18 instance it will only show first page. It is fixed but not released yet.
I prefer making the action fully configureable (like even setting to nothing), over having a swap action setting.
It’s more the other way around, some ppl prefered, having the bar collapsed by default. And then hold to reveal it
That’s already been fixed, and will be part of 0.0.51
My first attempt, is making a Kotlin multiplatform backwards compatible Lemmy API client. I’ll see how it plays out.
This could use indeed some work
openapi spec allows one to specify the authentication, this has not be done already because there is an open issue to include auth in
lemmy-js-client
(I use this to generate the spec) + Need to figure the best approach to convey “elevated” auth endpoints. Endpoints like GetSite where authentication enhances the response.They are actually summaries, they are fine imo. There is an open issue to add the descriptions though.
Yes indeed, things like this should be documented in the description.
This is explicitly mentioned on every request, visually and in the spec.
Query is mentioned when they are query parameters, else it just a request body. This is pretty clear in the text (spec) or visually imo.
GetPersonDetails
is the name of the object if you scroll all the way to the bottom you can inspect it. This more clear in the spec.There is not a single endpoint missing nor its requests.
This could be improved.
Status codes? or the 400 lemmy error? ex:
{ error: "report_reason_required" }
Status codes are the same everywhere, 200/201 or 400 with Lemmy error as response. There is one exception that is 401 that can be thrown for every auth required endpoint where auth fails. But these are standard. Ig this should documented.Now the “LemmyErrorTypes”. This could be improved, but it is hard to, not possible to be automated and tedious to add and frequently changes.
Thanks for the feedback.