Update README.md

added optional stuff to API description