readme file updated (api specs)