VK-Promise

VK-Promise

Модуль для работы с ВКонтакте API и Callback API ВКонтакте.

Установка

npm install VK-Promise

Tl;dr

// запрос
vk(/*string*/ метод, /*object*/ данные)
    .then(/*function*/ on_response)
    .catch(/*function*/ on_error);
// Загрузка файла
vk.upload(
    /*string*/ метод_получения_сервера,
    /*string*/ метод_сохранения_файла,
    {
        get: {/* данные передаваемые методу получения сервера*/},
        save: {/* данные передаваемые методу сохранения файла*/},
        files: {/* файлы */
            file1: /*string*/ путь_к_файлу,
            file2: stream /* необходимо указать stream.filename */,
            file3: {filename: имя_файла, buffer: Buffer},
        }
    }
);
// Функции
vk.init_longpoll(); // Запуск получения сообщения через LongPoll
vk.init_execute_cart(); // Запуск пакетной обработки запросов через execute
vk.init_callback_api(); // Получения обработчика для http.createServer
// Разное
VK.getAttachmentUrl(/*object*/ attachment); // Получения url из msg.attachments
VK.Array2Object(/*Array*/ array); // [{key:key,value:value}] => {key:value}

Элементарный запрос

var vk = require("VK-Promise")("Ваш access_token");

vk.users.get({
    user_id: 1 // данные передаваемые API
}).then(function (res) {
    console.log("response",res);
}).catch(function (error) {
    console.log("Ошибка",error);
});

Обработка need_captcha

var vk = require("VK-Promise")("Ваш access_token");
// Добавляем обработчик
vk.on("captcha",function(event, data){
	console.log("Ссылка на код:", data.captcha_img);
    data.submit("Вводим код с картинки");
});
// API метод вызова captcha
vk("captcha.force",{}).then(function () {
     console.log("response",res);
})

Элементарный бот

var VK = require("VK-Promise"),
    vk = new VK("ваш access_token");

vk.init_longpoll(); // Запускаем получение сообщений через LongPoll

vk.on("message",function (event, msg) { // Обрабатываем сообщения
    if(msg.body == "ping") // Если текст сообщения равен ping
        msg.send("pong"); // Отвечаем pong
});

Элементарный бот для группы через Callback API с оптимизацией ответа на сообщения через execute

var VK = require("VK-Promise"),
    http = require("http"),
    vk = VK("ваш access_token группы");

// Запускаем http сервер на 80 порту с обработкой Callback API
// PS: Сервер в настройках группы нужно вешать вручную  
var callback = vk.init_callback_api("Строка, которую должен вернуть сервер");
http.createServer(function (req, res) {
    if(req.url == "/vk_callback_api") // фильтруем по url
        return callback(req, res);
    // Далее делаем все что нам нужно
    res.end("Error 404");
}).listen(80);

// Включаем оптимизацию через execute
// Собирает все запросы и выполняет пачками раз в 334мс
// 334мс - 3 раза в секунду, стандартное ограничение  
vk.init_execute_cart();

// message_new & message_reply объединяет в message
vk.on("message",function (event, msg) {
    msg.send("OK");
    event.ok(); // Отвечаем callback api серверу OK
});

// все остальное идет в callback type
// Например если участник вышел из сообщества
vk.on("group_leave",function (event, data) {
    if(data.self) // если сам вышел
        vk.messages.send({ // Отправляем сообщени
            message:"Ну куда же ты :_(", // текст сообщения
            peer_id: data.object.user_id // Кому
        });
    event.ok();
});

Загрузка файлов по ссылке

var VK = require("VK-Promise"),
    https = require("https"),
    vk = VK("Ваш access_token");

https.get("https://fs.flyink.ru/1.png",function(stream){
    stream.filename = "filename.png";
    gr.upload(
        "docs.getUploadServer",
        "docs.save",{
            files: {file: stream}
        }
    ).then(function (r) {
        console.log("response",r)
    })
});

Дополнительные данные

Отключение повтора запроса при 6й ошибке: retry: false (по умолчанию true) Игнорирование сборщика запросов (init_execute_cart): ignore_cart: true (по умолчанию false)