added api spec to readme.md