Бестлайкер | API для разработчиков

API для разработчиков

Часто задаваемые вопросы

Записей пока нет

Ограничения в API

В данный момент установлено ограничение на количество запросов на получение заданий с одного призязанного аккаунта соцсети в единицу времени: не больше 5 запросов в 60 секунд.
В случае превышения вышеуказанных значений, аккаунт соцсети не сможет получать новые задания в течение следующих 3 600 секунд

Проверка регистрации пользователя

URL: https://bestliker.biz/app-api/apiuser/check-exists(метод GET)
Параметр Пример значения Описание
email mail@example.com E-mail, регистрацию которого необходимо проверить
client_id sgj45fj459 client_id можно получить у администрации
client_secret sergsergs4 client_secret можно получить у администрации

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

"false"            

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

"true"                

Регистрация пользователя

URL: https://bestliker.biz/app-api/apiuser/register (метод POST)
Параметр Пример значения Описание
email user1@email.com Email для нового юзера
password p@ssw0rd Пароль для нового юзера
client_id sgj45fj459 client_id можно получить у администрации
client_secret sergsergs4 client_secret можно получить у администрации

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

{
  "email": [
    Пользователь с таким e-mail адресом уже зарегистрирован
  ]
}                

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

"ok"                 

Запрос восстановления пароля

URL: https://bestliker.biz/app-api/apiuser/recovery (метод POST)
Параметр Пример значения Описание
email user1@email.com Email пользователя
client_id sgj45fj459 client_id можно получить у администрации
client_secret sergsergs4 client_secret можно получить у администрации

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

{
  "email": [
    Не доступный или не существующий email  ]
}                 

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

Инструкции отправлены вам на email        

Получение access_token

URL: /oauth2/token(метод POST, JSON)
Пример значения Описание
{"grant_type":"password","username":"mail@exampl.com","password":"passw0rd","client_id":"sgj45fj459","client_secret":"sergsergs4"} JSON с данными пользователя и логином/паролем API

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

{
  "name": "Unauthorized",
  "message": "Invalid username and password combination",
  "code": 0,
  "status": 401
}               

Пример успешного ответа (JSON)

{
  "access_token": "496b872d533be96b3d707d04af41647dea45ddb3",
  "expires_in": 86400,
  "token_type": "Bearer",
  "scope": null,
  "refresh_token": "ac29e016f1310ffffb6af568b93edca0e07854ae"
}             

Протестировать запрос

Ответ от сервера

Обновление access_token

URL: https://bestliker.biz/oauth2/token(метод POST, JSON)
Пример значения Описание
{"grant_type":"refresh_token","refresh_token":"ac29e016f1310ffffb6af568b93edca0e07854ae","client_id":"sgj45fj459","client_secret":"sergsergs4"} JSON с refresh_token и логином/паролем API

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

{
  "name": "Bad Request",
  "message": "Invalid refresh token",
  "code": 0,
  "status": 400
}              

Пример успешного ответа (JSON)

{
  "access_token": "a73fa198657466f8acd2ab3e4d0cf253ec5b13ac",
  "expires_in": 86400,
  "token_type": "Bearer",
  "scope": null,
  "refresh_token": "d6ffc8dd3044f2edb1b59722a46ccdd914d34749"
}    

Протестировать запрос

Ответ от сервера

Нижеследующие запросы выполняются с отправкой header 'authorization: Bearer %access_token%'

Профиль пользователя

URL: https://bestliker.biz/app-api/apiuser/profile(метод POST)

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

{
  "name": "Forbidden",
  "message": Вам не разрешено производить данное действие.,
  "code": 0,
  "status": 403
}                

Пример успешного ответа (JSON)

{
  "user": {
    "id": "2365",
    "email": "baomao@mail.ru",
    "acts": "0",
    "cbalance": "0",
    "bbalance": "0",
    "api_key": "7ed06a8b8624cec5d97fc6fe6660be54",
    "promocode": "f805r",
    "linkings" : {
        "ig": { "id": "2311939721", "name" : "alisakaify" },
        "vk": { "id": "1", "name" : "durov"},
        "yt": null,
        "tw": { "id": "256552298", "name" : "sasha35625" },
        "tg": null
    }
  }
}                

