Hacker News new | ask | show | jobs
by KillerRAK 3564 days ago
Resource verbs in POST URLs are almost always a bad idea. You POST a command via the body to the resource and should expect a result in turn.

Though I do understand the idea that URLs with verbs allow the API to be self describing via links, I think it's a bit naive (and verbose) to think a user will get all the info they need from hitting the API. RAML and its variants do a great job of conveying this information.