restapi: Add some documentation

This patch adds some documentation and examples to the RESTAPI
subproject.

Change-Id: I2abf8f27e430769aff640acc836352660fcc61ed
Signed-off-by: Juan Hernandez <juan.hernandez@redhat.com>