Documentation Deviant
DarsoX edited this page Aug 2, 2021
·
45 revisions
Модуль, позволяющий обращаться к Deviant Api который позволяет добавлять в вашего бота ВК новый функционал
- Требуется Doken или Token
- StickersGet - Получение наборов стикеров юзера
- StickersInfoGet - Получение информации о стикере
- StickersFullGet - Получение наборов стикеров юзера 〔 Детально 〕
- SystemInfo - Получение информации о номере телефона, почте и 2FA по токену.
- AppsGet - Получение информации о приложениях пользователя вк
- GroupsGet - Получение информации о группах пользователя вк
- BalaYandex - Балабоба от яндекса
- TranslatorEmj - Переводчик текста в эмоджи
- KeyGenerator- Генератор ключей
- GetChatsLink - Получает ссылку на чат и информацию по нем. 〔 https://vk.com/slikkness 〕
- GetTesterInfo - Получение карточки тестировщика пользователя.
- Ping - Получение скорости отклика сервера Вк и Deviant Api.
- GetWhatAnime - Поиск аниме по скриншоту.
- GetGroupsSubscription - Поиск общих подписок.
- GetStickersGift - Получает подаренные стикеры и пользователей.
-
Bash:
pip install deviant
-
Pythonanywhere:
pip3 install --user deviant
-
Requirements.txt:
deviant == 1.2.0
from deviant import Deviant
dev = Deviant(doken = 'Ваш DOKEN')
dev.apps_get(1)
Doken можно получить тут: https://vk.com/app7440630
from deviant import Deviant
dev = Deviant(token = 'Ваш Token')
dev.apps_get(1)
Token можно получить тут: https://vkhost.github.io/
- Метод: stickers_get(user_id)
- Описание: Получение стикеров пользователя в вк.
- Параметры: user_id - ID пользователя вконтакте.
- Пример:
from deviant import Deviant
dev = Deviant(doken = 'Ваш DOKEN')
deviant_info = dev.stickers_get(1)
print(deviant_info)
- Результат:
--|deviant - Массив с результатом.
----|count - Количество наборов у пользователя.
----|count_max - Всего наборов в вк.
----|stickers - Массив с наборами пользователя.
------|name - Название стикер-пака.
------|price - Стоимость набора
------|id - ID набора.
----|rub - Общая цена наборов в рублях.
----|uah- Общая цена наборов в гривне.
----|cost- Общая цена наборов в голосах.
- Метод: stickers_full_get(user_id,type)
- Описание: Получение стикеров пользователя в вк детальней, чем метод "StickersGet".
- Параметр 1: user_id - ID пользователя вконтакте.
- Параметр 2: type - число от 1 до 11.
- Возвращает все стили и стикеры.
- Возвращает только платные стикеры.
- Возвращает только платные стили.
- Возвращает только бесплатные стикеры.
- Возвращает только бесплатные стили.
- Возвращает ВСЕ (Кроме анимированных 7-10).
- Возвращает все анимированные стикеры и стили.
- Возвращает все анимированные бесплатные стикеры и стили.
- Возвращает все анимированные стили.
- Возвращает только анимированные бесплатные стили.
- Возвращает ВСЕ (Кроме обычных наборов 1-5)
- Пример:
from deviant import Deviant
dev = Deviant(doken = 'Ваш DOKEN')
deviant_info = dev.stickers_full_get(1,1)
print(deviant_info)
- Результат:
--|deviant - Массив с результатом.
----|count - Массив с количествами.
------|count_user_all - Количество Стикеров и Стилей пользователя.
------|count_max - Количество Стикеров и Стилей в ВК.
------|count_style- Количество стилей Пользователя.
------|count_pack - Количество паков Пользователя.
------|count_don_pack - Количество платных паков Пользователя.
------|count_don_style - Количество платных стилей Пользователя.
------|count_animation_all - Количество всех анимированных стилей и стикеров.
------|count_animation_pack - Количество анимированных стикеров.
------|count_don_animation_pack - Количество платных анимированных стикеров.
------|count_animation_style - Количество анимированных стилей.
------|count_don_animation_style - Количество платных анимированных стилей.
----|price - Массив с стоимостью.
------|price_all_rub - Все стикеры и стили в рублях.
------|price_all_vote- Все стикеры и стили в голосах.
------|price_pack_rub - Все стикеры в рублях.
------|price_pack_vote - Все стикеры в голосах.
------|price_style_rub - Все стили в рублях.
------|price_style_vote - Все стили в голосах.
------|price_animation_pack_rub - Все анимированные стикеры в рублях.
------|price_animation_pack_vote - Все анимированные стикеры в голосах вк.
------|price_animation_style_rub - Все анимированные стили в рублях.
------|price_animation_style_vote - Все анимированные стили в голосах вк.
----|sticker = Массив с категориями стикеров.
------|sticker_all - Массив со всеми наборами стикеров и стилями пользователя.
--------|id - ID набора.
--------|name - Название набора.
--------|price - Цена в голосах.
--------|rub - Цена в рублях.
--------|style - является ли набор стилем.
--------|animation - Анимированный набор или нет.
------|sticker_user_don - Массив со всеми платными наборами пользователя.
--------|id - ID набора.
--------|name - Название набора.
--------|price - Цена в голосах.
--------|rub - Цена в рублях.
--------|animation - Анимированный набор или нет.
------|sticker_user_free - Массив со всеми бесплатными наборами пользователя.
--------|id - ID набора.
--------|name - Название набора.
--------|price - Цена в голосах.
--------|rub - Цена в рублях.
--------|animation - Анимированный набор или нет.
------|style_user_don - Массив со всеми платными стилями пользователя.
--------|id - ID набора.
--------|name - Название набора.
--------|price - Цена в голосах.
--------|rub - Цена в рублях.
--------|animation - Анимированный набор или нет.
------|style_user_free - Массив со всеми бесплатными стилями пользователя.
--------|id - ID набора.
--------|name - Название набора.
--------|price - Цена в голосах.
--------|rub - Цена в рублях.
--------|animation - Анимированный набор или нет.
------|pack_user_don_animation - Массив со всеми платными анимированными стикерами пользователя.
--------|id - ID набора.
--------|name - Название набора.
--------|price - Цена в голосах.
--------|rub - Цена в рублях.
--------|animation - Анимированный набор или нет.
------|pack_user_free_animation - Массив со всеми бесплатными анимированными стикерами пользователя.
--------|id - ID набора.
--------|name - Название набора.
--------|price - Цена в голосах.
--------|rub - Цена в рублях.
--------|animation - Анимированный набор или нет.
------|style_user_don_animation - Массив со всеми платными анимированными стилями пользователя.
--------|id - ID набора.
--------|name - Название набора.
--------|price - Цена в голосах.
--------|rub - Цена в рублях.
--------|animation - Анимированный набор или нет.
------|style_user_free_animation - Массив со всеми бесплатными анимированными стилями пользователя.
--------|id - ID набора.
--------|name - Название набора.
--------|price - Цена в голосах.
--------|rub - Цена в рублях.
--------|animation - Анимированный набор или нет.
----|info_status - Массив с информацией коллекционера.
--------|love_author - Любимый автор наборов стикеров.
--------|precent - Процент собранных стикеров.
--------|status - Статус коллекционера стикеров (От Deviant).
- Метод: stickers_info_get(sticker_id)
- Описание: Получает информацию о стикере.
- Параметры: sticker_id - ID стикера вконтакте.
- Пример:
from deviant import Deviant
dev = Deviant(doken = 'Ваш DOKEN')
deviant_info = dev.stickers_get(66)
print(deviant_info)
- Результат:
--|deviant - Массив с результатом.
----|sticker_pack - Массив с информацией о наборе стикера.
------|id - ID набора.
------|name - Название набора.
------|description - Описание набора.
------|author - Автор набора.
------|stikers - Количество стикеров в наборе.
------|value - Массив с информацией о покупке набора.
--------|purchase - Тип покупки.
--------|golos - Цена в голосах.
--------|rub- Цена в рублях.
----|sticker_info - Массив с информацией о стикере.
------|id - ID стикера.
------|tag - Ключевые слова стикера.
- Метод: get_system_info()
- Описание: Получает информации о номере телефона, почте и 2FA по токену пользователя.
- Пример:
from deviant import Deviant
dev = Deviant(doken = 'Ваш DOKEN')
deviant_info = dev.get_system_info()
print(deviant_info)
- Результат:
--|deviant - Массив с результатом.
----|2FA - Включена ли 2FA авторизация.
----|phone - Привязанный номер телефона к странице.
----|email - Привязанный email к странице.
----|ping_vk - Время ответа сервера Вк.
----|ping_deviant - Время ответа сервера Deviant.
- Метод: apps_get(user_id)
- Описание: Получает информацию о приложениях которые создал пользователь в вк.
- Параметры: user_id - ID пользователя вконтакте.
- Пример:
from deviant import Deviant
dev = Deviant(doken = 'Ваш DOKEN')
deviant_info = dev.apps_get(66)
print(deviant_info)
- Результат:
--|deviant - Массив с результатом.
----|count - Количество приложений пользователя.
----|apps - Массив с приложениями.
------|name - Название приложения.
------|users - Количество пользователей приложения.
------|id - ID приложения в вк.
- Метод: groups_get(user_id)
- Описание: Получает информацию о группах которые создал пользователь в вк.
- Параметры: user_id - ID пользователя вконтакте.
- Пример:
from deviant import Deviant
dev = Deviant(doken = 'Ваш DOKEN')
deviant_info = dev.groups_get(1)
print(deviant_info)
- Результат:
--|deviant - Массив с результатом.
----|count - Количество групп пользователя.
----|groups - Массив с приложениями.
------|name - Название группы.
------|member - Количество участников группы.
------|id - ID группы в вк.
------|verified - Верификация группы.
- Метод: balayandex_get(text,style)
- Описание: Функционал Балабоба от яндекса - генерирует текст за заданным предложением.
- Параметр 1: text - Ваше предложение, слово на которое должен запустится генератор.
- Параметр 2: style - Индекс стиля от 0 до 11. (Параметр не обязательный, если не указать будет "Без стиля")
- Без стиля (По стандарту)
- Теория заговора
- ТВ-Репортажи
- Тосты
- Пацанские цитаты
- Рекламные слоганы
- Короткие истории
- Подписи в инсту
- Википедия
- Синопсы Фильмов
- Гороскоп
- Народные мудрости
- Пример:
from deviant import Deviant
dev = Deviant(doken = 'Ваш DOKEN')
deviant_info = dev.balayandex_get('Deviant', 9)
print(deviant_info)
- Результат:
--|deviant - Массив с результатом.
----|text - Сгенерированный текст.
----|key - Текст который вы передали.
- Метод: translator_emj(text,lang)
- Описание: Переводит текст с английского или русского в эмоджи.
- Параметр 1: text - Слово или предложение, которое необходимо перевести.
- Параметр 2: lang - Язык с которого нужно перевести, поддерживает только ru и en
- Пример:
from deviant import Deviant
dev = Deviant(doken = 'Ваш DOKEN')
deviant_info = dev.translator_emj('Привет','ru')
print(deviant_info)
- Результат:
--|deviant - Массив с результатом.
----|text - переведённый текст.
- Метод: generator()
- Описание: Генерирует случайный ключ.
- Пример:
from deviant import Deviant
dev = Deviant(doken = 'Ваш DOKEN')
deviant_info = dev.generator()
print(deviant_info)
- Результат:
--|deviant - Массив с результатом.
----|code- генерируемый текст
- Метод: get_chat_link()
- Автор: https://vk.com/slikkness
- Описание: Получает информацию о случайной беседе и ссылку на вход в нее.
- Пример:
from deviant import Deviant
dev = Deviant(doken = 'Ваш DOKEN')
deviant_info = dev.get_chat_link()
print(deviant_info)
- Результат:
--|deviant - Массив с результатом.
----|name - Название чата.
----|user - Количество участников чата.
----|creator - ID создателя чата.
----|online_admin - Онлайн админ или нет.
----|online_user - Количество частников в онлайне.
----|bots - Массив с ботами в чате.
------|name - Название бота.
------|id - ID бота.
----|link - Ссылка на чат.
- Метод: get_tester()
- Параметр 1: id - user_id пользователя вк.
- Описание: Получает информации о карточке тестировщика и эксперта пользователя.
- Пример:
from deviant import Deviant
dev = Deviant(doken = 'Ваш DOKEN')
deviant_info = dev.get_tester()
print(deviant_info)
- Результат:
--|deviant - Массив с результатом.
----|tester - массив с информацией о тестере
------|status - Статус пользователя в программе.
------|ball - Количество баллов.
------|reports - Количество Репортов.
------|top - Место в рейтинге.
----|expert - массив с информацией о эксперте
------|expert - Является ли пользователь Экспертом
------|topic - тема эксперта.
------|position - позиция в рейтинге.
------|actions - количество действий.
- Метод: get_ping()
- Описание: Получает информации о пинге.
- Пример:
from deviant import Deviant
dev = Deviant(doken = 'Ваш DOKEN')
deviant_info = dev.get_ping()
print(deviant_info)
- Результат:
--|deviant - Массив с результатом.
----|ping_vk - Время ответа сервера Вк.
----|ping_deviant - Время ответа сервера Deviant.
- Метод: get_what_anime(img)
- Описание: Ищет аниме по скриншоту из аниме.
- Параметр: img - ссылка изображения с окончанием на ".png" и ".jpg".
- Пример:
#На данный момент, данного метода нет в модуле. (Поэтому используем Requests)
import requests
img = "https://pm1.narvii.com/6505/fa89d828ec6e623031aea6a4f0ca34720bcd8fa2_hq.jpg" #Тут вставьте свою ссылку на скриншот.
info = requests.post("https://deviantapi.pythonanywhere.com/api/GetWhatAnime?img={}".format(img)).json()
print(info)
- Результат:
--|deviant - Массив с результатом.
----|title - Массив с названиями аниме.
------|orig_name - Оригинальное название.
------|romaji_name - Романдзи название.
------|english_name - Название на английськом.
----|synonyms - Список синонимных названий.
----|accuracy - Точность поиска.
----|hentai - Присутсвует ли хентай.
----|episode - Эпизод в аниме.
----|rating - Рейтинг.
- Метод: get_groups_sub(id,user_id)
- Описание: Проверяет общие подписки пользователе1
- Параметр 1: id - id пользователя кого ищем в подписках групп user_id.
- Параметр 2: user_id - id пользователя чьи группы проверяем.
- Пример:
#На данный момент, данного метода нет в модуле. (Поэтому используем Requests)
import requests
doken = "ВАШ_ТОКЕН_ИЛИ_DOKEN"
id = 1
user_id = 2
requests.post("https://deviantapi.pythonanywhere.com/api/GetGroupsSubscription?id={}&user_id={}&doken={}".format(id, user_id,doken)).json()
print(info)
- Результат:
--|deviant - Массив с результатом.
----|verified - Сколько групп проверено.
----|count - Количество общих групп. (В след, обновление)
----|groups - массив групп, в которых есть общие подписки.
------|key - ключ id группы, массив.
--------|name - название группы.
--------|screen_name - короткая ссылка группы.
- Метод: get_gift_stickers(id,count)
- Описание: Получает пользователей, которые подарили пользователю стикеры.
- Параметр 1: id - id пользователя вк, подарки которого проверяем.
- Параметр 2: count - Количество подарков, которое проверяем. (По дефолту 100)
- Пример:
#На данный момент, данного метода нет в модуле. (Поэтому используем Requests)
import requests
doken = "ВАШ_ТОКЕН_ИЛИ_DOKEN"
id = 214615503
count = 50
requests.post("https://deviantapi.pythonanywhere.com/api/GetStickersGift?id={}&count={}&doken={}".format(id,count,doken)).json()
print(info)
- Результат:
--|deviant - Массив с результатом.
----|count - Массив с количеством подаренных стикеров.
------|gift - Количество подаренных стикеров.
------|pack - Обычных наборов.
------|style - Наборы стили.
------|animation - Анимированные наборы.
------|random_all - Общее количество наборов на выбор.
------|random_animation - Количество анимированных наборов на выбор.
------|random_pack - Количество обычных наборов на выбор.
----|price- Массив с ценнами.
------|gift - Массив с общими ценами, всех подаренных стикеров.
--------|vote - Цена в голосах.
--------|rub - Цена в рублях.
------|pack - Массив с ценами, всех подаренных обычных наборов.
--------|vote - Цена в голосах.
--------|rub - Цена в рублях.
------|style - Массив с ценами, всех подаренных стилей.
--------|vote - Цена в голосах.
--------|rub - Цена в рублях.
------|animation - Массив с ценами, всех подаренных анимированных наборов.
--------|vote - Цена в голосах.
--------|rub - Цена в рублях.
------|random - Массив с ценами, всех подаренных наборов на выбор.
--------|vote - Цена в голосах.
--------|rub - Цена в рублях.
------|random_animation - Массив с ценами, всех подаренных анимированных наборов на выбор.
--------|vote - Цена в голосах.
--------|rub - Цена в рублях.
------|random_pack - Массив с ценами, всех подаренных наборов на выбор.
--------|vote - Цена в голосах.
--------|rub - Цена в рублях.
----|user - Массив с пользователями которые дарили подарки.
------|key - user_id пользователя вк.
--------|count - Массив с количеством подаренных наборов от пользователя.
----------|gift - Общее количество.
----------|pack - Количество обычных наборов
----------|style - Количество стилей.
----------|anim - Количество анимированных.
----------|random - Общее количество наборов на выбор.
----------|random_anim - Количество анимированных на выбор наборов.
----------|random_pack - Количество обычных наборов на выбор.
--------|price - Массив с ценами.
----------|gift_vote - Общая цена в голосах.
----------|gift_rub - Общая цена в рублях.
----------|pack_vote - Цена обычных наборов в голосах.
----------|pack_rub - Цена обычных наборов в рублях.
----------|style_vote - Цена стилей в голосах.
----------|style_rub - Цена стилей в рублях.
----------|anim_vote - Цена анимированных наборов в голосах.
----------|anim_rub - Цена анимированных наборов в рублях.
----------|random_all - Общая цена наборов на выбор в голосах.
----------|random_anim - Цена анимированных наборов на выбор в голосах.
----------|random_pack - Цена обычных наборов на выбор в голосах.