4 ms·
I'm a little surprised I didn't see the JSON:API spec [1] on there (no affiliation). While by no means a silver bullet my team has adopted it for both internal
by somada141 7y ago
I'm a little surprised I didn't see the JSON:API spec [1] on there (no affiliation). While by no means a silver bullet my team has adopted it for both internal and public APIs and our clients have been quite happy having a standardised API like that.
In addition it is fairly-well supported by community packages (at least in Pythonland, e.g., marshmallow-jsonapi [2]) so it fit quite nicely in our stack while we could incrementally come up with v2 APIs that implement it.
Lastly, the spec does a semi-decent job, again no silver-bullet, of defining more advanced API features like filtering, sorting, field-selection, etc in a way that brings a lot of the GraphQL perks into REST.
[1] https://jsonapi.org/ https://jsonapi.org/
[2] https://github.com/marshmallow-code/marshmallow-jsonapi https://github.com/marshmallow-code/marshmallow-jsonapi
- rocketpastsix 7y agoThe idea originally was just to show RFC's but I think we can start expanding the project now.
- somada141 7y agoAh sorry didn't realise it was supposed to be limited to RFCs. I suppose JSON:API would fit the `A collection of standards and specifications` title :).