public function metadata($path = '', $fileLimit = 10000, $hash = false, $list = true, $includeDeleted = false, $rev = null, $locale = null, $sandbox = false)
{
// build url
$url = '1/metadata/';
$url .= $sandbox ? 'sandbox/' : 'dropbox/';
$url .= trim((string) $path, '/');
// build parameters
$parameters = null;
$parameters['file_limit'] = (int) $fileLimit;
if ((bool) $hash) {
$parameters['hash'] = '';
}
$parameters['list'] = $list ? 'true' : 'false';
if ((bool) $includeDeleted) {
$parameters['include_deleted'] = 'true';
}
if ($rev !== null) {
$parameters['rev'] = (string) $rev;
}
if ($locale !== null) {
$parameters['locale'] = (string) $locale;
}
// make the call
return (array) $this->doCall($url, $parameters);
}