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

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

Обновление 01.05.2019:

Добавлен метод получение баланса
Добавлены формы для тестирования методов

Для получения доступа, свяжитесь с администрацией: bestlikercorphelp@gmail.com

Содержание

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

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

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

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__"
}

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

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

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

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 - цена(в монетах) за выполнение каждого из полученных заданий

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

client_id

client_secret

access_token

type

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

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

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

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

client_id

client_secret

access_token

oid

orid

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

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

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"
    }
  ]
}

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

client_id

client_secret

access_token

perpage

page

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

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

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": Купоны успешно созданы
}

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

client_id

client_secret

access_token

MassCouponForm[amount]

MassCouponForm[quantity]

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

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

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": Купоны успешно активированы
}

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

client_id

client_secret

access_token

MassCouponActivationForm[coupons]

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

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

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"
  }
}

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

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

Содержание