Х   Техподдержка
4
+
Мы работаем
Всего участников
46 чел.
Мы выплатили
0 руб.
Новых за 24 часа
0 чел.
Выплат за 24 часа
0.00 руб.



Баннер 100х100











Документация API Youtube

Общие сведения


Вы полностью отвечаете за все действия произведённые через API. При создании излишней нагрузки или не целевом использовании API, доступ к API для вас может быть заблокирован/ограничен.

Формат запросов


Все запросы выполняются на URL: https://seo-aviso.ru/api_youtube.php (POST запрос), в каждом запросе должны присутствовать обязательные 2 параметра api_key и method. По их содержимому производится авторизация и вызов метода. Запросы принимаются только с тех ip адресов, что указаны в созданном вами API ключе.

Параметр Требуется Тип Описание
api_key Да string API ключ
method Да string Метод API

Формат ответа


В ответ выдаётся JSON строка, содержащая массив в котором всегда будет присутствовать как минимум 1 элемент.

Параметр Тип Описание
success bool true - запрос успешно выполнен.
false - ошибка выполнения запроса.
error->code int Код ошибки, если success отличен от true
1хx - ошибка на этапе авторизации.
2хх - ошибка на этапе выполнения API метода.
error->message string Текст поясняющий ошибку, если success отличен от true


Доступные API методы


getAccount Информация о владельце API ключа
create Создание компании
edit Редактирование компании
getInfo Информация о компании
addBalance Добавить выполнения
changeStatus Изменить статус компании
refundBalance Возврат остатка средств
delete Удаление компании


Метод getAccount


Описание: выдаёт базовую информацию о владельце API ключа.

Параметры для запроса:
Параметр Требуется Тип Описание
api_keyДаstring API ключ
methodДаstring Метод API

Пример запроса:
{
    "api_key":"IW3YNXX3-05037f3f4a063596c4160d3d799413be",
    "method":"getAccount"
}
Пример успешного ответа:
{
    "success":true,
    "balance":13948.1,
    "currency":"RUB"
}
Параметры ответа:
Параметр Тип Описание
balancefloat Баланс в рублях
currencystring Валюта RUB

Метод create


Описание: создание новой рекламной компании.

Параметры для запроса:
Параметр Требуется Тип Описание
api_keyДаstring API ключ
methodДаstring Метод API
typeДаstring Тип компании:
view - Просмотр видео (по умолчанию)
sub - Подписка на канал
like - Лайк на видео
linkДаstring Ссылка на видео или канал
titleДаstring Заголовок компании, отображается в списке для исполнителя
amountДаint Количество выполнений
timerНетint Таймер для типа view (в секундах), без установки назначается оптимальный.

Доступные значение:
5, 10, 15, 20, 25, 30, 35, 40, 50, 60, 90, 120, 180, 240, 300
sourceНетint Источники трафика для типа view:
0 - Скрытый источник (по умолчанию)
1 - seo-aviso.ru
vipНетint Разместить в VIP блоке для типа view:
0 - Нет
1 - Да
texnoНетint Технология просмотра для типа view:
0 - 1 раз в 24 часа (по умолчанию)
1 - 1 пользователь = 1 выполнение
2 - 1 раз в 1 час
3 - 1 раз в 3 часа
4 - 1 раз в 6 часов
5 - 1 раз в 12 часов
ip_userНетint Уникальный IP адрес для типа view:
0 - любые IP адреса (по умолчанию)
1 - только уникальные IP адреса
2 - усиленные по маске до 2 чисел (255.255.)
intervalНетint Интервал последовательной раздачи:
0 - отключено (по умолчанию)
1 - по каждому часу
2 - фиксированный интервал
interval_setupНетint
string
Настроки интервала (доступные параметры)

Пример заполнения:
interval = 1 - 10,0,0,0,0,0,0,0,0,0,0,0,30,0,0,0,0,0,0,0,0,0,0,0
interval = 2 - 3600
user_ratingНетint Ограничение по рейтингу (доступные параметры)
0 - доступно для пользователей с любым рейтингом (по умолчанию)
user_date_regНетint Ограничение по дате регистрации:
0 - любая дата регистрации (по умолчанию)
1 - до 7 дней регистрации
2 - более 7 дней регистрации
user_sexНетint Ограничение по половому признаку
0 - доступно всем пользователям (по умолчанию)
1 - показывать только мужчинам
2 - показывать только женщинам
user_yearsНетstring Ограничение по возрасту (доступные параметры)
0,999 - любой возраст (по умолчанию)
geo_targetingНетint Ограничение по геотаргетингу:
0 - отключено (по умолчанию)
1 - только отмеченные
geo_countryНетstring Список стран (доступные параметры)
Указываются текстовые значения, разделенные знаком запятой (пример ru,ua,ge)
geo_cityНетstring Список городов (доступные параметры)
Указываются числовые значения, разделенные знаком запятой (пример 1,2,21)

