API Design

Shaping an interface other people have to live with, in JSON, REST or GraphQL.

5 concepts · 165 minutes

• JSON & SerializationThe lingua franca of APIs, plus the sharp edges: dates, big integers, and undefined.
• REST API DesignResources, not verbs — designing an interface another team can use without asking you questions.
• CORSThe browser rule that blocks your fetch — and why disabling it is the wrong fix.
• PaginationOffset vs cursor — and why page 5000 of your admin table times out.
• GraphQLLet the client ask for exactly what it needs — and inherit a whole new class of problems.