revised readme to reflect current API spec