/**
* Constructor.
*
* @param AppInfo $appInfo
* See {@link getAppInfo()}
* @param string $clientIdentifier
* See {@link getClientIdentifier()}
* @param null|string $userLocale
* See {@link getUserLocale()}
*/
function __construct($appInfo, $clientIdentifier, $userLocale = null)
{
AppInfo::checkArg("appInfo", $appInfo);
Checker::argStringNonEmpty("clientIdentifier", $clientIdentifier);
Checker::argStringNonEmptyOrNull("userLocale", $userLocale);
$this->appInfo = $appInfo;
$this->clientIdentifier = $clientIdentifier;
$this->userLocale = $userLocale;
}
/**
* A way of letting you keep up with changes to files and folders in a user's Dropbox.
*
* @param string|null $cursor
* If this is the first time you're calling this, pass in <code>null</code>. Otherwise,
* pass in whatever cursor was returned by the previous call.
*
* @param string|null $pathPrefix
* If <code>null</code>, you'll get results for the entire folder (either the user's
* entire Dropbox or your App Folder). If you set <code>$path_prefix</code> to
* "/Photos/Vacation", you'll only get results for that path and any files and folders
* under it.
*
* @return array
* A <a href="https://www.dropbox.com/developers/core/docs#delta">delta page</a>, which
* contains a list of changes to apply along with a new "cursor" that should be passed into
* future <code>getDelta</code> calls. If the "reset" field is <code>true</code>, you
* should clear your local state before applying the changes. If the "has_more" field is
* <code>true</code>, call <code>getDelta</code> immediately to get more results, otherwise
* wait a while (at least 5 minutes) before calling <code>getDelta</code> again.
*
* @throws Exception
*/
function getDelta($cursor = null, $pathPrefix = null)
{
Checker::argStringNonEmptyOrNull("cursor", $cursor);
Path::checkArgOrNull("pathPrefix", $pathPrefix);
$response = $this->doPost($this->apiHost, "1/delta", array("cursor" => $cursor, "path_prefix" => $pathPrefix));
if ($response->statusCode !== 200) {
throw RequestUtil::unexpectedStatus($response);
}
return RequestUtil::parseResponseJson($response->body);
}
