(Node.js) Box.com Streaming Upload File

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.

Install Chilkat for Node.js and Electron using npm at Chilkat npm packages for Node.js Chilkat npm packages for Electron on Windows, Linux, MacOSX, and ARM

var os = require('os');
if (os.platform() == 'win32') {  
    if (os.arch() == 'ia32') {
        var chilkat = require('@chilkat/ck-node21-win-ia32');
    } else {
        var chilkat = require('@chilkat/ck-node21-win64'); 
    }
} else if (os.platform() == 'linux') {
    if (os.arch() == 'arm') {
        var chilkat = require('@chilkat/ck-node21-arm');
    } else if (os.arch() == 'x86') {
        var chilkat = require('@chilkat/ck-node21-linux32');
    } else {
        var chilkat = require('@chilkat/ck-node21-linux64');
    }
} else if (os.platform() == 'darwin') {
    if (os.arch() == 'arm64') {
        var chilkat = require('@chilkat/ck-node21-mac-m1');
    } else {
        var chilkat = require('@chilkat/ck-node21-macosx');
    }
}

function chilkatExample() {

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

    var rest = new chilkat.Rest();
    var success;

    //   Provide a previously obtained OAuth2 access token.
    var oauth2 = new chilkat.OAuth2();
    oauth2.AccessToken = "BOX_ACCESS_TOKEN";
    rest.SetAuthOAuth2(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.
    var bAutoReconnect = true;

    // ----------------------------------------------------------------------
    // IMPORTANT: Note that the domain is "upload.box.com", not "api.box.com"
    // ----------------------------------------------------------------------
    success = rest.Connect("upload.box.com",443,true,bAutoReconnect);
    if (success !== true) {
        console.log(rest.LastErrorText);
        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.)

    rest.AddHeader("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"}}
    var jsonAttr = new chilkat.JsonObject();
    jsonAttr.UpdateString("name","hedgehogs.jpg");
    jsonAttr.UpdateString("parent.id","0");

    rest.PartSelector = "1";
    rest.AddHeader("Content-Disposition","form-data; name=\"attributes\"; ");
    rest.SetMultipartBodyString(jsonAttr.Emit());

    // The upload will stream directly from a file.
    rest.PartSelector = "2";
    rest.AddHeader("Content-Disposition","form-data; name=\"file\"; filename=\"hedgehogs.jpg\"");
    // "application/octet-stream" can be safely used for any type file..
    rest.AddHeader("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. 
    var fileStream = new chilkat.Stream();
    fileStream.SourceFile = "qa_data/jpg/hedgehogs.jpg";
    rest.SetMultipartBodyStream(fileStream);

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

    // Send the multipart/form-data request, which uploads the file by streaming directly from the filesystem.
    var responseBody = rest.FullRequestMultipart("POST","/api/2.0/files/content");
    if (rest.LastMethodSuccess !== true) {
        console.log(rest.LastErrorText);
        return;
    }

    // A 201 is received for a successful upload
    if (rest.ResponseStatusCode !== 201) {
        console.log("Box.com upload failed.");
        console.log("Request header:");
        console.log(rest.LastRequestHeader);
        console.log("---");
        console.log("Response status code = " + rest.ResponseStatusCode);
        console.log("Response body:");
        console.log(responseBody);
        return;
    }

    console.log("File uploaded.");

}

chilkatExample();