创建新应用
  目录  
  SDK & Demos  
接口访问频次权限
  • 针对一个用户在使用一个应用的请求次数限制
  • 总限制：单用户每应用 150次/分钟
保持同步
  • URL:
  • http://openapi.vdisk.me/?a=keep
  • 请求方式: POST、GET
  • 返回格式: JSON
  • 请求参数:
  • token: 动态令牌
    dologid: 参考dolog机制
  • 返回结果:
  • {
        "err_code":0,
        "err_msg":"success",
        "dologid":"72824",
        "dologdir":[0,70203,103730]
    }
  • 使用示例:
  • curl -d "token=fa7732e6ffc9e59beb99de600f93c&dologid=12824" "http://openapi.vdisk.me/?a=keep"
  • 错误编码:
  • 0: success.
    602: dolog old
获得token
  • URL:
  • http://openapi.vdisk.me/?m=auth&a=get_token
  • 请求方式: POST
  • 返回格式: JSON
  • 请求参数:
  • account: 帐号
    password: 密码
    appkey: 您的appkey
    time: 当前的时间戳, time((time_t*)NULL)
    signature: 动态签名, hmac_sha256("account=相应的值&appkey=相应的值&password=相应的值&time=相应的值", app_secret)
    PHP实例: $signature = hash_hmac('sha256', "account={$account}&appkey={$appkey}&password={$password}&time={$time}", $app_secret, false);
  • 可选参数:
  • app_type: 登录类型, 可选值(sinat:微博账号，local:微盘账号), 默认值local
  • 返回结果:
  • {
        "err_code":0,
        "err_msg":"success",
        "data":{
            "token":"c825407080f7ded69ae4aabca7b703c1",
            "uid":"62",
            "time":1288773670,
            "is_active":"1",
            "appkey":"199632"
        }
    }
  • 使用示例:
  • curl -d "scramble=1122&account=example@gmail.com&password=123456&appkey=12345678&signature=hHUvni%2BIPUzlKUvKCx5pWCPJIsWZurQ8fsaHXs7s1zk%3D&app_type=sinat" "http://openapi.vdisk.me/?m=auth&a=get_token"
  • 错误编码:
  • 0: success.
    1: signature无效.
    2: account无效.
    3: time无效.
    701: 参数不全.
    900: 超出了请求限制
保持token
  • 说明: 空闲时(不做任何操作, 15分钟后)token会失效, 所以需要保持token, 10-15分钟执行一次
  • URL:
  • http://openapi.vdisk.me/?m=user&a=keep_token
  • 请求方式: POST
  • 返回格式: JSON
  • 请求参数:
  • token: 动态令牌
    dologid: 参考dolog机制
  • 返回结果:
  • {
        "err_code":0,
        "err_msg":"success",
        "data":{
            "uid":1000001
        },
        "dologid":1024,
        "dologdir":[]
    }
  • 使用示例:
  • curl -d "token=91f95a6ded506990fbe8d722fbd95cde" "http://openapi.vdisk.me/?m=user&a=keep_token"
  • 错误编码:
  • 0: success
    702: invalid token.
    900: 超出了请求限制
文件上传(10M以下)
  • URL:
  • http://openapi.vdisk.me/?m=file&a=upload_file
  • 请求方式: POST, 必须用Multipart/form-data方式
  • 返回格式: JSON
  • 请求参数:
  • token: 动态令牌
    dir_id: 目录的id, 0为根目录
    cover: 重名时是否覆盖, yes或no
    file: 文件
    dologid: 参考dolog机制
  • 可选参数:
  • callback: 跳转的url, 会传过来msg
    dir: 目录路径，如果目录不存在会自动创建，必须斜线开头。如：/a/b/c/d 或 \a\b\c\d，有此参数，将会忽略dir_id参数，使用此参数会明显比使用dir_id参数效率低。
  • 返回结果:
  • {
        "err_code":0,
        "err_msg":"success",
        "data":{
            "fid":"168593",
            "name":"MIME.txt",
            "uid":"62",
            "dir_id":0,
            "do_dir":"0,82914,82915,82916,82917",
            "ctime":1288781102,
            "ltime":1288781102,
            "size":40049,
            "type":"text/plain",
            "md5":"07c2e4630203b0425546091d044d608b",
            "url":"http://openapi.vdisk.me/open_file/……"
        },
        "dologid":1024,
        "dologdir":[]
    }
  • 使用实例:
  • curl -F file=@filename.txt -F token=1f68cdc01158118da219aac3b1838fe5 -F cover=yes -F dir_id=0 "http://openapi.vdisk.me/?m=file&a=upload_file"
  • 错误编码:
  • 0: success.
    1: cover is formatted incorrectly.
    3: dir is non-existent.
    4: file name is not unique.
    7: 空间不足.
    6: s3 error.
    5: system error.
    101: over upload_max_filesize.
    102: over MAX_FILE_SIZE.
    103: upload not full.
    104: upload fail.
    105: 文件格式不允许分享，允许的格式：doc，docx，pdf，jpg，png，gif，ppsx，pps，ppt，pptx，xls，txt，avi
    106: 此文件不允许分享
    601: dir full.
    602: dolog old.
    701: 参数不全.
    702: invalid token.
    721: 上传出错，请重新上传.
    900: 超出了请求限制
