C++ Box: Upload File

Back to Index

Uploads a file to a destination (parent) folder. The BOX_FOLDER_ID should be replaced with the id of the folder, or 0 for the root folder.

Documentation: https://developer.box.com/reference#upload-a-file

CURL Command

curl https://upload.box.com/api/2.0/files/content \
  -H "Authorization: Bearer BOX_ACCESS_TOKEN" -X POST \
  -F attributes='{"name":"tigers.jpeg", "parent":{"id":"BOX_FOLDER_ID"}}' \
  -F file=@tigers.jpeg

C++ Example

#include <CkRest.h>
#include <CkStream.h>
#include <CkJsonObject.h>

void ChilkatSample(void)
    {
    CkRest rest;
    bool success;

    //  URL: https://upload.box.com/api/2.0/files/content
    bool bTls = true;
    int port = 443;
    bool bAutoReconnect = true;
    success = rest.Connect("upload.box.com",port,bTls,bAutoReconnect);
    if (success != true) {
        std::cout << "ConnectFailReason: " << rest.get_ConnectFailReason() << "\r\n";
        std::cout << rest.lastErrorText() << "\r\n";
        return;
    }

    rest.put_PartSelector("1");
    rest.AddHeader("Content-Disposition","form-data; name=\"attributes\"");
    rest.SetMultipartBodyString("{\"name\":\"tigers.jpeg\", \"parent\":{\"id\":\"BOX_FOLDER_ID\"}}");

    rest.put_PartSelector("2");
    CkStream fileStream2;
    fileStream2.put_SourceFile("tigers.jpeg");
    rest.AddHeader("Content-Disposition","form-data; name=\"tigers.jpeg\"; filename=\"tigers.jpeg\"");
    rest.AddHeader("Content-Type","image/jpeg");
    rest.SetMultipartBodyStream(fileStream2);

    rest.put_PartSelector("0");

    rest.AddHeader("Authorization","Bearer BOX_ACCESS_TOKEN");

    rest.put_PartSelector("0");
    rest.AddHeader("Content-Type","multipart/form-data");

    const char *strResponseBody = rest.fullRequestMultipart("POST","/api/2.0/files/content");
    if (rest.get_LastMethodSuccess() != true) {
        std::cout << rest.lastErrorText() << "\r\n";
        return;
    }

    CkJsonObject jsonResponse;
    jsonResponse.Load(strResponseBody);

    int total_count;
    int i;
    int count_i;
    const char *type = 0;
    const char *id = 0;
    const char *sequence_id = 0;
    const char *etag = 0;
    const char *sha1 = 0;
    const char *name = 0;
    const char *description = 0;
    int size;
    int path_collectionTotal_count;
    const char *created_at = 0;
    const char *modified_at = 0;
    bool trashed_at;
    bool purged_at;
    const char *content_created_at = 0;
    const char *content_modified_at = 0;
    const char *created_byType = 0;
    const char *created_byId = 0;
    const char *created_byName = 0;
    const char *created_byLogin = 0;
    const char *modified_byType = 0;
    const char *modified_byId = 0;
    const char *modified_byName = 0;
    const char *modified_byLogin = 0;
    const char *owned_byType = 0;
    const char *owned_byId = 0;
    const char *owned_byName = 0;
    const char *owned_byLogin = 0;
    bool shared_link;
    const char *parentType = 0;
    const char *parentId = 0;
    const char *parentSequence_id = 0;
    const char *parentEtag = 0;
    const char *parentName = 0;
    const char *item_status = 0;
    int j;
    int count_j;
    bool sequence_id_bool;
    bool etag_bool;

    total_count = jsonResponse.IntOf("total_count");
    i = 0;
    count_i = jsonResponse.SizeOfArray("entries");
    while (i < count_i) {
        jsonResponse.put_I(i);
        type = jsonResponse.stringOf("entries[i].type");
        id = jsonResponse.stringOf("entries[i].id");
        sequence_id = jsonResponse.stringOf("entries[i].sequence_id");
        etag = jsonResponse.stringOf("entries[i].etag");
        sha1 = jsonResponse.stringOf("entries[i].sha1");
        name = jsonResponse.stringOf("entries[i].name");
        description = jsonResponse.stringOf("entries[i].description");
        size = jsonResponse.IntOf("entries[i].size");
        path_collectionTotal_count = jsonResponse.IntOf("entries[i].path_collection.total_count");
        created_at = jsonResponse.stringOf("entries[i].created_at");
        modified_at = jsonResponse.stringOf("entries[i].modified_at");
        trashed_at = jsonResponse.IsNullOf("entries[i].trashed_at");
        purged_at = jsonResponse.IsNullOf("entries[i].purged_at");
        content_created_at = jsonResponse.stringOf("entries[i].content_created_at");
        content_modified_at = jsonResponse.stringOf("entries[i].content_modified_at");
        created_byType = jsonResponse.stringOf("entries[i].created_by.type");
        created_byId = jsonResponse.stringOf("entries[i].created_by.id");
        created_byName = jsonResponse.stringOf("entries[i].created_by.name");
        created_byLogin = jsonResponse.stringOf("entries[i].created_by.login");
        modified_byType = jsonResponse.stringOf("entries[i].modified_by.type");
        modified_byId = jsonResponse.stringOf("entries[i].modified_by.id");
        modified_byName = jsonResponse.stringOf("entries[i].modified_by.name");
        modified_byLogin = jsonResponse.stringOf("entries[i].modified_by.login");
        owned_byType = jsonResponse.stringOf("entries[i].owned_by.type");
        owned_byId = jsonResponse.stringOf("entries[i].owned_by.id");
        owned_byName = jsonResponse.stringOf("entries[i].owned_by.name");
        owned_byLogin = jsonResponse.stringOf("entries[i].owned_by.login");
        shared_link = jsonResponse.IsNullOf("entries[i].shared_link");
        parentType = jsonResponse.stringOf("entries[i].parent.type");
        parentId = jsonResponse.stringOf("entries[i].parent.id");
        parentSequence_id = jsonResponse.stringOf("entries[i].parent.sequence_id");
        parentEtag = jsonResponse.stringOf("entries[i].parent.etag");
        parentName = jsonResponse.stringOf("entries[i].parent.name");
        item_status = jsonResponse.stringOf("entries[i].item_status");
        j = 0;
        count_j = jsonResponse.SizeOfArray("entries[i].path_collection.entries");
        while (j < count_j) {
            jsonResponse.put_J(j);
            type = jsonResponse.stringOf("entries[i].path_collection.entries[j].type");
            id = jsonResponse.stringOf("entries[i].path_collection.entries[j].id");
            sequence_id_bool = jsonResponse.IsNullOf("entries[i].path_collection.entries[j].sequence_id");
            etag_bool = jsonResponse.IsNullOf("entries[i].path_collection.entries[j].etag");
            name = jsonResponse.stringOf("entries[i].path_collection.entries[j].name");
            j = j + 1;
        }

        i = i + 1;
    }
    }

