vk-api-glory v1.1.0

vk-api-glory – простая библиотека с минимальным списком зависимостей для работы с API VK ☄. Возможность использования с промисами или асинхронными функциями ES6 🤟.

Зависимости

Node.js >= 8.0.0.

Установка

npm install --save vk-api-glory

В библиотеке присутствует несколько несвязанных классов для работы с VK.

Class: Auth

Класс для авторизации и получения токена пользователя.

Constructor: new Auth(options)

• options <object> Структура

new Auth(options);

Auth options

Опции авторизации

Auth.implicit()

• promise <object> Описание

Явная авторизация для Standelone приложений. Dyrty way авторизация т.к. имитируется авторизация через браузер. Этот тип авторизации используется для недоверенных приложений(приложений которые не прошли проверку командой вк).

obj

Auth.direct()

• promise <object> Описание

Прямая авторизация, через API, для одобренных или официальных приложений.

Пример использования

import { Auth } from 'vk-api-glory'

let auth = new Auth({
    username: 'phone',
    password: 'pass',
    clientId: 'client_id',
    clientSecret: 'client_secret'
});

(async _ => {
  let { accessToken } = await auth.implicit();
})();

Class: Api

Constructor: new Api(options)

• options <object> Описание

new Api(options);

Api options

Api.call(methodName, params)

• methodName <string> Список методов
• params <object> Параметры для соответствующего метода API. Есть возможность переопределить параметры заданные в инстанции объекта
• promise Данные вызываемого метода

Api.setAccessToken(accessToken)

• accessToken <string>

Api.setApiVersion(apiVersion)

• apiVersion <string|number>

Api.setCaptchaHandler(handler)

• handler <function>

Функции обработки капчи. В установленную функцию передается ссылка на изображение капчи и ожидается Promise.resolve с кодом капчи. Пример:

function handler(imageSrc) {
  return new Promise(resolve => {
    let key = getCaptchaKeyByImage(imageSrc);
    return resolve(key);
  })
}

Пример использования Api

import { Api } from 'vk-api-glory'

const accessToken = 'token';

function captchaHandler(imgSrc) {
  return new Promise(async resolve => {
    let key = await getCaptchaKeyByImage(imgSrc);
    return resolve(key);
  })
}

let vkApi = new Api({ accessToken, captchaHandler });

vkApi.call('users.get')
  .then(data => console.log(data))
  .catch(error => console.log(error));

Todo

• Переписать промисы на асинхронные функции;
• Добавить middleware;
• Добавить очереди с возможностью запуска параллельных потоков;
• Добавить тесты.