上传文件并分享(10M以下)
  • URL:
  • http://openapi.vdisk.me/?m=file&a=upload_share_file
  • 请求方式: POST, 必须用Multipart/form-data方式
  • 返回格式: JSON
  • 请求参数:
  • token: 动态令牌
    dir_id: 目录的id, 0为根目录
    cover: 重名时是否覆盖, yes或no
    file: 文件
    dologid: 参考dolog机制
  • 可选参数:
  • callback: 跳转的url, 会传过来msg
    dir: 目录路径，如果目录不存在会自动创建，必须斜线开头。如：/a/b/c/d 或 \a\b\c\d，有此参数，将会忽略dir_id参数，使用此参数会明显比使用dir_id参数效率低。
    ip: string 终端用户IP地址
  • 返回结果:
  • {
        "err_code":0,
        "err_msg":"success",
        "data":{
            "download_page":"http://vdisk.me/?m=share&a=download&ss=……"
        },
        "dologid":1024,
        "dologdir":[]
    }
  • 使用实例:
  • curl -F file=@filename.txt -F token=1f68cdc01158118da219aac3b1838fe5 -F cover=yes -F dir_id=0 "http://openapi.vdisk.me/?m=file&a=upload_share_file"
  • 错误编码:
  • 0: success
    1: cover is formatted incorrectly
    3: dir is non-existent
    4: file name is not unique
    7: 空间不足
    6: s3 error
    5: system error
    101: over upload_max_filesize
    102: over MAX_FILE_SIZE
    103: upload not full
    104: upload fail
    105: 文件格式不允许分享，允许的格式：doc，docx，pdf，jpg，png，gif，ppsx，pps，ppt，pptx，xls，txt，avi
    106: 此文件不允许分享
    107: 此文件不允许分享
    108: 此文件不允许分享
    601: dir full
    602: dolog old
    701: 参数不全
    702: invalid token.
    900: 超出了请求限制
创建目录
  • URL:
  • http://openapi.vdisk.me/?m=dir&a=create_dir
  • 请求方式: POST
  • 返回格式: JSON
  • 请求参数:
  • token: 动态令牌
    create_name: 目录的名称
    parent_id: 父目录的id, 如果是根目录值为: 0
    dologid: 参考dolog机制
  • 返回结果:
  • {
        "err_code":0,
        "err_msg":"success",
        "data":{
            "dir_id":"35503",
            "name":"\u6d4b\u8bd5",
            "pid":0,
            "uid":"62",
            "ctime":1289271836,
            "ltime":1289271836
        },
        "dologid":1024,
        "dologdir":[]
    }
  • 使用实例:
  • curl -d "token=6c983cf83cbfc1468f0816f287d6f33c&create_name=测试&parent_name=&parent_id=0" "http://openapi.vdisk.me/?m=dir&a=create_dir"
  • 错误编码:
  • 0: success
    2: timeout token
    3: create_name characters are not allowed: \ / : ? * < > " |. Please use valid directory path. 目录名中使用了非法字符，请使用有效的目录路径。
    5: system error 系统错误
    6: create_name is not unique 新名字不是唯一的
    7: parent_id is non-existent 上级目录不存在
    601: directory full of files and directories 目录已满
    611: System directory not support create sub directory 系统目录不支持创建子目录
    702: invalid token
    909: invalid param 请求参数无效