Протестировать запрос

Ответ от сервера

Применение промокода

URL: https://bestliker.biz/app-api/apiuser/promocode(метод POST)
Параметр Пример значения Описание
promocode 9zr4r Промокод

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

{
  "promocode": Неверный промокод
}                

Пример успешного ответа (JSON)

"true"                    

Протестировать запрос

Ответ от сервера

Привязка аккаунта VK, запрос 1

URL: /app-api/apiuser/linkvk(метод POST)
Параметр Пример значения Описание
VkAuthForm[addr] https://vk.com/id509149184 Адрес страницы VK

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

{
  "addr": "Внутренняя ошибка сервиса A. Попробуйте позже.",
}

Пример успешного ответа (JSON)

{
  "vkauthform-likeurl": [
    "https://vk.com/xxx"
  ]
}                    

Протестировать запрос

Ответ от сервера

Привязка аккаунта VK, запрос 2, отправляется после того, как пользователь лайкнул пост

URL: /app-api/apiuser/linkvk(метод POST)
Параметр Значение
afterlike 1

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

{
  "status": "fail"
}

Пример успешного ответа (JSON)

{
  "status": "ok",
  "screen_name": "id509149184"
}                    

Протестировать запрос

Ответ от сервера

Привязка аккаунта Instagram, запрос 1

URL: /app-api/apiuser/linkig(метод POST)
Параметр Пример значения Описание
InstaAuthViaLinkForm[addr] https://www.instagram.com/gumione/ Адрес страницы Instagram

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

{
  "addr": Аккаунт должен быть публичным, с аватаром и минимум 3 фото.
}

Пример успешного ответа (JSON)

{
  "instaauthvialinkform-likeurl": [
    "http://instagram.com/p/BC8txi-G-PN"
  ]
}                    

Протестировать запрос

Ответ от сервера

Привязка аккаунта Instagram, запрос 2, отправляется после того, как пользователь лайкнул пост

URL: /app-api/apiuser/linkig(метод POST)
Параметр Значение
afterlike 1

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

{
  "status": "fail"
}

Пример успешного ответа (JSON)

{
  "status": "ok",
  "igname": "gumione"
}                    

Протестировать запрос

Ответ от сервера

Привязка аккаунта Telegram

URL: /app-api/apiuser/linktg(метод POST)

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

{
  "name": "Forbidden",
  "message": Вам не разрешено производить данное действие.,
  "code": 0,
  "status": 403,
}

Пример успешного ответа (JSON)

{
  "link": "https://t.me/blcheckbot?start=MTEyMiRmMWU5YWQ5NjBkM2Q4ZWVkZGRjYzI3N2JkZmFkNjQ2ZA__"
}                    

Протестировать запрос

Ответ от сервера

Привязка аккаунта Twitter

URL: /app-api/apiuser/linktw (метод POST)
Параметр Значение
TwAuthForm[addr] Адрес страницы Twitter

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

{
  "twauthform-addr": [
    "Ошибка при привязке, убедитесь, что аккаунт не заблокирован и указан верный адрес"
  ]
}

Пример успешного ответа (JSON)

{
  "msg": "Аккаунт успешно привязан",
  "status": "ok"
}                   

Для привязки аккаунта необходимо добавить в поле "о себе" twitter-аккаунта текст, содержащий ключевое слово (поле tw_code в методе profile), после чего отправить на текущий метод запрос с адресом привязываемого twitter-аккаунта

Протестировать запрос

Авторизуйтесь, чтоб получить ключевое слово для привязки Twitter

Ответ от сервера

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

URL: https://bestliker.biz/app-api/query/get-tasks(метод GET)
Параметр Пример значения Описание
sn 1 Тип социальной сети:
VK - 1, Instagram - 2, YouTube - 4, Telegram - 5, Twitter - 6
type 1 Тип задания:
Вступление в группу VK / чат Telegram - 3, Добавление в друзья VK / подписка на канал Telegram / Youtube - 2, Лайк - 1, Дизлайк - 5, Репост VK / Ретвит Twitter - 7

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

{
  "status": "fail",
  "code": 3,
  "msg": Ошибка! Не активированы соц. аккаунты.
}             

