API Design Practice

About API Design Practice

Given a use case, choose the best endpoint: method, path, body, and status codes, then see why the alternatives fall short.

Four candidate endpoints, one that a reviewer would sign off on. The distractors are the ones that show up in real pull requests: verbs in the path, the wrong status code, a body that leaks the internal model. Cards are drawn with spaced repetition, so the ones you miss come back sooner and the ones you know back off. Progress is kept in your browser.

Design concerns covered · 14