Add a generic api_post method and add_comment method.
s/payload/post_body/ to be consistent with api_post signature.
Add comments to schema.
Further disambiguation.
Update json_data in test files.
Add comments if they exist.

(and fix add_comment method which wasn't formatting the post body
as proper json)
Pep8
Update schema in README.