Update Shelf (Pillar) API documentation

[aiboyles]

The Pillar API document currently has a template listing all available endpoints: https://github.com/coralproject/docs/blob/master/docs_dir/pillar/api.md

Each endpoint should have the following information:

• The parameters.
• The message body (for POST endpoints).
• An example call.
• An example response.

Some endpoints already have some information filled in (such as parameters), but it may not be correct.

[jde]

When looking into api documentation, take a look at this: http://swagger.io/ It allows us to describe our apis, document them and allow people to play with them.

[sfphoenix]

Pillar Endpoints - import, tag, search, update, form, galleries, etc

[sfphoenix]

Endpoints need to be documented with resource names, properties and example calls.

[sfphoenix]

Thanks for the feedback @gabelula. I've updated the title of this issue and will be creating additional issue items for Askd and Corald 👍