readme update, more clear methods on Endpoint, hide private attrs