vk.com(vkontakte.ru)API包装器
vkontakte2的Python项目详细描述
这是一个vk.com(又名vkontakte.ru,俄罗斯最大的社交网络) python api包装器。目标是支持所有api方法(当前和未来) 可以从服务器访问的。
安装
$ pip install vkontakte2
用法
>>> import vkontakte >>> vk = vkontakte.API('my_api_id', 'my_api_secret') >>> print vk.getServerTime() 1282689362 >>> vk = vkontakte.API(token='my_access_token') >>> print vk.getServerTime() 1282689362 >>> profiles = vk.getProfiles(uids='1,2', fields='education') >>> pavel = profiles[0] >>> print pavel['last_name'], pavel['university_name'] Дуров СПбГУ >>> # alternative syntax >>> profiles = vk.get('getProfiles', uids='1,2', fields='education') >>> pavel = profiles[0] >>> print pavel['last_name'], pavel['university_name'] Дуров СПбГУ >>> # custom timeout example (default timeout = 1s) >>> vk = vkontakte.API('my_api_id', 'my_api_secret', timeout=5) >>> print vk.getServerTime() 1282689362 >>> # syntax sugar for 'secure.*' methods >>> print vk.secure.getSMSHistory() None
应该支持所有可以从服务器调用的api方法。
有关详细的api帮助,请参见http://bit.ly/9Nzc8h。
支持OAuth2访问令牌(文档在这里)
更改
开发(待定)
- 中断vkontakte api更新的错误修复。
simplejson现在在python 2.6下是必需的(它以前是 仅在Python2.5下需要)。
1.3.2(2012-05-19)
- 支持更复杂的方法。
1.3.1(2012-04-09)
- 不要对带有vkontakte中的控制字符的json引发异常;
- 将请求参数转储为json格式后,对其进行正确编码。
1.3(2012-03-27)
- dict、list和tuple参数现在已正确序列化;
- 更多信息保存在vkerror中。
1.2.1(2012-02-15)
- 为API调用正确编码Unicode;
- 毒物测试正在进行。
1.2(2012-01-20)
- “get”api调用是固定的;
- 添加测试。
1.1.0(2012-01-11)
- 支持更多魔术方法;
- 正确的时间戳计算。
1.0.0(2011-12-29)
- OAuth2支持;
- api.ads支持;
0.9.5(2010-10-30)
- “secure”方法的语法糖;
- 公开vkontakte.signature;
- Unicode参数名是固定的;
0.9.3(2010-09-02)
- 超时支持
0.9.1(2010-08-25)
初次发布。