Perl 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

Perl Example

use chilkat();

$rest = chilkat::CkRest->new();

#  URL: https://upload.box.com/api/2.0/files/content
$bTls = 1;
$port = 443;
$bAutoReconnect = 1;
$success = $rest->Connect("upload.box.com",$port,$bTls,$bAutoReconnect);
if ($success != 1) {
    print "ConnectFailReason: " . $rest->get_ConnectFailReason() . "\r\n";
    print $rest->lastErrorText() . "\r\n";
    exit;
}

$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");
$fileStream2 = chilkat::CkStream->new();
$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");

$strResponseBody = $rest->fullRequestMultipart("POST","/api/2.0/files/content");
if ($rest->get_LastMethodSuccess() != 1) {
    print $rest->lastErrorText() . "\r\n";
    exit;
}

$jsonResponse = chilkat::CkJsonObject->new();
$jsonResponse->Load($strResponseBody);

$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"
    }
  ]
}