Function surf::patch

Important traits for Request<C>

impl<C: HttpClient> Future for Request<C> type Output = Result<Response, Exception>;

pub fn patch(uri: impl AsRef<str>) -> Request<NativeClient>

Perform a one-off PATCH request.

About the HTTP Method

The HTTP PATCH request method applies partial modifications to a resource.

The HTTP PUT method only allows complete replacement of a document. Unlike PUT, PATCH is not idempotent, meaning successive identical patch requests may have different effects. However, it is possible to issue PATCH requests in such a way as to be idempotent.

PATCH (like PUT) may have side-effects on other resources.

To find out whether a server supports PATCH, a server can advertise its support by adding it to the list in the Allow or Access-Control-Allow-Methods (for CORS) response headers.

Another (implicit) indication that PATCH is allowed, is the presence of the Accept-Patch header, which specifies the patch document formats accepted by the server.

Read more on MDN

Panics

This will panic if a malformed URL is passed.

Errors

Returns errors from the middleware, http backend, and network sockets.

Examples

let string = surf::patch("https://httpbin.org/patch").recv_string().await?;