Changed RESTful API spec. Updated examples. Added more rationale.
Merge pull request #33 from okTurtles/resolvers

Changed RESTful API spec. Updated examples. Added more rationale.