{"id":15134196,"url":"https://github.com/bryzgaloff/vk","last_synced_at":"2025-10-23T09:31:25.152Z","repository":{"id":116077148,"uuid":"104897715","full_name":"bryzgaloff/vk","owner":"bryzgaloff","description":"Python VK API light wrapper","archived":false,"fork":false,"pushed_at":"2024-04-10T17:13:39.000Z","size":11,"stargazers_count":3,"open_issues_count":0,"forks_count":3,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-01-30T17:38:30.309Z","etag":null,"topics":["python","python2","python3","vk","vk-api","vkapi","vkontakte","vkontakte-api"],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/bryzgaloff.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2017-09-26T14:46:28.000Z","updated_at":"2024-04-10T17:13:44.000Z","dependencies_parsed_at":"2024-04-10T18:52:30.778Z","dependency_job_id":null,"html_url":"https://github.com/bryzgaloff/vk","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bryzgaloff%2Fvk","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bryzgaloff%2Fvk/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bryzgaloff%2Fvk/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bryzgaloff%2Fvk/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bryzgaloff","download_url":"https://codeload.github.com/bryzgaloff/vk/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":237807483,"owners_count":19369597,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["python","python2","python3","vk","vk-api","vkapi","vkontakte","vkontakte-api"],"created_at":"2024-09-26T05:03:39.398Z","updated_at":"2025-10-23T09:31:24.819Z","avatar_url":"https://github.com/bryzgaloff.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"Простая обертка для [API ВКонтакте](https://vk.com/dev/manuals) (далее — Обертка) для Python 2\u00263, основано на [dimka665/vk](https://github.com/dimka665/vk).\n\n# Требования\n* [requests](https://pypi.org/project/requests/)\n\n# Пример использования\n```bash\n$ git clone https://github.com/bryzgaloff/vk.git\n\n$ pip install requests\n\n$ python\n```\n```python\n\u003e\u003e\u003e from vk import API\n\n# если у вас есть access token:\n\u003e\u003e\u003e access_token = '\u003cyour access token\u003e'\n\u003e\u003e\u003e api = API(access_token)\n\n# если у вас нет access token'а, но есть APP ID\n\u003e\u003e\u003e api = API(\n...     email='your.email@domain.org',\n...     password='your_password',\n...     app_id='your_app_id',\n... )\n\n# если нет ни того, ни другого, смотрите раздел FAQ\n\n\u003e\u003e\u003e api.users.get(user_ids=1)\n[{'id': 1, 'first_name': 'Павел', 'last_name': 'Дуров'}]\n```\n\n# FAQ\n## Можно ли использовать API без токена?\nНет, нельзя, [начиная с апреля 2017 года](https://vk.com/dev/service_token?f=2.%20%D0%A7%D1%82%D0%BE%20%D0%B8%D0%B7%D0%BC%D0%B5%D0%BD%D0%B8%D1%82%D1%81%D1%8F).\n\n## Как получить токен или APP ID?\n1. [Авторизуйтесь](https://vk.com/login) ВКонтакте.\n2. [Создайте новое приложение](https://vk.com/editapp?act=create).\n    1. Введите желаемое название.\n    2. Выберите опцию «Standalone-приложение»\n    3. Нажмите «Подключить приложение».\n    4. Введите код, полученный в СМС-сообщении.\n3. В новом созданном приложении откройте пункт «Настройки» в меню слева.\n\nAPP ID — семизначное число, записанное в поле «ID приложения».\n\nВ качестве токена вы можете использовать сервисный ключ доступа, однако в таком случае доступ у API будет такой же, как у неавторизованного пользователя. Чтобы доступ у API соответствовал доступу авторизованного пользователя, необходимо получить соответствующий токен — и Обертка получит его самостоятельно, если вы укажите в качестве аргументов конструктора `API` e-mail (`email`), пароль (`password`) и APP ID (`app_id`).\n\nМожно одновременно указать `access_token` и аргументы для авторизации — в таком случае `access_token` будет перезапрошен Оберткой при первом неуспешном вызове метода API. Максимальное число перезапросов токенов регулируется аргументом `max_token_requests`.\n\n## Существуют ли у Обертки какие-то ограничения?\n1. В приложении можно использовать инстанс API только для одного APP ID / access token'а (т.к. класс `API` является [Singleton](https://tproger.ru/translations/design-patterns-simple-words-1/#16)'ом).\n2. Существуют также [частотные и количественные ограничения](https://vk.com/dev/api_requests?f=3.%20%D0%9E%D0%B3%D1%80%D0%B0%D0%BD%D0%B8%D1%87%D0%B5%D0%BD%D0%B8%D1%8F%20%D0%B8%20%D1%80%D0%B5%D0%BA%D0%BE%D0%BC%D0%B5%D0%BD%D0%B4%D0%B0%D1%86%D0%B8%D0%B8) самого API ВКонтакте. Частотные ограничения Обертка контролирует сама — ограничение на максимальное число запросов в секунду контролируется аргументом `max_token_requests` конструктора `API`.\n3. Не поддерживаются аккаунты с 2-факторной авторизацией (см. [«Подтверждение входа»](https://vk.com/settings?act=security)).\n\n## Какая версия API используется?\nПо умолчанию — 5.68. Вы можете указать версию самостоятельно через аргумент `v` конструктора `API`.\n\n# Документация\n\nПараметры конструктора `API`:\n\n| Имя | Назначение | Значение по умолчанию |\n| --- | --- | --- |\n| access_token | access token | `None` |\n| email | E-mail пользователя для авторизации | `None` |\n| password | Пароль пользователя для авторизации | `None` |\n| app_id | APP ID | `None` |\n| scope | Битовая маска [настроек доступа приложения](https://vk.com/dev/permissions) | `'offline'` |\n| timeout | Таймаут для запросов в секудах | `30` |\n| max_requests_per_seconds | Максимально допустимое число запросов в секунду | `3` |\n| max_token_requests | Максимальное число попыток для перезапроса токена | `2` |\n| **method_default_args | kwargs для запросов к API по умолчанию | |\n\nДальнейшее взаимодействие с `API` сводится к формированию запросов к API согласно [документации](https://vk.com/dev/methods).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbryzgaloff%2Fvk","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbryzgaloff%2Fvk","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbryzgaloff%2Fvk/lists"}