Skip to main content

vk.com (aka vkontakte.ru) API wrapper

Project description

https://travis-ci.org/kmike/vkontakte.png?branch=master https://coveralls.io/repos/kmike/vkontakte/badge.png?branch=master

This is a vk.com (aka vkontakte.ru, largest Russian social network) python API wrapper. The goal is to support all API methods (current and future) that can be accessed from server.

Installation

$ pip install vkontakte

Usage

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

All API methods that can be called from server should be supported.

See http://bit.ly/9Nzc8h for detailed API help.

OAuth2 access_token is supported (docs are here http://vkontakte.ru/developers.php?oid=-1&p=Авторизация)

Changes

dev (TBA)

  • bugfix for breaking vkontakte API updates.

simplejson is now required under python 2.6 (it was previously required only under python 2.5).

1.3.2 (2012-05-19)

  • more COMPLEX_METHODS are suported.

1.3.1 (2012-04-09)

  • don’t raise an exception on json with control characters from vkontakte;

  • properly encode request parameters after dumping them to json format.

1.3 (2012-03-27)

  • dict, list and tuple arguments are now properly serialized;

  • more info is preserved in VKError.

1.2.1 (2012-02-15)

  • properly encode unicode for API calls;

  • tox test running.

1.2 (2012-01-20)

  • ‘get’ API calls are fixed;

  • tests are added.

1.1.0 (2012-01-11)

  • more magic methods are supported;

  • proper timestamp calculation.

1.0.0 (2011-12-29)

  • OAuth2 support;

  • api.ads support;

0.9.5 (2010-10-30)

  • syntax sugar for ‘secure’ methods;

  • make vkontakte.signature public;

  • unicode param names are fixed;

0.9.3 (2010-09-02)

  • timeout support

0.9.1 (2010-08-25)

Initial release.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

vkontakte-1.3.4.tar.gz (10.6 kB view details)

Uploaded Source

File details

Details for the file vkontakte-1.3.4.tar.gz.

File metadata

  • Download URL: vkontakte-1.3.4.tar.gz
  • Upload date:
  • Size: 10.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for vkontakte-1.3.4.tar.gz
Algorithm Hash digest
SHA256 ed159615c1bdc44713c76ada8db9e4f19a8e0d2d30579d6944b802615a6531be
MD5 ebaa0d7b1d64e35ffefb37c1e2600a8c
BLAKE2b-256 93bfd34a65cd464437cb638fd31830e0339c29ce7b68157faf7df218868b8ce4

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page