Tagged
How to read a real API docs page, using Stripe's Create a refund: seven questions for any docs, every part of the page labelled, and how to turn it into features, tickets and interview answers.
Where REST APIs, webhooks and GraphQL turn up in an online shop, from the product page to the refund, with real platform examples and one order traced end to end.
A GraphQL query taken apart, a live query builder you can send, the three kinds of operation and why errors can arrive with a 200 OK.
The pros and cons of REST, GraphQL and webhooks, when each one fits, why many teams use more than one, and the questions to ask before choosing.
A three-part, diagram-led series that explains GraphQL to product managers, with a live demo on a free API. Part 1: what GraphQL is and how it differs from REST.
How a page turns an API's JSON answer into what you see: parse it, translate it, place it. What parsing means, the words you'll hear, and every value traced to the screen.
The live weather page on this site taken apart from end to end: how it's built and served, what happens when you pick a place, and the user story behind it.
What an API key is, why some must stay secret, how GitHub Secrets keeps them out of the code, and the limits and costs to plan for.
The anatomy of an API request, the four verbs, JSON and status codes, explained with everyday comparisons.
A six-part, diagram-led series that explains APIs to product managers with everyday comparisons and a live weather demo. Part 1: what an API is and why it matters to you.