Rust

Send a Staged REST Request with a Text Body

Demonstrates Rest.SendReqStringBody, which sends a request whose text body (such as JSON) is supplied directly, then reads the response in separate steps.

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;
}

let _ = rest.add_header("Content-Type", "application/json");

// Send a request whose text body (such as JSON) is supplied directly.
let json_body = "{ \"name\": \"example\" }".to_string();
if rest.send_req_string_body("POST", "/api/items", &json_body).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);