Heuristics for Designing Flexible REST APIs: a Thought Process

A fair amount of software development involves interacting with APIs. I want to present some issues that I considered for a tagging API that I recently designed. I intend to only present the thinking process by discussing what capabilities each decis...