Building Efficient APIs with JSON-API

on YouTube ↗11m

" summary

Claim: the JSON-API spec reduces round trips and payload size by standardizing document shape and side‑loading related records. Evidence: a v1 spec since 2015, implementations in Ruby/Rails and JavaScript, and the JSON API Resources framework for Rails to auto-serialize and customize responses. Examples: sparse fieldsets, relationship endpoints, and error objects. Tradeoff: fewer moving parts than GraphQL and less infrastructure cost, with optimizes HTTP requests and JSON API Resources shown as practical choices.

AI-written summary · about

" chapters (15)

1. 0:00Introduction
2. 1:01What are APIs
3. 1:25JSONAPI
4. 2:10Content Type
5. 2:37Request Type
6. 3:07Resource Objects
7. 3:48Related Data
8. 4:12Links
9. 4:51fetching data
10. 5:12relationships
11. 6:08sorting
12. 6:42updating relationships
13. 7:51JSONAPI vs GraphQL
14. 9:42Why use JSONAPI
15. 10:10Outro

" related talks

• 25mJSON APIM. Otte-Witte · RubyDay 2015
• 19mJSON API in the Ruby worldGabriela Luhova · Balkan Ruby 2018
• 35mBuilding Ambitious APIs with RubyDan Gebhardt · Burlington Ruby Conference 2013
• 24mBuild The API FirstRosie Hoyem, Sonja Hall · RailsConf 2014
• 41mThe GraphQL Way: A new path for JSON APIsNick Quaranto · RailsConf 2018
• 13mJSON: The Lingua Franca of APIs (and Everything Else)Željko Kozina · Voxxed Days Luxembourg 2026
• 40mWriting APIs the Easy Way with Rails API and AMSPatricia Bastos · Women Dev Summit 2017
• 32mJSON Standards for the WebJamie Lennox · PyCon Australia 2015