NewRequest returns a new request to the provided URL using the provided HTTP method.

Body sets the body for the request. If the Body also implements io.Closer, it is closed at the end of a request. If the body implements io.Seeker (su

SetHeader sets the header k to the value v, overwriting any previous values. NOTE: see package comment about builder pattern.

AddHeader appends the value v to the header k. NOTE: see package comment about builder pattern.

AddTrailer appends the value v to the trailer k. NOTE: see package comment about builder pattern.

Close immediately closes the underlying connection, even if it's still in use. To shut it down as soon as gracefully possible, ... TODO.

Code returns the numeric HTTP status code.

= TODO

Do executes the HTTP request and returns the response. On error, the the error will be one of: -

FormValues sets the Request's Content-Type to "application/x-www-form-urlencoded" and encodes the provided data values as its body. NOTE: see package

IsClientError reports whether s is in the Client Error (4xx) status code class, as defined by RFC 7231 section 6.5.

IsNotModified reports whether s is the 304 Not Modified status.

IsServerError reports whether s is in the Server Error (5xx) status code class, as defined by RFC 7231 section 6.6.

IsSuccess reports whether s is in the Successful (2xx) status code class, as defined by RFC 7231 section 6.3.

JSONMarshal returns a response Handler that unmarshals the JSON response into dst.

Jar ... NOTE: see package comment about builder pattern.

LimitBytes limits the response bytes. By default, LimitBytes is bounded to a reasonable upper bound (currently 128 MiB), unless overridden by a Handl

NewGet returns a new GET request to the provided URL.

NewHead returns a new HEAD request to the provided URL. A Head response never contains a body, so any attempt to read its body is an error.

NewPost returns a new POST request to the provided URL.

NewPut returns a new PUT request to the provided URL.

PermitsResponseBody reports whether the status code s permits having a response body.

Pool sets the connection pool to use with this connection. As a special case, the nil pool disables connection reuse. NOTE: see package comment ab

Protocol returns the protocol being used to talk to the server.

RedirectPolicy ... By default, N redirects are followed. TODO: specifies cookies. As a special case, the nil redirect policy disables all redirects

RestartableBody is like Body, but sets a func which returns the Body as needed. The function may be called 0, 1, or multiple times.

SetTrailer sets the trailer k to the value v, overwriting any previous values. NOTE: see package comment about builder pattern.

String returns a combination of the Code and Text in the form of "200 OK".

Text returns the textual description of the status code. For HTTP/1.x responses, this is exactly what the server sent in the "reason-phrase" of the "

Timeout sets the timeout for the entire request, including any redirects and reading the response body. If the context expires first, the request sti

Valid reports whether the status is in a known range (1xx to 5xx).

unexported method so we can extend this interface over time without breaking people. Implementers must embed a concrete type from elsewhere.