improving descriptions and adding usage examples
added support for non-rest urls
updated version
added event examples