获得列表
  • URL:
  • http://openapi.vdisk.me/?m=dir&a=getlist
  • 请求方式: POST
  • 返回格式: JSON
  • 请求参数:
  • token: 动态令牌
    dir_id: int 目录id, 为空或为0表示根目录
  • 可选参数:
  • page: int 当前页码，缺省为1
    pageSize: int 每页条数，缺省为1024，最小为2。小于 2 或大于 1024 时取默认值 1024。
    dologid: 参考dolog机制
  • 返回结果:
  • {
        "err_code":0,
        "err_msg":"success",
        "data":{
            "list":[
                {
                    "id":"1190019",
                    "name":"test.php",
                    "dir_id":"0",
                    "ctime":"1294734798",
                    "ltime":"1294734798",
                    "size":"216 Bytes",
                    "type":"text\/php",
                    "md5":"0a706f2d0958838673dea185dd4290ed",
                    "sha1":"925b8e9a606ca5b3908ab3b53117e85ebcd35cd0",
                    "share":-1,
                    "byte":"216",
                    "length":"216",
                    "thumbnail":"http:\/\/……",//图片文件
                    "url":"http:\/\/……
                },
                ……
            ],
            "pageinfo":{
                "page":1,
                "pageSize":10,
                "rstotal":19,
                "pageTotal":2
            }
        },
        "dologid":"26530",
        "dologdir":[]
    }
  • 使用实例:
  • curl -d "token=6c983cf83cbfc1468f0816f287d6f33c&page=1&pageSize=10" "http://openapi.vdisk.me/?m=dir&a=getlist"
  • 错误编码:
  • 0: success
    2: dir_id is non-existent 目录ID不存在
    702: invalid token.
    900: 超出了请求限制
    909: invalid param 参数无效
获得容量信息
  • URL:
  • http://openapi.vdisk.me/?m=file&a=get_quota
  • 请求方式: POST
  • 返回格式: JSON
  • 请求参数:
  • token: 动态令牌
  • 可选参数:
  • dologid: 参考dolog机制
  • 返回结果:
  • {
        "err_code":0,
        "err_msg":"success",
         "data":{
            "used":"1330290823",
            "total":"4294967296"
        },
        "dologid":1024,
        "dologdir":[]
    }
  • 使用实例:
  • curl -d "token=6c983cf83cbfc1468f0816f287d6f33c" "http://openapi.vdisk.me/?m=file&a=get_quota"
  • 错误编码:
  • 0: success
    702: invalid token.
    900: 超出了请求限制
无文件上传(sha1)
  • URL:
  • http://openapi.vdisk.me/?m=file&a=upload_with_sha1
  • 请求方式: POST
  • 返回格式: JSON
  • 请求参数:
  • token: 动态令牌
    dir_id: 目录id, 根目录值为: 0
    sha1: 文件的sha1值
    file_name: 文件名
    dologid: 参考dolog机制
  • 返回结果:
  • {
        "err_code":0,
        "err_msg":"success",
        "data":{
            "fid":"221685",
            "name":"\u6df1\u5165\u6d45\u51faJavaScript.pdf",
            "uid":"62",
            "dir_id":0,
            "ctime":1289282029,
            "ltime":1289282029,
            "size":"227252809",
            "type":"application\/pdf","md5":"03d5717869bb075e3bad73b527fabc8a",
            "url":"http:\/\/openapi.vdisk.me\/open_file\/……"
        },
        "dologid":1024,
        "dologdir":[]
    }
  • 使用实例:
  • curl -d "token=6c983cf83cbfc1468f0816f287d6f33c&dir_id=0&sha1=03d5717869bb075e3bad73b527fabc8a27fabc8a&file_name=深入浅出JavaScript.pdf" "http://openapi.vdisk.me/?m=file&a=upload_with_sha1"
  • 错误编码:
  • 0: success
    1: sha1 is non-existent
    3: dir is non-existent
    7: 空间不足
    6: s3 error
    5: system error
    601: dir full
    602: dolog old
    702: invalid token.
    900: 超出了请求限制