Пример успешного ответа (JSON)

{
  "tasks": [
    {
      "oid": "1455",
      "link": "https://vk.com/id248376867?w=wall248376867_531",
      "orid": "325333"
    },
    {
      "oid": "1497",
      "link": "https://vk.com/wall59628_30351",
      "orid": "326443"
    },
    {
      "oid": "1498",
      "link": "https://vk.com/wall59628_30349",
      "orid": "244498"
    }
  ],
  "status": "ok",
  "count": 3,
  "price": 1,
  "ttl": "300"
}             

ttl - время(в секундах) в течение которого нужно успеть выполнить задания и отправить их на проверку
price - цена(в монетах) за выполнение каждого из полученных заданий

Протестировать запрос

Ответ от сервера

Отправка заданий на проверку

URL: https://bestliker.biz/app-api/query/check-task(метод GET)
Параметр Пример значения Описание
oid 1455 ID выполненного задания
orid 325333 ID отчета. Получаем вместе с заданием

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

{
  "name": "Forbidden",
  "message": Вам не разрешено производить данное действие.,
  "code": 0,
  "status": 403,
}           

В случае успеха ответ будет пустым с HTTP-кодом 200


Протестировать запрос

Ответ от сервера

Получение заказов пользователя

URL: https://bestliker.biz/app-api/apiuser/orders(метод GET)
Параметр Пример значения Описание
perpage 20 Необязательный параметр, по умолчанию равен 10
page 2 Текущая страница

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

{
  "name": "Forbidden",
  "message": Вам не разрешено производить данное действие.,
  "code": 0,
  "status": 403,
}            

Пример успешного ответа (JSON)

{
  "total": "2",
  "orders": [
    {
      "id": "5",
      "status": Модерация,
      "social": Инстаграм,
      "type": Подписчики,
      "speed": Минимум,
      "age": Любой,
      "location": Любая,
      "gender": Любой,
      "likes_total": "150",
      "likes_ready": "0",
      "likes_refund": 0,
      "shows": "0",
      "price": "600",
      "url": "http://instagram.com/gumione",
      "insurance": Минимальная,
      "bonus": "15",
      "bonus_ready": "0"
    },
    {
      "id": "4",
      "status": Активен,
      "social": Инстаграм,
      "type": Подписчики,
      "speed": Минимум,
      "age": Любой,
      "location": Любая,
      "gender": Любой,
      "likes_total": "150",
      "likes_ready": "0",
      "likes_refund": 0,
      "shows": "0",
      "price": "600",
      "url": "http://instagram.com/gumione",
      "insurance": Минимальная,
      "bonus": "15",
      "bonus_ready": "0"
    }
  ]
}   

Протестировать запрос

Ответ от сервера

Создание купона

URL: https://bestliker.biz/app-api/apiuser/create-coupon(метод POST)
Параметр Пример значения Описание
CouponForm[amount] 100 Сумма монет, на которую будет выпущен купон

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

{
  "couponform-amount": [
    Не хватает монет для создания купона
  ]
}         

Пример успешного ответа (JSON)

{
  "msg": Купон успешно создан
}   

Протестировать запрос

Ответ от сервера

Создание массовых купонов

URL: https://bestliker.biz/app-api/apiuser/create-coupons(метод POST)
Параметр Пример значения Описание
MassCouponForm[amount] 100 Сумма монет, на которую будет выпущен каждый из купонов
MassCouponForm[quantity] 20 Количество купонов

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

{
  "masscouponform-quantity": [
    Значение «Кол-во купонов» не должно превышать 150.
  ],
  "masscouponform-amount": [
    Не хватает монет для создания купонов
  ]
}       

Пример успешного ответа (JSON)

{
  "msg": Купоны успешно созданы
}   

Протестировать запрос

Ответ от сервера

Активация купона

URL: https://bestliker.biz/app-api/apiuser/activate-coupon(метод POST)
Параметр Пример значения Описание
CouponForm[coupon] 1q98_bestliker.biz_dq42 Код купона, формат: /[0123456789qwrtusdfghjkzvbnm]{4}(_bestliker\.biz_)[0123456789qwrtusdfghjkzvbnm]{4}/i

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

