master more comments
master better handling of error (unavailable method for endpoint), + doc