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

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

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

errorcode = 200
OK
errorcode = 401
Ошибка авторизации.
errorcode = 427
Не хватает или некорректные обязательные параметры.
errorcode = 404
Запрашеваемий ресурс не найден
errorcode = 400
Отправлен не верний запрос на сервер

Авторизация

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

Внимание! Не сообщайте никому значения вашего токена!

Для авторизации необходимо к каждому запросу добавлять header Authorization : account_token

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

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


Параметр
Описание
Пример
method
add или add_distinct
add
type
Тип задания
follow или like
url
Ссылка на задание
http://instagram.com/
name
Имя задания
10000 лайков на пост
count
Количество выполнений
10000
id = 100
id добавленного задания
isnew = true
true - cоздано новое задание, false - добавлено в существующее
curl \
--data '{"user" : 1, "key" : "xxx", "type" : "like", "link" : "https://instagram.com/2040762", "count" : 100}' \
--header 'Content-Type: application/json' \
--url http://eflike.ru/api
{
"errorcode" : 200,
"result" : {
"id" : 150,
"is_new" : true
}

"errorDescription" : ""
}
Тип задания
Описание
follow
Подписчики на аккаунт
like
Лайки на фото и видео

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

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

Параметр
Описание
Пример
id
id задания
100
errorcode = 200
Удалено
curl \
--data '{"user" : 1, "key" : "xxx", "id" : 1}' \
--header 'Content-Type: application/json' \
--url http://eflike.ru/apiv1
{
"errorcode" : 200,
}

Также возможно в одном запросе удаление нескольких заданий сразу. Для этого необходимо в параметре id вместо числа передать массив чисел (id заданий).

curl \
--data '{"user" : 1, "key" : "xxx", "id" : [1, 2]}' \
--header 'Content-Type: application/json' \
--url http://eflike.ru/api/v1
{
"errorcode" : 200,
}

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

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

Параметр
Описание
Пример
method
task/status
task/status
id
id задания
100
errorcode = 404
Задание не найдено.
Параметр
Описание
Пример
count
Общое количество выполнений.
99
count_in_progress
Всего в процесе виполнения.
20
count_done
Всего виполнено
30
status
Статус
PENDING|IN_PROGRESS|PARTIAL|CANCELED|COMPLETED

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

status
Описание
PENDING
В ожидании выполнения
IN_PROGRESS
В процессе
PARTIAL
Частичная отмена задания
CANCELED
Полная отмена задания
COMPLETED
Завершено
curl \
--data '{"id" : 1}' \
--header 'Content-Type: application/json' \
--url http://eflike.ru/api/v1/task/status

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

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

Метод
GET-POST
Формат запроса
JSON
Регистр
Все методы чувствительны к регистру.
Формат ответа
JSON

Авторизация

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

Внимание! Не сообщайте никому значения вашего токена!

Для авторизации необходимо к каждому запросу добавлять header Authorization : account_token

Создание бота

http://eflike.ru/api/v1/bot
Параметр
Описание
Пример
name
Имя
Имя бота
{
"errorcode" : 200,
"result" : ""
"errorDescription" : ""
}

Смена имени бота

http://eflike.ru/api/v1/bot/update
Параметр
Описание
Пример
id
id
201
name
Имя
Имя бота
{
"errorcode" : 200,
"result" : ""
"errorDescription" : ""
}

Добавление аккаунтов соцсети

После добавления аккаунта ви получете токен аккаунта по которому сможете проводить дальнейшие действия с аккаунтом

http://eflike.ru/api/v1/bot/account
Параметр
Описание
Пример
account_id
Числовой идентификатор аккаунта в соц.сети
204561
nick
Ник аккаунта
Vasil
bot_id
Числовой идентификатор бота
232
{
"errorcode" : 200,
"result" : {
"account_token" : "",
}

"errorDescription" : ""
}

Получение списка доступних заданий

http://eflike.ru/api/v1/tasks?account_token=$TOKEN&type=$TYPE
Параметр
Описание
Пример
account_token
Токен аккаунта
204561
type
Тип задания
follow или like
{
result: [
{
"id": 1,(id задания для взятия в роботу)
"url": "https://www.instagram.com/p/kAWuYnuIlZ", ( url по которому виполнять задание )
"count": 232,
"count_done": 2,
"user_id": 1,
"network": "INSTAGRAM", (социальная сеть)
"type": "follow", (тип задание )
}

]

"errorCode": 200,
"errorDescription": "",
}

Взятие задания в работу

http://eflike.ru/api/v1/task/start?account_token=$TOKEN&task_id=$ID
Параметр
Описание
Пример
account_token
Токен аккаунта
204561
task_id
Идентификатор задания
124
{
result:
{
"task_track_id": 1,(id о которому ви сможете подтвердить виполнения задания)
}

"errorCode": 200,
"errorDescription": "",
}

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

После выполнения задания необходимо отослать запрос о подтверждение выполнения задани.

http://eflike.ru/api/v1/task/done?account_token=$TOKEN&task_track_id=$TASK_TRACK_ID
Параметр
Описание
Пример
account_token
Токен аккаунта
204561
task_track_id
Идентификатор прогреса заданий
1241
{
result: ""
"errorCode": 200,
"errorDescription": ""
}