Пример запроса:
{
    "api_key":"IW3YNXX3-05037f3f4a063596c4160d3d799413be",
    "method":"create"
    "type":"view"
    "link":"https://www.youtube.com/watch?v=gFn434YBq7k"
    "title":"Тестовая компания"
    "amount":1000
    "timer":10
}
Пример успешного ответа:
{
    "success":true,
    "id":1,
    "balance":30.5,
    "startCount":1000
}
Параметры ответа:
Параметр Тип Описание
idint ID компании
balancefloat Баланс компании (в рублях)
startCountint Количества действий (view, sub, like) на момент создания площадки.

Метод edit


Описание: редактирование компании.

Параметры для запроса:
Параметр Требуется Тип Описание
api_keyДаstring API ключ
methodДаstring Метод API
typeНетstring Тип компании:
view - Просмотр видео (по умолчанию)
sub - Подписка на канал
like - Лайк на видео
idДаint ID компании
titleНетstring Заголовок компании, отображается в списке для исполнителя
texnoНетint Технология просмотра для типа view:
0 - 1 раз в 24 часа (по умолчанию)
1 - 1 пользователь = 1 выполнение
2 - 1 раз в 1 час
3 - 1 раз в 3 часа
4 - 1 раз в 6 часов
5 - 1 раз в 12 часов
ip_userНетint Уникальный IP адрес для типа view:
0 - любые IP адреса (по умолчанию)
1 - только уникальные IP адреса
2 - усиленные по маске до 2 чисел (255.255.)
intervalНетint Интервал последовательной раздачи:
0 - отключено (по умолчанию)
1 - по каждому часу
2 - фиксированный интервал
interval_setupНетint
string
Настроки интервала (доступные параметры)

Пример заполнения:
interval = 1 - 10,0,0,0,0,0,0,0,0,0,0,0,30,0,0,0,0,0,0,0,0,0,0,0
interval = 2 - 3600
user_ratingНетint Ограничение по рейтингу (доступные параметры)
0 - доступно для пользователей с любым рейтингом (по умолчанию)
user_date_regНетint Ограничение по дате регистрации:
0 - любая дата регистрации (по умолчанию)
1 - до 7 дней регистрации
2 - более 7 дней регистрации
user_sexНетint Ограничение по половому признаку
0 - доступно всем пользователям (по умолчанию)
1 - показывать только мужчинам
2 - показывать только женщинам
user_yearsНетstring Ограничение по возрасту (доступные параметры)
0,999 - любой возраст (по умолчанию)
geo_targetingНетint Ограничение по геотаргетингу:
0 - отключено (по умолчанию)
1 - только отмеченные
geo_countryНетstring Список стран (доступные параметры)
Указываются текстовые значения, разделенные знаком запятой (пример ru,ua,ge)
geo_cityНетstring Список городов (доступные параметры)
Указываются числовые значения, разделенные знаком запятой (пример 1,2,21)

Пример запроса:
{
    "api_key":"IW3YNXX3-05037f3f4a063596c4160d3d799413be",
    "method":"edit"
    "type":"view"
    "id":1
    "title":"Тестовая компания редактирование"
    "user_years":"0,30"
}
Пример успешного ответа:
{
    "success":true
}

Метод getInfo


Описание: вывод информацию о компании, если не указывать id выведет список существующих компаний.

Параметры для запроса:
Параметры для запроса:
Параметр Требуется Тип Описание
api_keyДаstring API ключ
methodДаstring Метод API
idНетint ID компании
orderНетstring Тип сортировки: DESC|ASC (по умолчанию DESC)

Пример запроса:
{
    "api_key":"IW3YNXX3-05037f3f4a063596c4160d3d799413be",
    "method":"getInfo"
    "id":1
}
Пример успешного ответа:
{
    "success":true,
    "list":[
        {
            "id":1,
            "status":0,
            "status_msg":"active",
            "type":"view",
            "amount":999,
            "amountDone":1,
            "balance":29.97,
            "id_youtube":"gFn434YBq7k",
            "title":"Тестовая компания",
            "timer":10,
            "source":0,
            "vip":0,
            "price_u":0.02,
            "price_r":0.03,
            "status_ban":false,
            "startCount": 1000,
            "texno": 0,
            "ip_user": 0,
            "interval":0,
            "interval_setup":0,
            "user_rating":0,
            "user_date_reg":0,
            "user_sex":0,
            "user_years":"0,999",
            "geo_targeting":0,
            "geo_country":"",
            "geo_city":""
        }
    ]
}
Параметры ответа:
Параметр Тип Описание
listarray Массив списка компаний
Параметры в массиве list
idint ID компании
statusint 0 - компания активная, в работе
1 - компания остановлена, не активна
status_msgstring active - компания активная, в работе
completed - компания остановлена, не активна
typestring Тип компании:
view - Просмотр видео
sub - Подписка на канал
like - Лайк на видео, трансляцию
amountint Осталось выполнений компании
amountDoneint Сколько исполнений компании уже было
balancefloat Баланс компании (в рублях)
id_youtubestring ID видео или канала
titlestring Заголовок компании
timerint Таймер для типа view в секундах
sourceint Источники трафика для типа view:
0 - Скрытый источник (по умолчанию)
1 - seo-aviso.ru
vipint Разместить в VIP блоке для типа view:
0 - Нет
1 - Да
price_ufloat Цена оплаты исполнителю
price_rfloat Цена оплаты за одно действие компании
status_banbool Компания заблокирована
true - да false - нет
startCountint Количества действий (view, sub, like) на момент создания площадки.
texnoint Технология просмотра для типа view:
0 - 1 раз в 24 часа
1 - 1 пользователь = 1 выполнение
2 - 1 раз в 1 час
3 - 1 раз в 3 часа
4 - 1 раз в 6 часов
5 - 1 раз в 12 часов
ip_userint Уникальный IP адрес для типа view:
0 - любые IP адреса
1 - только уникальные IP адреса
2 - усиленные по маске до 2 чисел (255.255.)
intervalint Интервал последовательной раздачи:
0 - отключено
1 - по каждому часу
2 - фиксированный интервал
interval_setupint
string
Настроки интервала (доступные параметры)

Пример заполнения:
interval = 1 - 10,0,0,0,0,0,0,0,0,0,0,0,30,0,0,0,0,0,0,0,0,0,0,0
interval = 2 - 3600
user_ratingint Ограничение по рейтингу (доступные параметры)
0 - доступно для пользователей с любым рейтингом (по умолчанию)
user_date_regint Ограничение по дате регистрации:
0 - любая дата регистрации (по умолчанию)
1 - до 7 дней регистрации
2 - более 7 дней регистрации
user_sexint Ограничение по половому признаку
0 - доступно всем пользователям (по умолчанию)
1 - показывать только мужчинам
2 - показывать только женщинам
user_yearsstring Ограничение по возрасту (доступные параметры)
geo_targetingint Ограничение по геотаргетингу:
0 - отключено
1 - только отмеченные
geo_countrystring Список стран (доступные параметры)
Указываются текстовые значения, разделенные знаком запятой (пример ru,ua,ge)
geo_citystring Список городов (доступные параметры)
Указываются числовые значения, разделенные знаком запятой (пример 1,2,21)

Метод addBalance


Описание: пополнение баланса компании.

Параметры для запроса:
Параметр Требуется Тип Описание
api_keyДаstring API ключ
methodДаstring Метод API
typeНетstring Тип компании:
view - Просмотр видео (по умолчанию)
sub - Подписка на канал
like - Лайк на видео
idДаint ID компании
amountДаint Количество выполнений компании

Пример запроса:
{
    "api_key":"IW3YNXX3-05037f3f4a063596c4160d3d799413be",
    "method":"addBalance"
    "type":"view"
    "id":1
    "amount":1000
}
Пример успешного ответа:
{
    "success":true
    "balance":30.43
}
Параметры ответа:
Параметр Тип Описание
balancefloat Сумма в рублях которая была внесена на баланс компании

Метод changeStatus


Описание: управление компанией (остановка, запуск)

Параметры для запроса:
Параметр Требуется Тип Описание
api_keyДаstring API ключ
methodДаstring Метод API
typeНетstring Тип компании:
view - Просмотр видео (по умолчанию)
sub - Подписка на канал
like - Лайк на видео
idДаint ID компании
statusДаint Запустить или остановить компанию
0 - Запустить
1 - Остановить

Пример запроса:
{
    "api_key":"IW3YNXX3-05037f3f4a063596c4160d3d799413be",
    "method":"changeStatus"
    "type":"view"
    "id":1
    "status":0
}
Пример успешного ответа:
{
    "success":true
    "status":"active"
}
Параметры ответа:
Параметр Тип Описание
statusstring Статус компании:
active - компания активная, в работе
completed - компания остановлена, не активна

Метод refundBalance


Описание: возврат неизрасходованных средств, на рекламный счет.

Параметры для запроса:
Параметр Требуется Тип Описание
api_keyДаstring API ключ
methodДаstring Метод API
typeНетstring Тип компании:
view - Просмотр видео (по умолчанию)
sub - Подписка на канал
like - Лайк на видео
idДаint ID компании

Пример запроса:
{
    "api_key":"IW3YNXX3-05037f3f4a063596c4160d3d799413be",
    "method":"refundBalance"
    "type":"view"
    "id":1
}
Пример успешного ответа:
{
    "success":true
    "balance":15.35
}
Параметры ответа:
Параметр Тип Описание
balancefloat Сумма в рублях которая была возвращена на рекламный счет

Метод delete


Описание: удаление компании.

Параметры для запроса:
Параметр Требуется Тип Описание
api_keyДаstring API ключ
methodДаstring Метод API
typeНетstring Тип компании:
view - Просмотр видео (по умолчанию)
sub - Подписка на канал
like - Лайк на видео
idДаint ID компании

Пример запроса:
{
    "api_key":"IW3YNXX3-05037f3f4a063596c4160d3d799413be",
    "method":"delete"
    "type":"view"
    "id":1
}
Пример успешного ответа:
{
    "success":true
}
Контекстная реклама


Баннер 200х300



21.11.2024 | 12:51:06