Improve documentation example snippets

[lealceldeiro]

In the documentation some http sample snippets contain fields not described in the api docs, so they should either be removed from the example, or they should be documented.

Example:

for endpoint POST /post

The request snippet contains the following request fields, not documented:

• publishedBy
• updatedBy
• publishedOn
• updatedOn