more doc of rest api, almost finished