同步接口

基本同步接口

接口的url为/service/gateway/sync

传输方式仅仅支持POST。

fb_token 可以操作账户数据的token，通过登录接口获取；如果当前用户在当前网站已经登录，则不需要这个参数，但通常需要在页面中调用need_admin这个函数。
push_to_cloud 在有client-token参数下生效，如果为true，则表示会重新推送回Dropbox; 默认为false。如果不是通过fb_token的方式，那么push_to_cloud始终为true。
path 文件的路径，如果当前用户是当前网站的站长，则路径是相对站点目录而言的；反之，则是相对FarBox这个根目录而言的。
is_deleted: 如果为true，则表示是对当前文件进行删除操作；如果仅有path一个字段，则默认为true。
is_dir: 如果为true，表示当前路径对应的是一个文件夹。
raw_content 文件的原始内容，通过这个字段，可以不使用form来实现上传。
base64 同raw_content, 但接受base64的格式
file 使用multipart/form-data进行上传时，文件的字段名。

条件：当前登录用户是当前网站的主人

$.post(
    '/service/gateway/sync',
    {
        path: 'this-is-a-test.txt',
        raw_content: 'post content'
    }

这样一来，当前用户的站点目录内会多出一个文件this-is-a-test.txt，内容为post content。

这是基本同步接口的衍生，允许其他用户，甚至是匿名用户，向你的网站与Dropbox内推送数据。
需要确保站点设置中的sync_by_3rd已经开启，如果允许匿名用户，并且同时sync_by_3rd_public也需要开启。

接口的url为/service/gateway/sync_3rd

传输方式仅仅支持POST。

每一次数据上传，系统会自动指定一个路径来进行存放。并且，始终以share这个目录作为根目录。

可以申明一个share下的子目录，如果不声明，则会使用default。之后，则按照年/年-月/年-月-日时-分-秒这样个格式组装路径。

如果当前登录的用户对某个路径拥有编辑的权限，则可以在POST字段中，增加path字段。

如何判断编辑文档的权限？某个路径的文档数据对象中，如果metadata.account_id跟登录用户的id一致，则可进行编辑。一般能用在文章类型的文件中。