Skip to content

Latest commit

 

History

History
118 lines (87 loc) · 3.04 KB

README.rst

File metadata and controls

118 lines (87 loc) · 3.04 KB

VDiskSDK Introduction

About VDiskSDK

新浪微盘的API Python版封装。 具体接口可参见官方文档:http://www.vdisk.me/api/doc 支持所有接口调用

How to use

1、导入模块 from vdisksdk VDiskAPIClient

2、创建对象 client = VDiskAPIClient('username', 'passwd', 'appkey', 'app_secret')

3、获取token client.post.auth__get_token()

4、调用接口 print client.post.dir__get_dirid_with_path(path = '/') print client.post.dir__getlist(dir_id = 0)

For example

说明: 接口的函数方法是同官方文档的url相对应的,例如:

1.获得列表

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机制

这个函数调用请使用client.post.dir__getlist(dir_id = 0) 对应关系: http://openapi.vdisk.me/?m= (dir)&a=(getlist) --> dir__getlist

如上,如果请求方式为GET,则为client.get.XXX 如果为POST,则为client.post.XXX 函数命名对应url接口,中间用'__'间隔。

2.通过路径得到目录id

URL: http://openapi.vdisk.me/?m=dir&a=get_dirid_with_path 请求方式: GET 返回格式: JSON 请求参数: token: 动态令牌 path: 路径, 格式"/path" dologid: 参考dolog机制

调用方法: client.post.dir__get_dirid_with_path(path = '/')

3.上传文件

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

调用方法: client.upload.file__upload_file(dir_id = 0, file = 'xxx', cover= 'yes')

Problem

虽然某些接口说可以支持GET方式,但调用失败,强烈建议都用POST调用 token会隔15分钟失效,SDK没有保持连接,你必须自己做这个工作 总体来说,这个SDK仅仅做了一个API Wrapper。!!未经过测试!!

License

VDiskSDK is released under BSD license.

Thanks

参考了新浪微博的python sdk实现: http://michaelliao.github.com/sinaweibopy/ 非常感谢作者。

Update

update 更正了 上传文档部分的问题 并增加了 upload 方式调用 其它与上面一致

Authors

1.xiyoulaoyuanjia@gmail.com 2.memoryboxes@gmail.com