РАБОТА С API



На данный момент получение и выполнение заданий возможно только для Инстаграм.
Ответы приходят в формате JSON

Запросы

Метод GET
Регистр Все методы чувствительны к регистру.


Типы и описание переменных

Переменная Описание Тип
$SOCIAL Идентификатор социальной сети ("i" - Инстаграм). Строка
$UTOKEN Индивидуальный токен пользователя Строка
$ID Числовой идентификатор аккаунта Число
$NICK Ник аккаунта Строка
$ATOKEN Токен аккаунта Строка


Авторизация

Для работы с api каждому пользователю выдается специальный токен $UTOKEN (пользователь может получить значение токена на странице настроек). По запросу с $UTOKEN можно получать актуальную информацию. В ответе также приходит список доступных типов заданий для выполнения и настройки выполнения, на текущий момент - это таймауты (в секундах), указывающие на сколько часто можно запрашивать задания в Инстаграм на лайки/подписки.



Запрос

https://prlikes.com/api/user.php?utoken=$UTOKEN


Пример ответа

{
"utoken": $UTOKEN,
"points": 100,(баланс)
"earned": 100,(заработано)
"earned_today": 50,(заработано ботом сегодня)
}


Авторизация аккаунтов соцсети

Для авторизация аккаунтов соцсети понадобится полученный $UTOKEN и идентификаторы аккаунта - числовой идентификатор $ID, ник $NICK и $SOFT - название софта с которого будет работать аккаунт. В ответ придет токен аккаунта $ATOKEN. В дальнейшем с помощью $ATOKEN можно получать информацию о данном аккаунте.



Запрос

https://prlikes.com/api/$SOCIAL/account.php?utoken=$UTOKEN&id=$ID&nick=$NICK&soft=$SOFT


Пример ответа

{ "atoken" : "$ATOKEN" }


Пример ответа с ошибкой

{ "error" : "invalid"(токен не найден) }


Данные аккаунта соцсети

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



Запрос

https://prlikes.com/api/$SOCIAL/account.php?atoken=$ATOKEN


Пример ответа проверенного аккаунта

{
"status": "ok",(аккаунт проверен корректно)
"quality": 1,(1-4)
"earned": 100,(заработано акком всего)
"soft" : softname (софт который используется для работы акка)
}

Примеры ответов с другими статусами

{
"status": "ok",(аккаунт проверен корректно)
"quality": 1,(1-4)
"earned": 100,(заработано акком всего)
"soft" : softname (софт который используется для работы акка)
}
{
"status" : "validating"(аккаунт проверяется)
}
{
"status" : "notfound"(аккаунт не найден)
}
{
"status" : "invalid"(atoken не найден)
}
{
"status" : "badquality"(аккаунт 0 уровня качества)
}


Получение заданий

Запрос на получение заданий отдаст ошибку если аккаунт еще не проверен или сломан. Если аккаунт проверен и готов к работе, то запрос выдаст задание. Запрашивать определенный тип задания нельзя чаще, чем указано в настройках. В случае временных проблем на сервере возможна ситуация, что информация об аккаунте выдает ответ, что аккаунт успешно проверен, а при получении задания возвращается ошибка { "error" : "invalid" }. В таком случае следует дальше пробовать запрашивать задания и после нормализации работы ошибка пропадет.



Задания на лайки


Запрос

https://prlikes.com/api/tasks/$SOCIAL/like.php?atoken=$ATOKEN


Пример ответа

{
"id": $TASKID,(id задания для отправки результата выполнения)
"shortcode": "kAWuYnuIlZ",(короткое имя фото/видео, которое будет доступно по адресу: https://www.instagram.com/p/kAWuYnuIlZ)
"item_id": "648618290896734553_195998617",(идентификатор этой записи в Инстаграм)
"points": 1.5(сколько поинтов юзер заработает за выполнение)
}


Примеры ответов с ошибками

{
"error" : "invalid"(atoken не найден)
}
{
"error" : "validating"(аккаунт проверяется)
}
{
"error" : "notfound"(аккаунт проверен и не найден/заблокирован)
}
{
"error" : "notask"(нет задания для выполнения)
}
{
"error" : "wait"(слишком часто запрашивается задание)
}
{
"error" : "badquality"(аккаунт 0 уровня качества)
}


Задания на подписки


Запрос

https://prlikes.com/api/tasks/$SOCIAL/follow.php?atoken=$ATOKEN


Пример ответа

{
"id": $TASKID,(id задания для отправки результата выполнения)
"shortcode": "maxrud95",(короткое имя пользователя)
"item_id": "244238320",(идентификатор этого пользователя в Инстаграм)
"points": 3.0(сколько поинтов юзер заработает за выполнение)
}


Примеры ответов с ошибками

{
"error" : "invalid"(atoken не найден)
}
    {
"error" : "validating"(аккаунт проверяется)
}
{
"error" : "notfound"(аккаунт проверен и не найден/заблокирован)
}
{
"error" : "notask"(нет задания для выполнения)
}
{
"error" : "wait"(слишком часто запрашивается задание)
}
{
"error" : "badquality"(аккаунт 0 уровня качества)
}


Задания на комментарии


Запрос

https://prlikes.com/api/tasks/$SOCIAL/comment.php?atoken=$ATOKEN


Пример ответа

{
"id": $TASKID,(id задания для отправки результата выполнения)
"shortcode": "kAWuYnuIlZ",(короткое имя фото/видео, которое будет доступно по адресу: https://www.instagram.com/p/kAWuYnuIlZ)
"item_id": "648618290896734553_195998617",(идентификатор этой записи в Инстаграм)
"comment": "Good post", (комментарий, если NULL то любой комментарии)
"points": 1.5(сколько поинтов юзер заработает за выполнение)
}


Примеры ответов с ошибками

{
"error" : "invalid"(atoken не найден)
}
{
"error" : "validating"(аккаунт проверяется)
}
{
"error" : "notfound"(аккаунт проверен и не найден/заблокирован)
}
{
"error" : "notask"(нет задания для выполнения)
}
{
"error" : "wait"(слишком часто запрашивается задание)
}
{
"error" : "badquality"(аккаунт 0 уровня качества)
}


Проверка выполнения задания

После выполнения задания необходимо отослать запрос на проверку выполнения. Проверка выполнится в течение нескольких минут и после этого поинты будут зачислены на счет аккаунта, которому принадлежит введенный в начале токен $UTOKEN.



Запрос

https://prlikes.com/api/tasks/$SOCIAL/ok.php?atoken=$ATOKEN&id=$TASKID


Пример ответа

{
"error": "ok"(выполнение принято на проверку)
}


Примеры ответов с ошибкой

{
"error": "invalid"(не найден аккаунт/задание)
}


Ошибки при выполнении заданий

В результате выполнения задания могут возникнуть следующие ошибки: 1. Аккаунт не смог сделать задание из-за фильтров соцсети 2. Аккаунт не смог сделать задание из-за невалидного задания (страница удалена) В этом случае необходимо отправить отдельный запрос.



Запрос

http://45.80.70.237/api/tasks/$SOCIAL/doerror.php?atoken=$ATOKEN&id=$TASKID(1)
http://45.80.70.237/api/tasks/$SOCIAL/taskerror.php?atoken=$ATOKEN&id=$TASKID(2)


Пример ответа

{
"error": "ok"(выполнение принято)
}


Примеры ответов с ошибкой

{
"error": "invalid"(не найден аккаунт/задание)
}