Rust

Box.com Streaming Upload File

See more Box Examples

Demonstrates how to upload a file to box.com, streaming the file directly from the filesystem.

Note: This example requires a fix that is included in Chilkat v9.5.0.70 and above.

Rust

// This requires the Chilkat API to have been previously unlocked.
// See Global Unlock Sample for sample code.

let rest = chilkat::Rest::new();

//   Provide a previously obtained OAuth2 access token.
let oauth2 = chilkat::OAuth2::new();
oauth2.set_access_token("BOX_ACCESS_TOKEN");
let _ = rest.set_auth_o_auth2(&oauth2);

// First, make the initial connection.
// A single REST object, once connected, can be used for many Box REST API calls.
// The auto-reconnect indicates that if the already-established HTTPS connection is closed,
// then it will be automatically re-established as needed.
let b_auto_reconnect = true;

// ----------------------------------------------------------------------
// IMPORTANT: Note that the domain is "upload.box.com", not "api.box.com"
// ----------------------------------------------------------------------
if rest.connect("upload.box.com", 443, true, b_auto_reconnect).is_err() {
    println!("{}", rest.last_error_text());
    return;
}

// The request body uses the "multipart/form-data" format to transmit two "parts". 
// The first part is called "attributes" and contains a JSON object with information about the file, including the name of the file 
// and the ID of the parent folder. The second part contains the contents of the file. 
// (Note that the name of the second "part" is ignored.)

let _ = rest.add_header("Content-Type", "multipart/form-data");

// Provide the content for each part of the request...

// First the JSON attributes.  Use "0" for the root folder.
//   {"name":"hedgehogs.jpg", "parent":{"id":"0"}}
let json_attr = chilkat::JsonObject::new();
let _ = json_attr.update_string("name", "hedgehogs.jpg");
let _ = json_attr.update_string("parent.id", "0");

rest.set_part_selector("1");
let _ = rest.add_header("Content-Disposition", "form-data; name=\"attributes\"; ");
let _ = rest.set_multipart_body_string(&json_attr.emit().unwrap_or_default());

// The upload will stream directly from a file.
rest.set_part_selector("2");
let _ = rest.add_header("Content-Disposition", "form-data; name=\"file\"; filename=\"hedgehogs.jpg\"");
// "application/octet-stream" can be safely used for any type file..
let _ = rest.add_header("Content-Type", "application/octet-stream");

// IMPORTANT: This example requires Chilkat v9.5.0.70 or later, for a fix that was made in
// multipart/streaming uploads. 
let file_stream = chilkat::Stream::new();
file_stream.set_source_file("qa_data/jpg/hedgehogs.jpg");
let _ = rest.set_multipart_body_stream(&file_stream);

// Restore the PartSelector to "0" (for safety, in case something else sends another request on this object)
rest.set_part_selector("0");

// Send the multipart/form-data request, which uploads the file by streaming directly from the filesystem.
let Ok(response_body) = rest.full_request_multipart("POST", "/api/2.0/files/content") else {
    println!("{}", rest.last_error_text());
    return;
};

// A 201 is received for a successful upload
if rest.response_status_code() != 201 {
    println!("Box.com upload failed.");
    println!("Request header:");
    println!("{}", rest.last_request_header());
    println!("---");
    println!("Response status code = {}", rest.response_status_code());
    println!("Response body:");
    println!("{}", response_body);
    return;
}

println!("File uploaded.");