This commit adds some more detailed information about how to actually get the number of likes for a post. Also refactors some requests and responses into json schema files to clean up the specs a bit. See https://meta.discourse.org/t/69017/4?u=blake
