Catugram Bot API

HTTP-интерфейс для ботов мессенджера Catugram в формате Telegram Bot API. Боты на aiogram, python-telegram-bot, telegraf и grammY подключаются сменой адреса сервера - при условии, что используют поддерживаемые методы.

43методов работает 33полностью 10с ограничениями 195методов в справочнике

Адрес API

Все методы вызываются по HTTPS. Формат запроса такой же, как у api.telegram.org:

https://bot.catup.lol/bot<TOKEN>/METHOD_NAME

Файлы, полученные через getFile, скачиваются по адресу:

https://bot.catup.lol/file/bot<TOKEN>/<file_path>

Имена методов не зависят от регистра. Параметры принимаются в query string, application/x-www-form-urlencoded, application/json и multipart/form-data. Ответ всегда JSON с полем ok: при успехе результат в result, при ошибке - description и error_code.

Шаг 1. Создайте бота

1. Откройте в Catugram чат с @BotFather.
2. Отправьте /newbot, укажите имя и username бота (должен заканчиваться на bot).
3. BotFather пришлёт токен вида 1234567890:AAH.... Храните его как пароль.

Шаг 2. Проверьте токен

Метод getMe возвращает информацию о боте и не требует параметров:

export TOKEN="1234567890:AAH..."
curl "https://bot.catup.lol/bot$TOKEN/getMe"

{
  "ok": true,
  "result": {
    "id": 1234567890,
    "is_bot": true,
    "first_name": "My Bot",
    "username": "my_bot"
  }
}

Шаг 3. Отправьте сообщение

Напишите боту в Catugram любое сообщение и получите обновления через getUpdates, чтобы узнать chat.id:

curl "https://bot.catup.lol/bot$TOKEN/getUpdates"

И ответьте методом sendMessage:

curl "https://bot.catup.lol/bot$TOKEN/sendMessage" \
  -H "Content-Type: application/json" \
  -d '{"chat_id": 123456789, "text": "Привет! Я работаю в <b>Catugram</b>", "parse_mode": "HTML"}'

Что дальше