readme: api and usage