this post was submitted on 07 Sep 2025
22 points (100.0% liked)

PieFed API & mobile app dev

115 readers
1 users here now

Announcements and discussions about the PieFed API - changes, improvements and general co-ordination between the frontend developers and the core of PieFed.

founded 2 months ago
MODERATORS
 

There's a massive backlog of awesome stuff that really needs to be released so I'll be doing that within the next week or two.

Along with that there have been several small changes to the API, mostly just fields being renamed. wjs018 has been posting to this community about them as he goes, please take a look if you haven't already. We have two swagger docs available, the automatically-updated one that includes all the changes at https://crust.piefed.social/api/alpha/swagger and the old one at https://freamon.github.io/piefed-api/

There is a new endpoint at https://crust.piefed.social/api/alpha/site/version which will tell you which version the instance is running on. You can get the same information at https://crust.piefed.social/api/alpha/site but /version is lighter on the server so please use that where possible.

you are viewing a single comment's thread
view the rest of the comments
[–] Xylight@feddit.online 3 points 1 month ago (2 children)

Where did all the "Post" methods go on the main docs? They seem to be missing

[–] rimu@piefed.social 5 points 1 month ago

Those are in the old docs.

The new docs are automatically generated from the code, so they're more accurate. But making that happen involves lots of changes to the code so we're working through them slowly.

[–] rimu@piefed.social 2 points 1 month ago (1 children)

I have just finished swagger-ising all the endpoints so https://crust.piefed.social/api/alpha/swagger has the Post methods now.

[–] Xylight@feddit.online 4 points 1 month ago (1 children)

Thanks! Sorry for sounding a bit angry, I wasn't aware that manual work was needed.

[–] rimu@piefed.social 3 points 1 month ago

I didn't interpret it that way, I'm a no-fluff communicator too.

It involved 3 of our most active developers and it took over a month because it's quite boring and a little difficult so it's hard to focus on it. It was a slog but we got there and it'll make development much easier for the frontend folks in future.