Начало работы | Общие сведения
Что такое API?
API (от англ. application programming interface – программный интерфейс приложения) – это интерфейс, который дает возможность с помощью специальных команд управлять каким-либо программным обеспечением (приложением, сервисом, программой и т.п.).
Для чего используют API
API используется для достижения различных бизнес-целей. В данной документации мы предлагаем вам описание тех методов API, которыми вы сами сможете оперировать для выполнения своих бизнес-задач.
Начало работы | Особенности API
Протокол передачи данных
API поддерживает как HTTP-, так и HTTPS-протоколы.
Формат запросов
В API используются POST- и GET-запросы. Тип запроса указан отдельно для каждого метода.
Авторизация
Все запросы требуют Basic Auth, доступы аналогичны доступам в личный кабинет.
Структура запроса
Используется JSON-формат для отправляемых данных
Формат ответа
Форматом ответа является JSON.
Формат запросов
В API используются POST- и GET-запросы. Тип запроса указан отдельно для каждого метода.
Структура имени URL-запросов
Каждый URL начинается с адреса API (https://tg.bizandsoft.ru/api), за ним следует название метода.
Сообщения | Отправить сообщение
Метод
POST send/message
Описание
Метод позволяет отправить сообщение в подключенные каналы.
Если необходимо отправить сообщение во все каналы бота, то необходимо передать bot_id, поле channel_id в таком случае передавать не требуется.
Если используете шаблон template_id, то поле text передавать не требуется.
Ограничения
Метод доступен в соответствии с правами пользователя.
GET параметры
| Параметр | Тип данных | Описание |
|---|---|---|
| channel_id | int | id канала |
| text | string | Текст сообщения |
| template_id | int | id шаблона |
| tags | array | Список кастомных тегов key=>value |
| bot_id | int | id бота |
Пример ответа
{
"status": true,
"result_code": 200,
"message": "Success!"
}