API

Публичный API предназначен для взаимодействия с внешними сервисами.

Методы разработаны по принципу: https://smm.targethunter.ru/api/METHOD, где METHOD - название метода. Доступные методы представлены в данной документации.

Каждый метод работает с типами запроса GET и POST (form-data и json).

Обязательные параметры для каждого запроса

api_key - API ключ

Методы

Пример запроса

Пример запроса на добавление пользователя в бота:

$url = 'https://smm.targethunter.ru/api/';
$api_key = 'cd29334cb46d4f8325deedfdea81e9b266319d074e08cd56f05b56466d2';

$method_name = 'bots/addUser';
$params = [
    'api_key' => $api_key,
    'bot_id' => '607d97c6a01c6a25972ed95e',
    'uid' => 102036383,
    'channel' => 'VK',
    'force' => 1,
    'payload' => [
        'text' => 'Текст',
        'param1' => 'param1'
    ]
];

$curl = curl_init();
curl_setopt_array($curl, [
    CURLOPT_URL => $url . $method_name,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST => true,
    CURLOPT_POSTFIELDS => http_build_query($params)
]);

$response = curl_exec($curl);
curl_close($curl);

import requests

url = f'https://smm.targethunter.ru/api/'
method = 'bots/addUser'
api_key = 'cd29334cb46d4f8325deedfdea81e9b266319d074e08cd56f05b56466d2'
params = {
    'api_key': api_key,
    'bot_id': '607d97c6a01c6a25972ed95e',
    'uid': 102036383,
    'channel': 'VK',
    'force': 1,
    'payload': {
        'text': 'Текст',
        'param1': 'param1'
    }
}

response = requests.post(url + method, data=params)

Пример запуска API из бота

При необходимости, вы можете сделать запрос к API прямо из бота. Для этого добавьте блок Действие - Запросы во вне - Отправить запрос на url.

В поле "Адрес запроса" нужно поставить url метода, который нужно вызвать. На примере ниже - это добавление пользователя в бота (url - https://smm.targethunter.ru/api/bots/addUser)

Поля в примере:

1. Нужно указать ваш ключ API

2. ID бота, которого нужно запустить (можно найти при открытии бота в ссылке после id=) Например, для ссылки https://bot.targethunter.ru/bots/edit?id=6234edd5fb3c1c06f8765b9bd6 ID бота будет 6234edd5fb3c1c06f8765b9bd6

3. ID пользователя, которого нужно добавить в бота. Если вы запускаете бота для VK, то нужно указывать ID пользователя из VK.

4. Идентификатор канала. Для явного указания из какого канала этот пользователь.

В каждое из полей можно указывать любые доступные переменные

Пример запуска API из бота с передачей дополнительных параметров

При необходимости, вы можете сделать запрос к API прямо из бота и передать дополнительные параметры, например, информацию о пользователе из переменных. Для этого добавьте блок Действие - Запросы во вне - Отправить запрос на url.

В поле "Метод" нужно выбрать POST JSON, если будете передавать дополнительные параметры через payload.

В поле "Адрес запроса" нужно поставить url метода, который нужно вызвать. На примере ниже - это добавление пользователя в бота (url - https://smm.targethunter.ru/api/bots/addUser)

Параметры полей с примерами:

Тестируем бота:

Теперь разберем бота, в которого отправили пользователя и передали данные через payload.

Пример расшифровки переданных дополнительных параметров при запуске бота через API из другого бота

Чтобы в другом боте (в которого добавляем пользователя) получить и использовать дальше для работы полученные данные из массива payload, нужно:

1) в расширенных настройках бота (в которого добавляем пользователя) обязательно включить сохранение входных параметров:

2) После начального шага в боте добавить Действие "Функции" - "Декодировать JSON" . В поле "Значение" указываем переменную, в которую сохранили входные параметры, например, {%trigger%}

3) Используйте нужные данные, обращаясь к элементам декодированного массива данных. В нашем примере был записан как result.

Тестируем бота: