![]() |
![]() |
![]() |
Olike API
Описание методов API Olike
Взаимодействие с API
Для вызова методов API необходимо выполнять HTTP запросы к следующему адресу:
http://olike.ru/api/?method=..
Особенности работы
Всем методам, кроме Авторизации и Регистрации, необходимо передавать токен session_token
Токен session_token содержится в ответе API при авторизации. При каждой авторизации этот токен меняется на новый.
Описание методов
Примеры
Запрос:
https://olike.ru/api/?method=auth.olike&olike_id=1&olike_token=olikeHjkasnJHnmsdHJK
Ответ:
{ "status": "ok", "response": { "olike_id": "1", "olike_token": "olikeHJak23HB173hjHJsdpw", "session_token": "hORG4Gb6" } }
Параметры
olike_id - id пользователя на сайте olike. Можно посмотреть в личном кабинете.
olike_token - токен пользователя на сайте olike. Можно посмотреть в личном кабинете, либо в ответе API при авторизации
Результат
olike_id - id пользователя на сайте olike. Можно посмотреть в личном кабинете.
olike_token - токен пользователя на сайте olike. Можно посмотреть в личном кабинете, либо в ответе API при авторизации
session_token - токен для подписи остальных запросов от имени авторизованного пользователя
Примеры
Запрос:
https://olike.ru/api/?method=auth.social&soc_type=vk&access_token=55fe9eced99537c8dd
Ответ:
{ "status": "ok", "response": { "olike_id": "1", "olike_token": "olikeHJak23HB173hjHJsdpw", "session_token": "hORG4Gb6" } }
Параметры
soc_type - Короткое обозначение соц. сети - vk или inst
access_token - токен пользователя в социальной сети.
Токен vk можно получить, авторизовавшить вконтакте, далее дав доступ
приложению по ссылке:
https://oauth.vk.com/authorize?scope=stats,groups,notify,photos,friends,wall,offline&redirect_uri=blank.html&display=popup&response_type=token&client_id=2900086
Токен будет находится в адресной строке.
Токен instagram можно получить, авторизовавшить в instagram, далее дав
доступ приложению по ссылке:
https://instagram.com/oauth/authorize/?client_id=1677ed07ddd54db0a70f14f9b1435579&redirect_uri=http://instagram.pixelunion.net&response_type=token
Токен будет находится в адресной строке.
Результат
olike_id - id пользователя на сайте olike. Можно посмотреть в личном кабинете.
olike_token - токен пользователя на сайте olike. Можно посмотреть в личном кабинете, либо в ответе API при авторизации
session_token - токен для подписи остальных запросов от имени авторизованного пользователя
Примеры
Запрос:
http://olike.ru/api/?method=auth.new&soc_type=vk&email=jerry@gmail.com&rules_agree=agree&access_token=55fe9eced99537c8dd
Ответ:
{ "status": "ok", "response": { "olike_id": "1", "olike_token": "olikeHJak23HB173hjHJsdpw", "session_token": "hORG4Gb6" } }
Параметры
email - email для нового пользователя
rules_agree - Если Вы соглашаетесь с правилами olike, а также с обработкой персональных данных, в этом поле нужно передать agree
soc_type - Короткое обозначение соц. сети - vk или inst
access_token - токен пользователя в социальной сети.
Токен vk можно получить, авторизовавшить вконтакте, далее дав доступ
приложению по ссылке:
https://oauth.vk.com/authorize?scope=stats,groups,notify,photos,friends,wall,offline&redirect_uri=blank.html&display=popup&response_type=token&client_id=2900086
Токен будет находится в адресной строке.
Токен instagram можно получить, авторизовавшить в instagram, далее дав
доступ приложению по ссылке:
https://instagram.com/oauth/authorize/?client_id=1677ed07ddd54db0a70f14f9b1435579&redirect_uri=http://instagram.pixelunion.net&response_type=token
Токен будет находится в адресной строке.
Результат
olike_id - id пользователя на сайте olike. Можно посмотреть в личном кабинете.
olike_token - токен пользователя на сайте olike. Можно посмотреть в личном кабинете, либо в ответе API при авторизации
session_token - токен для подписи остальных запросов от имени авторизованного пользователя
Примеры
Запрос:
https://olike.ru/api/?method=user.logout
Ответ:
{ "status": "ok" }
Параметры
нет
Результат
нет
Примеры
Запрос:
https://olike.ru/api/?method=user.info&session_token=7568F8531
Ответ:
{ "status": "ok", "response": { "olike_id": "1", "vk_id": "1111", "inst_id": "3333", "vk_screenname": "id1111", "inst_screenname": "paveldurovforefer", "balance_rub": 109200.52, "balance_vkvip": "6", "balance_vk": "5", "balance_inst": "11", "balance_ytb": "0", "referer": "0", "email": "paveldurovforefer@gmail.ru", "vk_auth_url": "mgimhlompka.ru" } }
Параметры
session_token - токен, полученный при авторизации
Результат
olike_id - id пользователя на сайте olike. Можно посмотреть в личном кабинете.
olike_token - токен пользователя на сайте olike. Можно посмотреть в личном кабинете, либо в ответе API при авторизации
vk_id - id в социальной сети vk.com
inst_id - id в социальной сети instagram.com
balance_rub - баланс баллов: рубли
balance_vkvip - баланс баллов: vkvip
balance_vk - баланс баллов: vk
balance_ytb - баланс баллов: youtube
referer - по чьей реферальной ссылке зарегестрирован
email - email указанный при регистрации
vk_auth_url - ссылка для авторизации группы vk при заказе подписчиков
Примеры
Запрос:
https://olike.ru/api/?method=user.balance.get&session_token=7568F8531
Ответ:
{ "status": "ok", "response": { "balance_rub": 109200.52, "balance_vkvip": "6", "balance_vk": "5", "balance_inst": "11", "balance_ytb": "0" } }
Параметры
session_token - токен, полученный при авторизации
Результат
balance_rub - баланс баллов: рубли
balance_vkvip - баланс баллов: vkvip
balance_vk - баланс баллов: vk
balance_fb - баланс баллов: facebook
balance_ytb - баланс баллов: youtube
Примеры
Запрос:
https://olike.ru/api/?method=tasks.get.one&order_type=vk-likes&session_token=XcGUmKC9
Ответ:
{ "status": "ok", "response": { "order_id": "14623050", "url": "https://vk.com/photo545830157_456239447", "object": "photo545830157_456239447" } }
Параметры
order_type - тип задания, который должен быть возвращен. Варианты: vk-likes, vkvip-followers, inst-likes, inst-followers
Результат
order_id - номер заказа в системе olike. Необходимо запомнить, тк проверка задания вызывается с этим параметром.
url - ссылка на задание в социальной сети
object - объект в социальной сети - использовать его где-либо не обязательно.
session_token - токен для подписи остальных запросов от имени авторизованного пользователя
Примеры
Запрос:
https://olike.ru/api/?method=tasks.check&order_id=14387718&session_token=XcGUmKC9
Ответ:
{ "status": "ok" }
{"status":"error","error":{"code":"TASKS_NOT_COMPLETED","message":"Задание не выполнено"}}
Параметры
order_id - номер задания, который нужно проверить. Получить можно при запросе задания tasks.get.one
session_token - токен для подписи остальных запросов от имени авторизованного пользователя
Результат
status: ok, если задание выполнено, либо ошибка TASKS_NOT_COMPLETED - если задание не выполнено
Примеры
Запрос:
https://olike.ru/api/?method=orders.get.list&session_token=XcGUmKC9
Ответ:
{ "status": "ok", "response": [ { "order_type": "vkvip-followers", "description": "подписчики в группу vk", "url": "https://vk.com/club111", "order_id": "14621569", "name": "Группа 111", "balance": "110", "balance_points" : "220", "start_time": "2019-06-05 16:14:26", "photo": "https://pp.userapi.com/c124123/asdB5TnZE.jpg?ava=1", "total_points": "40", "start_position" : "32901", "last_order_count" : "200", "active" : "yes", "price" : "2" },{ "order_type": "inst-followers", "description": "подписчики instagram", "url": "https://instagram.com/jdshoes", "order_id": "13818422", "name": "JDshoes", "balance": "0", "balance_points" : "0", "start_time": "2017-01-06 01:36:28", "photo": "http://scontent-fra3-1.cdninstagram.com/s150x150/f38_a.jpg", "total_points": "400", "start_position" : "789", "last_order_count" : "200", "active" : "no", "price" : "2" } ] }
Параметры
session_token - токен для подписи остальных запросов от имени авторизованного пользователя
active - Если указан, то выводятся только либо все активные задания (active=yes), либо только не активные (active=no). Если не указан - выводятся все.
Результат - массив своих заказов
order_type - тип задания, который должен быть возвращен. Варианты: vk-likes, vkvip-followers, inst-likes, inst-followers
url - на какой url был сделан заказ
order_id - номер заказа в системе olike
name - название заказа, которое было введено при заказе
balance - колличество действий, которые осталось выполнить
balance_points - баланс заказа в пересчете на баллы
start_time - когда последний раз запускали задание в работу
total_points - сколько суммарно действий было заказано на это задание
start_position - сколько было в группе подписчиков/лайков на посте на момент запуска задания
last_order_count - на сколько действий (не баллов) был сделан / пополнен заказ последний раз
active - активен ли данный заказ (yes) либо выполнен/отменен (no)
price - цена за одно действие в баллах. В будущем цена может меняться.
Примеры
Запрос:
https://olike.ru/api/?method=orders.get.one&order_id=14621569&session_token=N4nggfGY
Ответ:
{ "status": "ok", "response": { "order_type": "vkvip-followers", "description": "подписчики в группу vk", "url": "https://vk.com/club111", "order_id": "14621569", "name": "Группа 111", "balance": "110", "balance_points" : "220", "start_time": "2019-06-05 16:14:26", "photo": "https://pp.userapi.com/c124123/asdB5TnZE.jpg?ava=1", "total_points": "40", "start_position" : "32901", "last_order_count" : "200", "active" : "yes", "price" : "2" } }
Параметры
order_id - номер задания, который нужно получить.
session_token - токен для подписи остальных запросов от имени авторизованного пользователя
Результат
order_type - тип задания, который должен быть возвращен. Варианты: vk-likes, vkvip-followers, inst-likes, inst-followers
url - на какой url был сделан заказ
order_id - номер заказа в системе olike
name - название заказа, которое было введено при заказе
balance - колличество действий, которые осталось выполнить
balance_points - баланс заказа в пересчете на баллы
start_time - когда последний раз запускали задание в работу
total_points - сколько суммарно действий было заказано на это задание
start_position - сколько было в группе подписчиков/лайков на посте на момент запуска задания
last_order_count - на сколько действий (не баллов) был сделан / пополнен заказ последний раз
active - активен ли данный заказ (yes) либо выполнен/отменен (no)
price - цена за одно действие в баллах. В будущем цена может меняться.
Примеры
Запрос:
https://olike.ru/api/?method=orders.fields&order_type=inst-likes&session_token=N4nggfGY
Ответ:
{ "status": "ok", "response": [ { "field": "name", "name": "Придумайте название", "description": "Любое, например - Моя новая Аватарка" }, { "field": "count", "name": "Сколько Лайков надо накрутить", "description": "Можно накрутить минимум 5", "Min": 5, "Max": 200000 }, { "field": "link", "name": "Ссылка на фото Instagram", "description": "Ссылка на фото, которое надо накрутить" } ] }
Параметры
order_type - тип задания, который должен быть возвращен. Варианты: vk-likes, vkvip-followers, inst-likes, inst-followers
session_token - токен для подписи остальных запросов от имени авторизованного пользователя
Результат - массив полей, которые необходимо отправить для создания нового заказа
field - название поля, которое будет содержать значение для создания заказа
name - название поля
description - подробности о поле
Min - минимальное значение, которое можно передать
Max - максимальное значение, которое можно передать
Примеры
Запрос:
https://olike.ru/api/?method=orders.new&type=inst-likes&test=yes&session_token=N4nggfGY
Ответ:
Параметры
type - тип задания, который должен быть создан. Варианты: vk-likes, vkvip-followers, inst-likes, inst-followers
session_token - токен для подписи остальных запросов от имени авторизованного пользователя
test = yes - при передаче этого поля в браузере будет выведена форма заказа, аналогичная olike
POST-Параметры
Для заказа POST-запросом должны быть переданы все остальные поля. Список полей для нужного типа задания можно получить командой orders.fields
Результат
order_id - номер заказа в системе olike
Сообщения об ошибках
Если получен объект, в котором "status": "error" - значит произошла ошибка.
Пример сообщения об ошибке
{
"status": "error",
"error": {
"code": "ORDER_ERROR",
"message": "Ошибка в заказе",
"source": "count",
"description": "Вы ввели 0, а нужно Минимум 20"
}
}
Описание полей:
- code - уникальный код ошибки
- message - расшифровка ошибки
- description - дополнительные уточнения, которые могут помочь идентифицировать ошибку.
- source - Можно встретить при создании заказа. Подсказывает, в каком конкретно параметре возникла ошибка
Уникальные коды ошибок
USER_NO_AUTH: Пользователь не авторизован
USER_EXISTS: Пользователь с такими данными уже зарегистрирован
AGREE_RULES: Требуется принять правила сервиса
AUTH_FAILED: Ошибка авторизации
REG_FAILED: Ошибка регистрации
TOKEN_FAILED: Ошибка данных соц.сети. Возможно, токен устарел.
BAD_EMAIL: Такой e-mail не подходит, либо не указан
METHOD_NOT_EXISTS: Метод API указан не верно, либо не указан
PARAMETERS_ERROR: Неправильно указаны параметры запроса
SESSION_WRONG: Подпись session_token устарела, либо не указана
NO_MORE_TASKS: Пока заданий больше нет
TASKS_TOO_LONG: Задание выполнялось слишком долго. Попробуйте быстрее.
TASKS_TOO_MUCH: Достигнут Лимит баланса. Потратьте баллы, чтобы заработать еще.
TASKS_NEED_CHECK: Задание требует доп. проверки. Бонус начислится позже.
TASKS_BALANCE_OVER: Баланс в задании кончился раньше, чем Вы выполнили задание
TASKS_ALREADY_CHECKED: Это задание уже проверялось ранее.
TASKS_NOT_COMPLETED: Задание не выполнено
TASKS_NOT_FOUND: Задание не найдено
ORDER_NOT_FOUND: Заказ не найден
ORDER_ERROR: Ошибка в заказе
Смотреть еще: