Update ocs-share-api.rst

- Updated typos
- Added data types of arguments
- Added misc additional info