Vtope API

Автоматизируйте взаимодействие со Втопе. Добавляйте, удаляйте, следите за вашими заданиями автоматически с помощью vtope API.

Общая информация

Метод
POST
Формат запроса
JSON
Регистр
Все методы чувствительны к регистру.
URL
https://vto.pe/api
Формат ответа
JSON

В ответе для каждого метода есть errorcode - код ошибки и дополнительные параметры. В случае ошибки дополнительные параметры не присутствуют в ответе.

errorcode = 0
OK
errorcode = 1
Ошибка авторизации.
errorcode = 2
Не хватает или некорректные обязательные параметры.
errorcode = 3
Неожиданная ошибка сервера. Попробуйте позже или обратитесь в поддержку.
errorcode = 4
Превышен лимит на частоту запросов.
errorcode > 4
Смотри ошибки по методам.

Авторизация

При регистрации каждый пользователь получает уникальные значения user и key.
Ваши значения user и key:

user
key

Внимание! Не сообщайте никому ваши значения user и key!
Если кто-то узнал эти данные, немедленно смените key, нажав эту ссылку.

Для авторизации необходимо к каждому запросу добавлять параметры user и key.

Добавление заданий

Задания добавляются методом add, после чего их статус становится checking (задание валидируется). Чтобы проверить, что задания пошли в работу или же возникла ошибка, необходимо проверять их статус методом progress. Валидация длится до 1 минуты на задания соцсетей и до 3 минут на задания на сайтах.


Сразу после валидации возможны следующие варианты статусов:

status
Описание
ok
Пошло в работу
notpayed
Добавлено но не оплачено. Не хватило поинтов.
stopped
Некорректное задание (не найдено/нельзя выполнить).
badtype
Неверный тип (невозможно сделать указанное действие для данной ссылки).
revalidating
Найдена запрещенная тематика. Задание отправлено на ручную проверку.
badcontent
По итогам ручной проверки задание запрещено.

Подробнее о статусах здесь. Если задание уже добавлено, то при добавлении такой же пары (ссылка, тип) заказанное кол-во выполнений добавится к существующему заданию.

Параметр
Описание
Пример
method
add
add
service
v - ВКонтакте, t - Twitter, i - Instagram, a - Ask.fm, y - Youtube, f - Facebook, o - Ok.ru, w - Сайты
v
type
Тип задания
follower
link
Ссылка на задание
http://vk.com/tj
count
Количество выполнений
10000

Дополнительные параметры

speed
Скорость: от 1 до 5. По умолчанию 1.
2
quality
Качество: от 1 до 5. По умолчанию 2.
5
option
Номер варианта ответа, начиная с 1. Только для опросов.
10
duration
Длина просмотра в минутах: от 1 до 120. Только для видео ютуб. По умолчанию - зависит от длины видео.
50
dislikes
Количество дизлайков на видео ютуб. Дизлайков не может быть заказано больше чем лайков. В случае превышения лайков выставится равное им значение. По умолчанию 0.
100
activity
Уровень активности на стене для заданий на подписки: от 0 до 4. По умолчанию 0. В ютубе обязательна активность 1ого уровня - при отсутствии параметра или значении 0 выставится 1.
2
comment
Комментарий к заданию. Не более 40 символов.
Заказ №999
id = 100
id добавленного задания
isnew = true
true - cоздано новое задание, false - добавлено в существующее
errorcode = 101
Ошибка добавления на валидацию. Некорректная ссылка.
errorcode = 201
Добавление к существующему заданию, которое сейчас валидируется. Попробуйте позже.
curl \
--data '{"user" : 1, "key" : "xxx", "method" : "add", "service" : "v", "type" : "like", "link" : "https://vk.com/wall1_2040762", "count" : 100}' \
--header 'Content-Type: application/json' \
--url https://vto.pe/api
{
"errorcode" : 0,
"id" : 1
}
Тип задания
Описание
follower
Подписчики на аккаунт или сообщество
like
Лайки на записи, опросы, фото, видео, товары, комментарии
watch
Просмотры на записи и товары
repost
Репосты записей, фото, видео, товаров
vote
Голоса в опрос
Тип задания
Описание
follower
Подписчики на аккаунт
like
Лайки на фото и видео
watch
Просмотры видео
Тип задания
Описание
follower
Подписчики на аккаунт, канал
like
Лайки на видео
watch
Просмотры видео

