changed resources:check to properly call role.permitted?
added rspec for id conversion functions (+refactored them)
bump version to 3.0.0; adjust requirements to api-ruby appropriately