update GET method & add api doc