typo fixes and conforming to REST api practices