API

Возможности взаимодействия с сервисом из других сервисов

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

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

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

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

api_key - API ключ

Методы

pageМетоды

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

Каждый метод можно вызывать и через GET, и через POST (form-data).

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

pageДобавить пользователя в бота

PHP

$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);

Python

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)

Webhook

Частый запрос: запустить бота по хуку или по ссылке. Пример для метода bots/addUser:

https://smm.targethunter.ru/api/bots/addUser?api_key={apiKey}&bot_id={botId}&uid={uid}&channel={channel} Замените:

{apiKey} на ваш ключ API

{botId} на ID бота, которого надо запустить. Найти id бота можно рядом с его названием. Вид: 62d718ceb6ea2a17c83aadd2

{uid} - ID пользователя, которого нужно добавить в бота. Например, vk id человека, если бот для VK. Пример: 1 - Павел Дуров.

{channel} - на название канала из этого списка. Например, VK для того, чтобы указать, что человек из канала VK.

Пример сформированной ссылки: https://smm.targethunter.ru/api/bots/addUser?api_key=12g1k105sadq124fa12&bot_id=62d718ceb6ea2a17c83aadd2&uid=1&channel=VK По этой ссылке добавится Павел Дуров в бота с id 62d718ceb6ea2a17c83aadd2

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

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

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

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

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

2. ID бота, которого нужно запустить (можно найти рядом с названием бота после #)

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

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

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