A slog indeed.
For anyone interested, this is the article I hand out when someone asks me about designing a REST API: http://www.vinaysahni.com/best-practices-for-a-pragmatic-res...
And here is the HN discussion from when it was originally posted: https://news.ycombinator.com/item?id=5819231