added rest request and request interface
added some docblocks
added response transformer and interface
enhanced sample file