Rust

Send a Staged Form-URL-Encoded REST Request

Demonstrates Rest.SendReqFormUrlEncoded, which sends an application/x-www-form-urlencoded request whose body is built from the query parameters added to the object.

Background. The staged request model separates sending from reading: a SendReq method transmits the request, ReadResponseHeader reads the status line and headers, and a ReadResp method reads the body. This gives fine control over large or streamed messages compared with the single-call full-request methods.

Chilkat Rust Downloads

Download Chilkat for Rust

Rust


let rest = chilkat::Rest::new();
let b_tls = true;
let b_auto_reconnect = true;
if rest.connect("example.com", 443, b_tls, b_auto_reconnect).is_err() {
    println!("{}", rest.last_error_text());
    return;
}

// The form body is built from the query parameters added to the object.
let _ = rest.add_query_param("username", "alice");
let _ = rest.add_query_param("action", "login");

// Send the application/x-www-form-urlencoded request.
if rest.send_req_form_url_encoded("POST", "/api/login").is_err() {
    println!("{}", rest.last_error_text());
    return;
}

// After sending, read the response status line and header fields.  The return value is the HTTP
// status code, or -1 if no response was received.
let status_code = rest.read_response_header();
if status_code < 0 {
    println!("{}", rest.last_error_text());
    return;
}

println!("Response status code: {}", status_code);

// Read the response body as text.
let Ok(response_body) = rest.read_resp_body_string() else {
    println!("{}", rest.last_error_text());
    return;
};

println!("{}", response_body);