获得单个文件信息
  • URL:
  • http://openapi.vdisk.me/?m=file&a=get_file_info
  • 请求方式: POST
  • 返回格式: JSON
  • 请求参数:
  • token: 动态令牌
    fid: 文件id
    dologid: 参考dolog机制
  • 返回结果:
  • {
        "err_code":0,
        "err_msg":"success",
        "data":{
            "id":"219379", // 文件id
            "name":"VS2008TeamSuite90DayTrialCHSX1429243.part4.rar", 文件名
            "dir_id":"4280", // 目录id
            "ctime":"1289267775", // 创建时间
            "ltime":"1289267775", // 最后修改时间
            "size":"734003200", // 大小，单位(B)
            "type":"application\/x-rar-compressed",
            "md5":"5cdad57bc23f64e17fd64b45e3bf3308",
            "url":"http:\/\/openapi.vdisk.me\/open_file\/……", // 分享地址
            "s3_url":"http:\/\/data.vdisk.me\/1245/" // 下载地址
        },
        "dologid":1024,
        "dologdir":[]
    }
  • 使用实例:
  • curl -d "token=6c983cf83cbfc1468f0816f287d6f33c&fid=219379" "http://openapi.vdisk.me/?m=file&a=get_file_info"
  • 错误编码:
  • 0: success
    1: fid is formatted incorrectly
    3: file is non-existent
    702: invalid token.
    900: 超出了请求限制
删除目录
  • URL:
  • http://openapi.vdisk.me/?m=dir&a=delete_dir
  • 请求方式: POST
  • 返回格式: JSON
  • 请求参数:
  • token: 动态令牌
    dir_id: 目录id (不能为0)
    dologid: 参考dolog机制
  • 返回结果:
  • {
        "err_code":0,
        "err_msg":"success",
        "dologid":1024,
        "dologdir":[]
    }
  • 使用实例:
  • curl -d "token=6c983cf83cbfc1468f0816f287d6f33c&dir_id=35647" "http://openapi.vdisk.me/?m=dir&a=delete_dir"
  • 错误编码:
  • 0: success
    2: dir_id is non-existent
    5: system error
    702: invalid token.
    900: 超出了请求限制
删除文件
  • URL:
  • http://openapi.vdisk.me/?m=file&a=delete_file
  • 请求方式: POST
  • 返回格式: JSON
  • 请求参数:
  • token: 动态令牌
    fid: 文件id
    dologid: 参考dolog机制
  • 返回结果:
  • {
        "err_code":0,
        "err_msg":"success",
        "dologid":1024,
        "dologdir":[]
    }
  • 使用实例:
  • curl -d "token=6c983cf83cbfc1468f0816f287d6f33c&fid=35647" "http://openapi.vdisk.me/?m=file&a=delete_file"
  • 错误编码:
  • 0: success
    2: file is non-existent
    3: the file is locked
    5: system error
    602: dolog old
    702: invalid token.
    900: 超出了请求限制
复制文件
  • URL:
  • http://openapi.vdisk.me/?m=file&a=copy_file
  • 请求方式: POST
  • 返回格式: JSON
  • 请求参数:
  • token: 动态令牌
    fid: 文件id
    new_name: 副本的名称
    to_dir_id: 目标目录的id, 根目录值为: 0
    dologid: 参考dolog机制
  • 返回结果:
  • {
        "err_code":0,
        "err_msg":"success",
        "data":{
            "uid":"62",
            "ctime":1289287059,
            "ltime":1289287059,
             "size":"734003200",
             "type":"application\/x-rar-compressed",
             "md5":"5cdad57bc23f64e17fd64b45e3bf3308",
             "name":"\u526f\u672c.rar",
             "dir_id":3929,
             "fid":"222352",
             "url":"http:\/\/openapi.vdisk.me\/open_file\/……"
        },
        "dologid":1024,
        "dologdir":[]
    }
  • 使用实例:
  • curl -d "token=6c983cf83cbfc1468f0816f287d6f33c&fid=219379&new_name=副本.rar&to_dir_id=3929" "http://openapi.vdisk.me/?m=file&a=copy_file"
  • 错误编码:
  • 0: success
    1: fid is formatted incorrectly
    2: new_name characters are not allowed: \ / : ? * < > " |
    5: system error
    6: new_name is not unique
    7: 空间不足
    8: fid is non-existent or locked
    601: dir full
    602: dolog old
    702: invalid token.
    900: 超出了请求限制
