the gem is now updated with the rules of the api - improved documentation too