If the folder itself that the cursor refers to is deleted, the call will return a 409 path error. This indicates you should issue a new call to /files/list_folder and iterate to obtain a new cursor. A call to continue with an expired cursor will return a 409 reset error.
#Dropbox api pricing update
Thus, while polling, be sure to always update to the latest returned cursor - even if no results are returned. PollingĪs a result of this property of folder cursors, storing the cursor value allows you to poll for changes to the target directory.įolder cursors are long-lived, but may expire if unused for an extend time. The ListFolderResult returned in the call includes indication of file change (add/modify), folder change, or deletion. Your list /files/list_folder_continue with a given cursor may return 0 results with has_more:false now, but calling it after modifying content in the folder will return those changes.
Folder cursors are pointers to the folder at a particular time - and thus you may use a cursor to fetch changes that occurred after the time the cursor value was issued.
However, these cursors are not only for useful pagination. Successfully enumerating all files in a folder requires calling /files/list_folder_continue with each successive cursor string until has_more is false. This call also returns the has_more boolean, indicating if more results are available, as well as a cursor. The /files/list_folder API call is used to list content with a Dropbox folder. Dropbox provides tools for developers to poll, wait for, or be notified of changes to users files.
0 kommentar(er)