移动文件
  • URL:
  • http://openapi.vdisk.me/?m=file&a=move_file
  • 请求方式: POST
  • 返回格式: JSON
  • 请求参数:
  • token: 动态令牌
    fid: 文件id
    new_name: 移动后的文件名
    to_dir_id: 目标目录的id, 根目录值为: 0
    dologid: 参考dolog机制
  • 返回结果:
  • {
        "err_code":0,
        "err_msg":"success",
        "data":{
            "name":"\u79fb\u52a8\u540e.rar",
            "dir_id":3929,
            "fid":219379,
            "url":"http:\/\/openapi.vdisk.me\/ope……%A8%E5%90%8E.rar"
         },
        "dologid":1024,
        "dologdir":[]
    }
  • 使用实例:
  • curl -d "token=6c983cf83cbfc1468f0816f287d6f33c&fid=219379&new_name=移动后.rar&to_dir_id=3929" "http://openapi.vdisk.me/?m=file&a=move_file"
  • 错误编码:
  • 0: success
    1: fid is formatted incorrectly
    2: new_name characters are not allowed: \ / : ? * < > " |
    4: to_dir_id is non-existent
    5: system error
    6: new_name is not unique
    7: fid are non-existent or locked
    601: dir full
    602: dolog old
    702: invalid token.
    900: 超出了请求限制
文件重命名
  • URL:
  • http://openapi.vdisk.me/?m=file&a=rename_file
  • 请求方式: POST
  • 返回格式: JSON
  • 请求参数:
  • token: 动态令牌
    fid: 文件id
    new_name: 新文件名
    dologid: 参考dolog机制
  • 返回结果:
  • {
         "err_code":0,
        "err_msg":"success",
        "dologid":1024,
        "dologdir":[]
    }
  • 使用实例:
  • curl -d "token=6c983cf83cbfc1468f0816f287d6f33c&fid=219379&new_name=新文件名.rar" "http://openapi.vdisk.me/?m=file&a=rename_file"
  • 错误编码:
  • 0: success
    1: fid is formatted incorrectly
    2: new_name characters are not allowed: \ / : ? * < > " |
    4: fid is non-existent
    5: system error
    6: new_name is not unique
    601: dir full
    602: dolog old
    702: invalid token.
    900: 超出了请求限制
目录重命名
  • URL:
  • http://openapi.vdisk.me/?m=dir&a=rename_dir
  • 请求方式: POST
  • 返回格式: JSON
  • 请求参数:
  • token: 动态令牌
    dir_id: 目录id(不能为0)
    new_name: 新名称
    dologid: 参考dolog机制
  • 返回结果:
  • {
        "err_code":0,
        "err_msg":"success",
        "dologid":1024,
        "dologdir":[]
    }
  • 使用实例:
  • curl -d "token=c7113072a35a742398d6ccdd534bc436&dir_id=3929&new_name=重命名后的目录" "http://openapi.vdisk.me/?m=dir&a=rename_dir"
  • 错误编码:
  • 0: success
    2: dir_id is non-existent
    3: create_name characters are not allowed: \ / : ? * < > " |. Please use valid directory path. 目录名中使用了非法字符，请使用有效的目录路径。
    4: new_name is not unique
    5: system error
    602: dolog old
    702: invalid token.
    900: 超出了请求限制
移动目录
  • URL:
  • http://openapi.vdisk.me/?m=dir&a=move_dir
  • 请求方式: POST
  • 返回格式: JSON
  • 请求参数:
  • token: 动态令牌
    dir_id: 目录id(不能为0)
    new_name: 新名称
    to_parent_id: 目标父目录id, 根目录值为: 0
    dologid: 参考dolog机制
  • 返回结果:
  • {
        "err_code":0,
        "err_msg":"success",
        "data":{
            "name":"\u79fb\u52a8\u540e\u7684\u76ee\u5f55",
            "dir_id":3929,
            "parent_id":0
        },
        "dologid":1024,
        "dologdir":[]
    }
  • 使用实例:
  • curl -d "token=c7113072a35a742398d6ccdd534bc436&dir_id=3929&new_name=移动后的目录&to_parent_id=0" "http://openapi.vdisk.me/?m=dir&a=move_dir"
  • 错误编码:
  • 0: success
    1: cannot move a folder into itself
    3: to_parent_id is non-existent or locked
    4: dir_id are non-existent or locked
    5: system error
    6: dir_id is formatted incorrectly
    7: new_name characters are not allowed: \ / : ? * < > " |
    8: new_name is not unique
    9: 不能当前目录移动到自己的子目录里面
    601: dir full
    602: dolog old
    702: invalid token.
    900: 超出了请求限制
分享文件
  • URL:
  • http://openapi.vdisk.me/?m=file&a=share_file
  • 请求方式: POST
  • 返回格式: JSON
  • 请求参数:
  • token: 动态令牌
    fid: 文件id
    dologid: 参考dolog机制
  • 可选参数：
  • ip: string 终端用户IP地址
  • 返回结果:
  • {
        "err_code":0,
        "err_msg":"success",
        "data":{
            "download_page":"http:\/\/vdisk.me\/?m=share&a=dow……"
        },
        "dologid":1024,
        "dologdir":[]
    }
  • 使用实例:
  • curl -d "token=0c6c8e6dd672e8687441656834231b06&fid=219379" "http://openapi.vdisk.me/?m=file&a=share_file"
  • 错误编码:
  • 0: success
    2: 文件不存在
    105: 文件格式不允许分享，允许的格式：doc，docx，pdf，jpg，png，gif，ppsx，pps，ppt，pptx，xls，txt，avi
    106: 此文件不允许分享
    107: 此文件不允许分享
    108: 此文件不允许分享
    701: 参数不全
    702: invalid token
    900: 超出了请求限制
取消分享
  • URL:
  • http://openapi.vdisk.me/?m=file&a=cancel_share_file
  • 请求方式: POST
  • 返回格式: JSON
  • 请求参数:
  • token: 动态令牌
    fid: 文件id
    dologid: 参考dolog机制
  • 返回结果:
  • {
        "err_code":0,
         "err_msg":"success",
        "dologid":1024,
        "dologdir":[]
    }
  • 使用实例:
  • curl -d "token=0c6c8e6dd672e8687441656834231b06&fid=219379" "http://openapi.vdisk.me/?m=file&a=cancel_share_file"
  • 错误编码:
  • 0: success
    3: fail
    701: 参数不全
    702: invalid token.
    900: 超出了请求限制
获得回收站列表
  • URL:
  • http://openapi.vdisk.me/?m=recycle&a=get_list
  • 请求方式: POST
  • 返回格式: JSON
  • 请求参数:
  • token: 动态令牌
    page_size: 每页显示条数
    page: 第几页
    dologid: 参考dolog机制
  • 返回结果:
  • {
        "err_code":0,
        "err_msg":"success",
        "data":[
            {
                "id":"36909",
                "name":"\u6587\u4ef6",
                "pid":"3944",
                "ctime":"1289365449",
                "ltime":"1289365449",
                "dtime":"1289365455",
                "file_num":"0",
                "dir_num":"0",
                "type":"0"
            },
            ......
        ],
        "dologid":1024,
        "dologdir":[]
    }
  • 使用实例:
  • curl -d "token=0c6c8e6dd672e8687441656834231b06&page_size=10&page=1" "http://openapi.vdisk.me/?m=recycle&a=get_list"
  • 错误编码:
  • 0: success
    2: empty
    602: dolog old
    701: 参数不全
    702: invalid token.
    900: 超出了请求限制
清空回收站
  • URL:
  • http://openapi.vdisk.me/?m=recycle&a=truncate_recycle
  • 请求方式: POST
  • 返回格式: JSON
  • 请求参数:
  • token: 动态令牌
    dologid: 参考dolog机制
  • 返回结果:
  • {
        "err_code":0,
        "err_msg":"success",
        "dologid":1024,
        "dologdir":[]
    }
  • 使用实例:
  • curl -d "token=0c6c8e6dd672e8687441656834231b06" "http://openapi.vdisk.me/?m=recycle&a=truncate_recycle"
  • 错误编码:
  • 0: success
    702: invalid token.
    900: 超出了请求限制
从回收站中彻底删除一个文件
  • URL:
  • http://openapi.vdisk.me/?m=recycle&a=delete_file
  • 请求方式: POST
  • 返回格式: JSON
  • 请求参数:
  • token: 动态令牌
    fid: 要删除的文件id
    dologid: 参考dolog机制
  • 返回结果:
  • {
        "err_code":0,
        "err_msg":"success",
        "dologid":1024,
        "dologdir":[]
    }
  • 使用实例:
  • curl -d "token=0c6c8e6dd672e8687441656834231b06&fid=12345" "http://openapi.vdisk.me/?m=recycle&a=delete_file"
  • 错误编码:
  • 0: success
    2: file is non-existent
    3: the file is locked
    5: system error
    602: dolog old
    702: invalid token.
    900: 超出了请求限制
