add some details to the API documentation

Details include an explanation of what happens with `GET page html errors`