Начало работы | Общие сведения

Что такое 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!"
}