从回收站中彻底删除一个目录
  • URL:
  • http://openapi.vdisk.me/?m=recycle&a=delete_dir
  • 请求方式: POST
  • 返回格式: JSON
  • 请求参数:
  • token: 动态令牌
    dir_id: 要删除的目录id
    dologid: 参考dolog机制
  • 返回结果:
  • {
        "err_code":0,
        "err_msg":"success",
        "dologid":1024,
        "dologdir":[]
    }
  • 使用实例:
  • curl -d "token=0c6c8e6dd672e8687441656834231b06&dir_id=12345" "http://openapi.vdisk.me/?m=recycle&a=delete_dir"
  • 错误编码:
  • 0: success
    2: dir_id is non-existent
    5: system error
    702: invalid token.
    900: 超出了请求限制
从回收站中还原一个文件
  • URL:
  • http://openapi.vdisk.me/?m=recycle&a=restore_file
  • 请求方式: POST
  • 返回格式: JSON
  • 请求参数:
  • token: 动态令牌
    fid: 要还原的文件id
    dologid: 参考dolog机制
  • 返回结果:
  • {
        "err_code":0,
        "err_msg":"success",
        "dologid":1024,
        "dologdir":[]
    }
  • 使用实例:
  • curl -d "token=0c6c8e6dd672e8687441656834231b06&fid=12345" "http://openapi.vdisk.me/?m=recycle&a=restore_file"
  • 错误编码:
  • 0: success
    2: file is non-existent
    3: 所在目录已经删除, 不能还原.
    4: 原位置有同名文件, 不能还原, 请改名或者删除.
    601: dir full
    702: invalid token.
    900: 超出了请求限制
从回收站中还原一个目录
  • URL:
  • http://openapi.vdisk.me/?m=recycle&a=restore_dir
  • 请求方式: POST
  • 返回格式: JSON
  • 请求参数:
  • token: 动态令牌
    dir_id: 要还原的目录id
    dologid: 参考dolog机制
  • 返回结果:
  • {
        "err_code":0,
        "err_msg":"success",
        "dologid":1024,
        "dologdir":[]
    }
  • 使用实例:
  • curl -d "token=0c6c8e6dd672e8687441656834231b06&dir_id=12345" "http://openapi.vdisk.me/?m=recycle&a=restore_dir"
  • 错误编码:
  • 0: success
    2: dir_id is non-existent
    3: 原位置有同名目录, 不能还原, 请改名或者删除.
    4: 所在目录已经删除, 不能还原.
    5: system error
    601: dir full
    602: dolog old
    702: invalid token.
    900: 超出了请求限制
通过路径得到目录id
  • URL:
  • http://openapi.vdisk.me/?m=dir&a=get_dirid_with_path
  • 请求方式: GET
  • 返回格式: JSON
  • 请求参数:
  • token: 动态令牌
    path: 路径, 格式"/path"
    dologid: 参考dolog机制
  • 返回结果:
  • {
        "err_code":0,
        "err_msg":"success",
        data:{
            "id":12345
        },
        "dologid":1024,
        "dologdir":[]
    }
  • 使用实例:
  • curl -d "token=c513cd031615252f5eb20a773834f26c&path=/我的图片们/name" "http://openapi.vdisk.me/?m=dir&a=get_dirid_with_path"
  • 错误编码:
  • 0: success
    2: The Path Non-standard
    3: no have
    702: invalid token.
    900: 超出了请求限制
dologid机制
  • 请求方式: POST、GET方式请求接口
  • 返回格式: JSON，返回结果有2项数据dologid和dologdir
  • 请求参数:
  • dologid: 本地最新dologid（可以缺省），如果携带的dologid在服务器上不是最新的，所有写操作将会被拒绝。并返回最新dologid和需要更新的dirid
  • 返回结果:
  • {
        "dologid":1024,
        "dologdir":[1112233,112244,112255]
    }
    除登录接口（get_token），其他方法的返回结果都将带有这两个数据，如果请求时dologid缺省dologdir将为空，如果dologid不是最新并且dologdir为空表示需要更新本地所有的目录。
  • 使用实例:
  • curl -d "token=c513cd031615252f5eb20a773834f26c" "http://openapi.vdisk.me/?a=keep"
  • 错误编码:
  • 0: success
    602: dolog old