{
  "couponform-coupon": [
    Такого купона не существует либо он уже был активирован
  ]
}     

Пример успешного ответа (JSON)

{
  "msg": Купон успешно активирован
}   

Протестировать запрос

Ответ от сервера

Информация о массовых купонах

URL: https://bestliker.biz/app-api/apiuser/mass-coupons-show(метод POST)
Запрос покажет сколько купонов из списка уже было активировано, какие именно, сколько можно активировать и суммы в монетах
Параметр Пример значения Описание
coupons 1q98_bestliker.biz_dq42, mt2r_bestliker.biz_19mq Коды купонов, через запятую, максимум 100

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

{
  "name": "Forbidden",
  "message": Вам не разрешено производить данное действие.,
  "code": 0,
  "status": 403,
}   

Пример успешного ответа (JSON)

{
  "activated_count": 2,
  "not_activated_count": 0,
  "activated_total": 200,
  "not_activated_total": 0,
  "activated_coupons": [
    "mt2r_bestliker.biz_19mq",
    "1q98_bestliker.biz_dq42"
  ]
}   

Протестировать запрос

Ответ от сервера

Массовая активация купонов

URL: https://bestliker.biz/app-api/apiuser/activate-coupon(метод POST)
Параметр Пример значения Описание
MassCouponActivationForm[coupons] 1q98_bestliker.biz_dq42
mt2r_bestliker.biz_19mq
Коды купонов, каждый с новой строки, максимум 100

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

{
  "masscouponactivationform-coupons": [
    Необходимо заполнить «Купоны».
  ]
}    

Пример успешного ответа (JSON)

{
  "msg": Купоны успешно активированы
}   

Протестировать запрос

Ответ от сервера

Получение купонов

URL: https://bestliker.biz/app-api/apiuser/coupons(метод GET)

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

{
  "name": "Forbidden",
  "message": Вам не разрешено производить данное действие.,
  "code": 0,
  "status": 403,
}      

Пример успешного ответа (JSON)

[
  {
    "created_date": "2019-04-10 21:27:00",
    "activated_date": "2019-04-11 00:09:42",
    "coupon": "mt2r_bestliker.biz_19mq",
    "price": 110,
    "amount": 100,
    "activated": 1
  },
  {
    "created_date": "2019-04-11 00:05:17",
    "activated_date": null,
    "coupon": "sggv_bestliker.biz_zsgz",
    "price": 110,
    "amount": 100,
    "activated": 0
  }
]

Протестировать запрос

Ответ от сервера

Получение массовых купонов

URL: https://bestliker.biz/app-api/apiuser/mass-coupons(метод GET)
Файл с купонами доступен для скачивания по ссылке https://bestliker.biz/download-coupon?id=xxx, для загрузки пользователь должен быть авторизован на сайте под учётной записью, с которой создавал купоны

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

{
  "name": "Forbidden",
  "message": Вам не разрешено производить данное действие.,
  "code": 0,
  "status": 403,
}      

Пример успешного ответа (JSON)

[
  {
    "id": 1,
    "filename": "102_купона_по_100_10_04_2019.txt",
    "created_date": "2019-04-10 17:44:04",
    "total": 10200
  },
  {
    "id": 2,
    "filename": "150_купона_по_100_10_04_2019.txt",
    "created_date": "2019-04-10 21:27:00",
    "total": 15000
  },
  {
    "id": 3,
    "filename": "2_купона_по_100_11_04_2019.txt",
    "created_date": "2019-04-11 00:05:17",
    "total": 200
  },
  {
    "id": 4,
    "filename": "2_купона_по_100_11_04_2019.txt",
    "created_date": "2019-04-11 00:45:11",
    "total": 200
  }
]

Протестировать запрос

Ответ от сервера

Баланс

URL: https://bestliker.biz/app-api/apiuser/balance (метод GET)

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

{
  "name": "Forbidden",
  "message": "Вам не разрешено производить данное действие.",
  "code": 0,
  "status": 403,
}      

Пример успешного ответа (JSON)

{
  "balance": {
    "balance": "98500",
    "bonus": "821"
  }
}

Протестировать запрос

Ответ от сервера

Содержание

Язык сайта


Опции дизайна


Цвет