Sample JSON Response Body

{
  "total_count": 1,
  "entries": [
    {
      "type": "file",
      "id": "5000948880",
      "sequence_id": "3",
      "etag": "3",
      "sha1": "134b65991ed521fcfe4724b7d814ab8ded5185dc",
      "name": "tigers.jpeg",
      "description": "a picture of tigers",
      "size": 629644,
      "path_collection": {
        "total_count": 2,
        "entries": [
          {
            "type": "folder",
            "id": "0",
            "sequence_id": null,
            "etag": null,
            "name": "All Files"
          },
          {
            "type": "folder",
            "id": "11446498",
            "sequence_id": "1",
            "etag": "1",
            "name": "Pictures"
          }
        ]
      },
      "created_at": "2012-12-12T10:55:30-08:00",
      "modified_at": "2012-12-12T11:04:26-08:00",
      "trashed_at": null,
      "purged_at": null,
      "content_created_at": "2013-02-04T16:57:52-08:00",
      "content_modified_at": "2013-02-04T16:57:52-08:00",
      "created_by": {
        "type": "user",
        "id": "17738362",
        "name": "sean rose",
        "login": "sean@box.com"
      },
      "modified_by": {
        "type": "user",
        "id": "17738362",
        "name": "sean rose",
        "login": "sean@box.com"
      },
      "owned_by": {
        "type": "user",
        "id": "17738362",
        "name": "sean rose",
        "login": "sean@box.com"
      },
      "shared_link": null,
      "parent": {
        "type": "folder",
        "id": "11446498",
        "sequence_id": "1",
        "etag": "1",
        "name": "Pictures"
      },
      "item_status": "active"
    }
  ]
}