Активность в ютуб обязательна активность 1ого уровня - при отсутствии параметра или значении 0 выставится 1. Это вынужденная мера, необходимая для обхода фильтров ютуб и обеспечения качества накрутки.

Тип задания
Описание
follower
Подписчики на аккаунт
like
Лайки на вопрос
Тип задания
Описание
follower
Подписчики на аккаунт
like
Лайки на твит
repost
Ретвиты на твит
Тип задания
Описание
follower
Подписчики на аккаунт или сообщество
like
Лайки на записи, опросы, фото, видео
repost
Репосты записей, фото, видео
vote
Голоса в опрос
Тип задания
Описание
follower
Подписчики на аккаунт или сообщество
like
Лайки на записи, опросы, фото, видео, комментарии
repost
Репосты записей, фото, видео
vote
Голоса в опрос
Тип задания
Описание
Пример
vk_subscribe_group
Кнопка «Подписаться» на группу ВКонтакте
ссылка
vk_subscribe_account
Кнопка «Подписаться» на аккаунт ВКонтакте
ссылка
vk_share_page
Кнопка «Поделиться» страницей сайта в ВКонтакте
twitter_subscribe_account
Кнопка «Подписаться» на аккаунт Твиттер
ссылка
twitter_share_page
Кнопка «Поделиться» страницей сайта в Твиттер
facebook_subscribe_account
Кнопка «Подписаться» на аккаунт Фейсбук
ссылка
facebook_subscribe_group
Кнопка «Подписаться» на группу Фейсбук
ссылка
facebook_like_page
Кнопка «Лайк» Фейсбук
ссылка
facebook_share_page
Кнопка «Поделиться» страницей сайта в Фейсбук

* Кнопки поделиться не обязательно должны присутствовать на сайте. Если на сайте нет кнопки «Поделиться», то будут просто делаться посты со ссылкой на страницу сайта.

Удаление заданий

Удаление задания по его id.

Параметр
Описание
Пример
method
del
del
id
id задания
100
errorcode = 101
Задание не найдено
curl \
--data '{"user" : 1, "key" : "xxx", "method" : "del", "id" : 1}' \
--header 'Content-Type: application/json' \
--url https://vto.pe/api
{
"errorcode" : 0,
}

Статус и прогресс задания

Получение текущего статуса задания по его id.

Параметр
Описание
Пример
method
progress
progress
id
id задания
100
errorcode = 101
Задание не найдено
Параметр
Описание
Пример
count
Оставшееся количество выполнений.
99
initcount
Всего заказано выполнений.
100
status
Статус задания.
ok
activity_count
Оставшееся количество выполнений модуля активности в заданиях на подписки.
10
activity_initcount
Всего заказано выполнений модуля активности в заданиях на подписки.
20

Далее представлена таблица статусов заданий, которые можно встретить работая с заданиями, добавленными через API.

status
Описание
ok
Пошло в работу
notpayed
Добавлено но не оплачено. Не хватило поинтов.
stopped
Некорректное задание (не найдено/нельзя выполнить).
badtype
Неверный тип (невозможно сделать указанное действие для данной ссылки).
revalidating
Найдена запрещенная тематика. Задание отправлено на ручную проверку.
badcontent
По итогам ручной проверки задание запрещено.
blocked
Временно остановлено, т.к. из-за этого задания было заблокировано много наших пользователей ВКонтакте.

Следующие статусы можно встретить работая с заданиями созданными на сайте. Не актуально в текущей версии API.

status
Описание
stop
Задание было приостановлено
waitpayment
Ожидает поступления оплаты.
allowed
Разрешено по итогам ручной проверки. Ожидает настройки и запуска.
validating
Отправлено на ручную проверку.
nonworking
Модуль не запущен. Не был добавлен или был удален.
curl \
--data '{"user" : 1, "key" : "xxx", "method" : "progress", "id" : 1}' \
--header 'Content-Type: application/json' \
--url https://vto.pe/api
{
"errorcode" : 0,
"count" : 99,
"initcount" : 100,
"status" : "ok",
}

Информация о балансе

Получение текущего баланса внутренней валюты (количества поинтов) в системе.

Параметр
Описание
Пример
method
balance
balance
balance = 1000
На вашем балансе 1000 поинтов.
curl \
--data '{"user" : 1, "key" : "xxx", "method" : "balance"}' \
--header 'Content-Type: application/json' \
--url https://vto.pe/api
{
"errorcode" : 0,
"balance" : 1000
}