update README with further API details