update README.md; basic design of APIs