"I've dealt with many APIs that are not a pleasure to work with because they aren't RESTful. They've got strange URLs associated with them, there's no rhyme or reason to them, and the objects aren't formatted in a particular pattern. Pick a design pattern and a URL pattern that works for your company and stick with it. Don't give me a hodge-podge of different things." Such irregularity is a problem that crops up often in larger, older organizations that are maintaining a substantial amount of legacy code. Consistency is difficult to create after the fact, but it should be one focus of modernization efforts for older APIs.
Pick a design pattern and a URL pattern that works for your company and stick with it. Don't give me a hodge-podge of different things.
Mark Bates, Freelance Developer
Designing and programming with simplicity in mind