JSON API

on YouTube ↗25m

" summary

JSON API is a concrete specification for JSON REST endpoints that claims to prevent bike-shedding by forcing one canonical document shape: root data with type/id, attributes, and relationships, plus an included array for related resources and sparse fieldsets to trim payloads. It emphasizes backward-compatible, additive-only releases (one release on May 29), targets Ember Data interoperability, lists implementations like jsonapi-resources and Rails/ActiveModelSerializers (AMS not yet v1.0 compatible), and supports bulk ops, link-based relationships, and extension negotiation.

AI-written summary · about

" chapters (15)

1. 0:00Introduction by Marco
2. 1:07What is JSON API
3. 2:33Why a JSON API spec
4. 5:49Bikeshedding and API design
5. 7:13History of JSON API
6. 9:24Goals of JSON API
7. 11:13JSON API format overview
8. 12:40Resource objects explained
9. 14:31Relationships and hypermedia
10. 17:08Including related resources
11. 18:55CRUD operations in JSON API
12. 21:48Advanced features
13. 23:16Bulk operations
14. 23:59Ruby implementations
15. 24:41Summary and conclusion

" related talks

• 11mBuilding Efficient APIs with JSON-APIRushaine McBean · GORUCO 2018
• 19mJSON API in the Ruby worldGabriela Luhova · Balkan Ruby 2018
• 21mThe API of the APIJohannes Edelstam · Jfokus 2016
• 32mFast, Testable and SANE APIsBen Lovell · Ancient City Ruby 2014
• 24mBuild The API FirstRosie Hoyem, Sonja Hall · RailsConf 2014
• 40mWriting APIs the Easy Way with Rails API and AMSPatricia Bastos · Women Dev Summit 2017
• 38mGetting Your Content Where You Need It with JSON APIChris Hamper · MidCamp 2017
• 13mJSON: The Lingua Franca of APIs (and Everything Else)Željko Kozina · Voxxed Days Luxembourg 2026