Please note that this post is a work in progress, because there is a a lot of ground to cover. Shouldn’t take more than a week to flesh the whole thing out. Thanks for your patience.
This post outlines my playbook for designing a RESTful API service’s endpoints (method + URL) and return values (HTTP status code and body). It’s organized by scenario so if you know what your goal is, you can jump straight to it.