微盘平台升级

为什么要迁移到新版接口

全新的新版（V2）接口较旧版（V1）相比，更安全，更易用，更高效，还提供了比V1接口更多的功能。

新版接口较旧版接口的优势

1. 更安全

   • 使用业界通用的 Oauth 2 验证。用户名和密码不经过客户端。
   • 基于新浪通行证平台，使用灵活性强。新浪用户即可，坐拥广泛的用户群。
   • 各应用可以沙箱方式隔离空间，可保证不同应用的数据互相独立。

2. 更易用

   • 统一参数、返回值字段。响应头按逻辑区分HTTP响应码，错误码全局统一。详见 V2错误码说明 。
   • REST 风格，兼容 Dropbox。
   • 以全新的同步日志机制实现同步逻辑。
   • 接口URI 基于路径，比旧版基于 ID 的调用逻辑更简便。

3. 更高效

   • 简化上传流程，直接上传，流程简单，响应更快。
   • 写接口的返回值直接是文件目录元信息，无需额外调用读接口。
   • 文件操作的读写接口返回结果的字段全部统一，客户端解析更方便。

4. 更多功能

   • 建立了开发者的应用管理后台。
   • 增加了PUT方式上传文件、目录复制、个人文件搜索等功能。
   • 文件上传体积上限提升到500MB。

V1禁止调用时间

2012年12月30日，禁止所有应用调用V1接口。

接口迁移指南

迁移时需要完成的工作

1. 授权方式的迁移，启用新的 OAuth2.0 授权。
   • OAuth2.0 授权机制说明，请参见 文档。
2. 新旧接口的迁移，接口调用地址、调用方式、参数、返回值、错误信息处理的代码改造。
   • 以下是V2版接口与V1版接口的对应列表，部分旧版接口由于性能或机制升级等原因已不再提供。 如果现有接口未能满足您的需求，欢迎反馈，我们将根据开发者需求及用户利益权衡适度开放新接口。

   • 旧版V1接口	对应V2新版接口	接口名称和功能
     /?m=auth&a=get_token /?a=keep	/oauth2/authorize /oauth2/access_token	获得token。V2 接口不再需要保持 token。
     /?m=file&a=upload_file /?m=file&a=upload_with_sha1	/files_put /files(POST)	文件上传。
     /?m=dir&a=create_dir	/fileops/create_folder	创建目录
     /?m=dir&a=getlist /?m=file&a=get_file_info	/metadata	获取文件和目录信息
     /?m=file&a=get_quota	/account/info	获取用户信息
     /?m=dir&a=delete_dir /?m=file&a=delete_file	/fileops/delete	删除一个对象
     /?m=file&a=copy_file	/fileops/copy	复制一个对象
     /?m=file&a=move_file /?m=dir&a=move_dir /?m=file&a=rename_file /?m=dir&a=rename_dir	/fileops/move	移动一个对象
     /?m=file&a=share_file /?m=file&a=cancel_share_file	/shares	分享或取消分享文件