donutdan4114/box-view-api

PHP SDK for the Box View API.

Box View PHP SDK

NOTE: No longer supported. Check out the official Box View PHP SDK., _(*1)

Created by Daniel Pepin @ CommonPlaces, Inc
Sponsored by LawJacked, _(*2)

Documentation

For general API documentaion, please review the Box View API Documentation., _(*3)

To get started, Include the required classes:, _(*4)

require 'lib/box-view-api.php';
require 'lib/box-view-document.php';

Intializing the API class:, _(*5)

$api_key = 'YOUR_API_KEY';
$box = new Box_View_API($api_key);

Creating a document to upload:, _(*6)

$doc = new Box_View_Document();
$doc->name = 'My Awesome Document';
$doc->file_url = 'http://my-public-url';
$doc->thumbnails = '128×128,256×256'; // Comma-separated list of thumbnail dimensions of the format {width}x{height} e.g. 128×128,256×256
$doc->non_svg = false; // boolean (default=false)

Uploading a document to the API:, _(*7)

$box->upload($doc);

You can also upload local files through the API:, _(*8)

$doc = new Box_View_Document(array(
  'name' => 'My Local File',
  'file_path' => '/path/to/file/CV_Template1.doc',
));
$box->upload($doc);

Uploading an array of documents to the API:, _(*9)

// Create array of Box_View_Document objects.
$docs[] = new Box_View_Document(array('file_url' => 'http://foo.bar/why-cats-purrrr.pdf'));
$docs[] = new Box_View_Document(array('file_url' => 'http://foo.bar/10-ways-to-love-your-cat.docx'));
$docs[] = new Box_View_Document(array('file_url' => 'http://foo.bar/funny-cat-links.xlsx'));

// Wrap API calls in try/catch.
try
{
  $box->uploadMultiple($docs);
}
catch(Exception $e)
{
  log('error', $e->getMessage());
}

After some time, the document will be processed and can be viewed:, _(*10)

$box->view($doc);
echo $doc->session->url; // Links to the HTML5 document.

Embed the document in an iframe., _(*11)

<iframe src="<?= $doc->session->url ?>"></iframe>

Retrieve a thumbnail image of the first page of a document. Thumbnails can have a width between 16 and 1024 pixels and a height between 16 and 768 pixels., _(*12)

$img = $box->getThumbnail($doc, $width, $height);
<img src="data:image/png;base64,<?= base64_encode($img) ?>"/>

Showing a PDF version of the file., _(*13)

$box->getPDF($doc);
header('Content-Type: application/pdf');
print $doc->content->pdf;

Getting a Zip folder containing the HTML5 files for the document:, _(*14)

$box->getZip($doc);
file_put_contents($doc->name . '.zip', $doc->content->zip);
// Unzip the file.

Deleting the document:, _(*15)

$box->delete($doc);

Handling Exceptions

API calls will throw an instance of Box_View_Exception when an error is encountered.
You should wrap your API calls with a try/catch., _(*16)

try
{
  $box->upload($doc);
}
catch(Exception $e)
{
  log('error', $e->getMessage(), $http_code = $e->getCode());
}