vk-api Python Wrapper

Warnings

• gotcha Direct authentication with phone number and password (`vk_api.VkApi(login, password).auth()`) is prone to frequent issues due to VK's evolving security measures, including 2FA, CAPTCHAs, and non-Latin password handling. It's often unstable across minor versions.
  Fix: Keep `vk-api` updated to the latest version. For more robust and secure applications, consider using VK access tokens obtained via OAuth flows rather than direct password authentication, especially for bots or long-running scripts. Implement `captcha_handler` and `auth_handler` for interactive authentication challenges.
• breaking Dependencies `six` and `enum34` were removed. If your project implicitly relied on `vk-api` to pull these in, you might encounter `ModuleNotFoundError` if they are not otherwise present in your environment.
  Fix: Ensure `six` and `enum34` are explicitly installed in your environment if your code directly depends on them, or remove any implicit dependencies. `vk-api` itself no longer requires them.
• gotcha Using phone number and password directly in your code (especially in production environments or public repositories) is a security risk. It exposes sensitive user credentials.
  Fix: Always store credentials securely using environment variables, configuration files, or a secrets management system. For long-term access, prefer using user or community access tokens obtained through OAuth, which can have specific scopes and be revoked if compromised.
• gotcha There is another Python library for VK API interaction named 'vk' (lowercase). Using `import vk` will import that library, which has a different API and documentation, leading to confusion and `AttributeError`s if you expect `vk-api`'s functionality.
  Fix: Always use `import vk_api` and refer to the official documentation for the `vk-api` library (by `python273`). Double-check your `pip install` command to ensure you're installing `vk_api` and not `vk`.

Install

• pip install vk_api Install vk-api

Imports

• VkApi

  from vk_api import VkApi

• VkLongPoll

  from vk_api.longpoll import VkLongPoll

• VkEventType

  from vk_api.longpoll import VkEventType

• vk_api

  import vk_api

  A different, less popular library named 'vk' exists with a different API surface and import pattern. The correct import for this library is 'vk_api'.

Quickstart

This quickstart demonstrates how to authenticate with VK using phone number and password, then make a simple API call to post a message to the user's wall. It uses environment variables for credentials, which is a recommended practice for security. For production, consider using access tokens instead of direct password authentication.

import os
import vk_api

login = os.environ.get('VK_LOGIN', '+71234567890') # Use environment variables for sensitive data
password = os.environ.get('VK_PASSWORD', 'your_password')

try:
    vk_session = vk_api.VkApi(login, password)
    vk_session.auth() # Authenticate with VK
    
    vk = vk_session.get_api() # Get the API object
    
    # Example: Post a message to the wall
    # In a real application, ensure the user_id is correct and permissions are granted.
    response = vk.wall.post(message='Hello from vk-api!')
    print(f"Post successful! Post ID: {response['post_id']}")

except vk_api.AuthError as error_msg:
    print(f"Authentication failed: {error_msg}")
except Exception as e:
    print(f"An error occurred: {e}")