API для разработчиков
Обновление 14.11.2019:
Изменён метод получение заданий ( добавлен параметр soc_id )
Дополнен ответ метода привязки аккаунта VK
Дополнен ответ метода привязки аккаунта Instagram
25.03.2020:
Введено ограничение на получение заданий ( прежде чем получить новую порцию заданий, вы обязаны отправить на проверку предыдущие )
Изменён метод получение заданий ( добавлен параметр soc_id )
Дополнен ответ метода привязки аккаунта VK
Дополнен ответ метода привязки аккаунта Instagram
25.03.2020:
Введено ограничение на получение заданий ( прежде чем получить новую порцию заданий, вы обязаны отправить на проверку предыдущие )
Содержание
- FAQ
- Ограничения в API
- Проверка регистрации пользователя
- Регистрация пользователя
- Запрос восстановления пароля
- Получение access_token
- Обновление access_token
- Профиль пользователя
- Применение промокода
- Привязка аккаунта VK, запрос 1
- Привязка аккаунта VK, запрос 2, отправляется после того, как пользователь лайкнул пост
- Привязка аккаунта Instagram, запрос 1
- Привязка аккаунта Instagram, запрос 2, отправляется после того, как пользователь лайкнул пост
- Привязка аккаунта Telegram
- Привязка аккаунта Twitter
- Получение заданий
- Отправка заданий на проверку
- Получение заказов пользователя
- Создание купона
- Создание массовых купонов
- Активация купона
- Информация о массовых купонах
- Массовая активация купонов
- Получение купонов
- Получение массовых купонов
- Баланс
- Получение стоимости заданий
Часто задаваемые вопросы
Записей пока нет
Ограничения в API
В данный момент установлено ограничение на количество запросов на получение заданий с одного призязанного аккаунта соцсети в единицу времени: не больше 5 запросов в 60 секунд.
В случае превышения вышеуказанных значений, аккаунт соцсети не сможет получать новые задания в течение следующих 3 600 секунд
В случае превышения вышеуказанных значений, аккаунт соцсети не сможет получать новые задания в течение следующих 3 600 секунд
Проверка регистрации пользователя
Параметр | Пример значения | Описание |
---|---|---|
mail@example.com | E-mail, регистрацию которого необходимо проверить | |
client_id | sgj45fj459 | client_id можно получить у администрации |
client_secret | sergsergs4 | client_secret можно получить у администрации |
Пример ответа с ошибкой
"false"
Пример успешного ответа
"true"
Регистрация пользователя
Параметр | Пример значения | Описание |
---|---|---|
user1@email.com | Email для нового юзера | |
password | p@ssw0rd | Пароль для нового юзера |
client_id | sgj45fj459 | client_id можно получить у администрации |
client_secret | sergsergs4 | client_secret можно получить у администрации |
Пример ответа с ошибкой (JSON)
{ "email": [ Пользователь с таким e-mail адресом уже зарегистрирован ] }
Пример успешного ответа
"ok"
Запрос восстановления пароля
Параметр | Пример значения | Описание |
---|---|---|
user1@email.com | Email пользователя | |
client_id | sgj45fj459 | client_id можно получить у администрации |
client_secret | sergsergs4 | client_secret можно получить у администрации |
Пример ответа с ошибкой (JSON)
{ "email": [ Не доступный или не существующий email ] }
Пример успешного ответа
Инструкции отправлены вам на email
Получение access_token
Пример значения | Описание |
---|---|
{"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
Пример значения | Описание |
---|---|
{"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%'
Профиль пользователя
Пример ответа с ошибкой (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 } } }
Протестировать запрос
Ответ от сервера
Применение промокода
Параметр | Пример значения | Описание |
---|---|---|
promocode | 9zr4r | Промокод |
Пример ответа с ошибкой (JSON)
{ "promocode": Неверный промокод }
Пример успешного ответа (JSON)
"true"
Протестировать запрос
Ответ от сервера
Привязка аккаунта VK, запрос 1
Параметр | Пример значения | Описание |
---|---|---|
VkAuthForm[addr] | https://vk.com/id509149184 | Адрес страницы VK |
Пример ответа с ошибкой (JSON)
{ "addr": "Внутренняя ошибка сервиса A. Попробуйте позже.", }
Пример успешного ответа (JSON)
{ "vkauthform-likeurl": [ "https://vk.com/xxx" ] }
Протестировать запрос
Ответ от сервера
Привязка аккаунта VK, запрос 2, отправляется после того, как пользователь лайкнул пост
Параметр | Значение |
---|---|
afterlike | 1 |
Пример ответа с ошибкой (JSON)
{ "status": "fail" }
Пример успешного ответа (JSON)
{ "status": "ok", "screen_name": "gumione" "soc_id": "509149184" }
Протестировать запрос
Ответ от сервера
Привязка аккаунта Instagram, запрос 1
Параметр | Пример значения | Описание |
---|---|---|
InstaAuthViaLinkForm[addr] | https://www.instagram.com/gumione/ | Адрес страницы Instagram |
Пример ответа с ошибкой (JSON)
{ "addr": Аккаунт должен быть публичным, с аватаром и минимум 3 фото. }
Пример успешного ответа (JSON)
{ "instaauthvialinkform-likeurl": [ "http://instagram.com/p/BC8txi-G-PN" ] }
Протестировать запрос
Ответ от сервера
Привязка аккаунта Instagram, запрос 2, отправляется после того, как пользователь лайкнул пост
Параметр | Значение |
---|---|
afterlike | 1 |
Пример ответа с ошибкой (JSON)
{ "status": "fail" }
Пример успешного ответа (JSON)
{ "status": "ok", "igname": "gumione" "soc_id": "348574633" }
Протестировать запрос
Ответ от сервера
Привязка аккаунта Telegram
Пример ответа с ошибкой (JSON)
{ "name": "Forbidden", "message": Вам не разрешено производить данное действие., "code": 0, "status": 403, }
Пример успешного ответа (JSON)
{ "link": "https://t.me/blcheckbot?start=MTEyMiRmMWU5YWQ5NjBkM2Q4ZWVkZGRjYzI3N2JkZmFkNjQ2ZA__" }
Протестировать запрос
Ответ от сервера
Привязка аккаунта Twitter
Параметр | Значение |
---|---|
TwAuthForm[addr] | Адрес страницы Twitter |
Пример ответа с ошибкой (JSON)
{ "twauthform-addr": [ "Ошибка при привязке, убедитесь, что аккаунт не заблокирован и указан верный адрес" ] }
Пример успешного ответа (JSON)
{ "msg": "Аккаунт успешно привязан", "status": "ok" }
Для привязки аккаунта необходимо добавить в поле "о себе" twitter-аккаунта текст, содержащий ключевое слово (поле tw_code в методе profile), после чего отправить на текущий метод запрос с адресом привязываемого twitter-аккаунта
Протестировать запрос
Авторизуйтесь, чтоб получить ключевое слово для привязки Twitter
Ответ от сервера
Получение заданий
Параметр | Пример значения | Описание |
---|---|---|
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 |
soc_id | 345834565 |
Поле не обязательно ID аккаунта соц. сети для которого вы хотите получить задания; возвращается после привязки аккаунтов (!) По умолчанию задания выдаются для последнего привязанного аккаунта |
В противном случае, мы будем ограничивать возможность получить задания.
Спасибо за понимание!
Пример ответа с ошибкой (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 - цена(в монетах) за выполнение каждого из полученных заданий
Протестировать запрос
Ответ от сервера
Отправка заданий на проверку
Параметр | Пример значения | Описание |
---|---|---|
oid | 1455 | ID выполненного задания |
orid | 325333 | ID отчета. Получаем вместе с заданием |
Пример ответа с ошибкой (JSON)
{ "name": "Forbidden", "message": Вам не разрешено производить данное действие., "code": 0, "status": 403, }
В случае успеха ответ будет пустым с HTTP-кодом 200
Протестировать запрос
Ответ от сервера
Получение заказов пользователя
Параметр | Пример значения | Описание |
---|---|---|
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" } ] }
Протестировать запрос
Ответ от сервера
Создание купона
Параметр | Пример значения | Описание |
---|---|---|
CouponForm[amount] | 100 | Сумма монет, на которую будет выпущен купон |
Пример ответа с ошибкой (JSON)
{ "couponform-amount": [ Не хватает монет для создания купона ] }
Пример успешного ответа (JSON)
{ "msg": Купон успешно создан }
Протестировать запрос
Ответ от сервера
Создание массовых купонов
Параметр | Пример значения | Описание |
---|---|---|
MassCouponForm[amount] | 100 | Сумма монет, на которую будет выпущен каждый из купонов |
MassCouponForm[quantity] | 20 | Количество купонов |
Пример ответа с ошибкой (JSON)
{ "masscouponform-quantity": [ Значение «Кол-во купонов» не должно превышать 150. ], "masscouponform-amount": [ Не хватает монет для создания купонов ] }
Пример успешного ответа (JSON)
{ "msg": Купоны успешно созданы }
Протестировать запрос
Ответ от сервера
Активация купона
Параметр | Пример значения | Описание |
---|---|---|
CouponForm[coupon] | 1q98_bestliker.biz_dq42 | Код купона, формат: /[0123456789qwrtusdfghjkzvbnm]{4}(_bestliker\.biz_)[0123456789qwrtusdfghjkzvbnm]{4}/i |
Пример ответа с ошибкой (JSON)
{ "couponform-coupon": [ Такого купона не существует либо он уже был активирован ] }
Пример успешного ответа (JSON)
{ "msg": Купон успешно активирован }
Протестировать запрос
Ответ от сервера
Информация о массовых купонах
Параметр | Пример значения | Описание |
---|---|---|
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" ] }
Протестировать запрос
Ответ от сервера
Массовая активация купонов
Параметр | Пример значения | Описание |
---|---|---|
MassCouponActivationForm[coupons] |
1q98_bestliker.biz_dq42 mt2r_bestliker.biz_19mq |
Коды купонов, каждый с новой строки, максимум 100 |
Пример ответа с ошибкой (JSON)
{ "masscouponactivationform-coupons": [ Необходимо заполнить «Купоны». ] }
Пример успешного ответа (JSON)
{ "msg": Купоны успешно активированы }
Протестировать запрос
Ответ от сервера
Получение купонов
Пример ответа с ошибкой (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 } ]
Протестировать запрос
Ответ от сервера
Получение массовых купонов
Пример ответа с ошибкой (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 } ]
Протестировать запрос
Ответ от сервера
Баланс
Пример ответа с ошибкой (JSON)
{ "name": "Forbidden", "message": "Вам не разрешено производить данное действие.", "code": 0, "status": 403, }
Пример успешного ответа (JSON)
{ "balance": { "balance": "98500", "bonus": "821" } }
Протестировать запрос
Ответ от сервера
Получение стоимости заданий
Пример ответа с ошибкой (JSON)
{ "name": "Forbidden", "message": "Вам не разрешено производить данное действие.", "code": 0, "status": 403, }
Пример успешного ответа (JSON)
{ "instaLikeCost": "1", "instaSubsCost": "2", "vkLikeCost": "1", "vkSubsCost": "2", "vkJoinCost": "3", "vkShareCost": "2", "fbLikeCost": "2", "fbSubsCost": "2", "fbJoinCost": "2", "ytLikeCost": "1", "ytSubsCost": "2", "ytDislikeCost": "1", "twLikeCost": "2", "twSubsCost": "1" }