readme: document client API

fix #38