Reyta Bot API

Опрашивает новые обновления через long polling. Возвращает массив объектов Update.

allowed_updates фильтрует на чтении: отфильтрованные апдейты не возвращаются, но остаются в очереди и продолжают учитываться в pending_update_count, пока не подтверждён offset за ними.

ЗапросКопировать

curl "https://api.reyta.uz/bot<token>/getUpdates" \
  -d "timeout=30&offset=1"

ОтветКопировать

{
  "ok": true,
  "result": [
    {
      "update_id": 100001,
      "message": {
        "message_id": 42,
        "from": { "id": 987654321, "is_bot": false, "first_name": "Aziz" },
        "chat": { "id": 987654321, "type": "private" },
        "date": 1783900000,
        "text": "/start"
      }
    }
  ]
}

Регистрирует HTTPS-URL для получения обновлений через push. Reyta доставляет каждое обновление как JSON POST.

ЗапросКопировать

curl "https://api.reyta.uz/bot<token>/setWebhook" \
  -d "url=https://your-bot.example/hook&secret_token=s3cr3t"

ОтветКопировать

{ "ok": true, "result": true, "description": "Webhook was set" }

Удаляет webhook и возвращает к getUpdates.

Текущий статус webhook, число ожидающих обновлений и последняя ошибка.

Отправляет текстовое сообщение. Поддерживает форматирование Markdown/HTML и inline-клавиатуры.

Объект reply_to_message содержит id и чат отвечаемого сообщения, но не его содержимое — при необходимости запросите его по id. Поле link_preview_options в ответе не возвращается.

ЗапросКопировать

curl "https://api.reyta.uz/bot<token>/sendMessage" \
  -d "chat_id=987654321" \
  -d "text=Salom! Reyta Bot API is live." \
  -d "parse_mode=HTML"

ОтветКопировать

{
  "ok": true,
  "result": {
    "message_id": 43,
    "chat": { "id": 987654321, "type": "private" },
    "date": 1783900050,
    "text": "Salom! Reyta Bot API is live."
  }
}

Отправляет фото по file_id, HTTP-URL или загрузкой multipart.

ЗапросКопировать

curl "https://api.reyta.uz/bot<token>/sendPhoto" \
  -F chat_id=1000100 -F caption="Look" -F photo=@cat.jpg

ОтветКопировать

{
  "ok": true,
  "result": {
    "message_id": 512,
    "from": { "id": 523722417021, "is_bot": true, "first_name": "Jokebot" },
    "chat": { "id": 1000100, "type": "private" },
    "date": 1787900000,
    "caption": "Look",
    "photo": [ { "file_id": "l8BvW8G5ZiGyZcYCX...", "file_unique_id": "k9UIku2zcCg", "width": 320, "height": 240, "file_size": 8123 } ]
  }
}

Пересылает сообщение любого типа из одного чата в другой.

ЗапросКопировать

curl "https://api.reyta.uz/bot<token>/forwardMessage" \
  -d "chat_id=1000100&from_chat_id=-1001234567890&message_id=42"

ОтветКопировать

{
  "ok": true,
  "result": {
    "message_id": 516,
    "chat": { "id": 1000100, "type": "private" },
    "date": 1787900030,
    "text": "the forwarded text"
  }
}

Копирует сообщение без заголовка пересылки.

Реализовано как копирование с последующим редактированием подписи. Если редактирование не удалось, копия всё равно доставлена, но без новой подписи.

ЗапросКопировать

curl "https://api.reyta.uz/bot<token>/copyMessage" \
  -d "chat_id=1000100&from_chat_id=-1001234567890&message_id=42&caption=New caption"

ОтветКопировать

{ "ok": true, "result": { "message_id": 517 } }

Отправляет любой файл в пределах заданного лимита размера.

ЗапросКопировать

curl "https://api.reyta.uz/bot<token>/sendDocument" \
  -F chat_id=1000100 -F [email protected]

ОтветКопировать

{
  "ok": true,
  "result": {
    "message_id": 513,
    "chat": { "id": 1000100, "type": "private" },
    "date": 1787900010,
    "document": { "file_id": "qWQSGcLKbVNV1I3y...", "file_unique_id": "Ch0MHHySQBAA", "file_name": "report.pdf", "mime_type": "application/pdf", "file_size": 20481 }
  }
}

Отправляет видео в формате MP4.

Отправляет GIF или анимацию H.264/MPEG-4 без звука.

Отправляет аудиофайл для показа в музыкальном плеере.

Отправляет голосовое сообщение (OGG/OPUS).

Отправляет круглое квадратное видеосообщение.

Отправляет группу фото/видео/документов альбомом.

ЗапросКопировать

curl "https://api.reyta.uz/bot<token>/sendMediaGroup" \
  -d chat_id=1000100 \
  -d 'media=[{"type":"photo","media":"https://reyta.uz/a.jpg","caption":"one"},{"type":"photo","media":"https://reyta.uz/b.jpg"}]'

ОтветКопировать

{
  "ok": true,
  "result": [
    { "message_id": 514, "chat": { "id": 1000100, "type": "private" }, "media_group_id": "2093252871779782656", "caption": "one", "photo": [] },
    { "message_id": 515, "chat": { "id": 1000100, "type": "private" }, "media_group_id": "2093252871779782656", "photo": [] }
  ]
}

Отправляет точку на карте; может быть live-локацией.

Отправляет информацию о месте.

Отправляет телефонный контакт.

Отправляет опрос или викторину.

Пока не реализован – возвращает 501. Опросы на стороне сервера не поддерживаются.

Отправляет анимированный эмодзи со случайным значением.

Показывает статус «печатает…» или «загружает…».

Отправляет статический, анимированный или видеостикер.

ЗапросКопировать

curl "https://api.reyta.uz/bot<token>/sendSticker" \
  -d "chat_id=1000100&sticker=CAQAAAABHGv42k_AEABAvG9SmO6EnQAAAAEAAAAAAAAAAA"

ОтветКопировать

{
  "ok": true,
  "result": {
    "message_id": 1022,
    "from": { "id": 523722417021, "is_bot": true, "first_name": "Jokebot", "username": "Jokeformebot" },
    "chat": { "id": 1000100, "type": "private" },
    "date": 1787863074,
    "sticker": {
      "file_id": "CAQAAAABHGv42k_AEABAvG9SmO6EnQAAAAEAAAAAAAAAAA",
      "file_unique_id": "Chxr-NpPwBAA",
      "type": "regular",
      "width": 512,
      "height": 512,
      "is_video": true,
      "emoji": "\uD83D\uDC4D",
      "file_size": 126387
    }
  }
}

Копирует несколько сообщений сразу, без ссылки на оригинал.

Пересылает несколько сообщений сразу, сохраняя исходного автора.

Изменяет текст отправленного или inline-сообщения.

Редактирование по inline_message_id пока не поддерживается – возвращает 501. Редактирование по chat_id + message_id работает.

ЗапросКопировать

curl "https://api.reyta.uz/bot<token>/editMessageText" \
  -d "chat_id=1000100&message_id=512&text=Updated&parse_mode=HTML"

ОтветКопировать

{
  "ok": true,
  "result": {
    "message_id": 512,
    "chat": { "id": 1000100, "type": "private" },
    "date": 1787900000,
    "text": "Updated"
  }
}

Изменяет подпись медиасообщения.

Редактирование по inline_message_id пока не поддерживается – возвращает 501. Редактирование по chat_id + message_id работает.

Заменяет медиа в сообщении.

Работает по chat_id + message_id (медиа по file_id, URL или загрузка attach://; подпись из InputMedia заменяет подпись сообщения). Редактирование по inline_message_id пока не поддерживается.

Изменяет только inline-клавиатуру сообщения.

Редактирование по inline_message_id пока не поддерживается – возвращает 501. Редактирование по chat_id + message_id работает.

Перемещает активную live-локацию.

Редактирование по inline_message_id пока не поддерживается – возвращает 501. Редактирование по chat_id + message_id работает.

Удаляет сообщение, отправленное ботом, или любое сообщение, где он администратор.

ЗапросКопировать

curl "https://api.reyta.uz/bot<token>/deleteMessage" -d "chat_id=1000100&message_id=512"

ОтветКопировать

{ "ok": true, "result": true }

Удаляет несколько сообщений сразу.

Останавливает обновление активной live-локации до истечения срока.

Остановка по inline_message_id пока не поддерживается – возвращает 501. Остановка по chat_id + message_id работает.

Ставит или снимает реакцию бота на сообщение.

Останавливает активный опрос, отправленный ботом.

Возвращает true вместо итогового объекта Poll.

Отвечает на нажатие inline-кнопки; при необходимости показывает уведомление.

ЗапросКопировать

curl "https://api.reyta.uz/bot<token>/answerCallbackQuery" \
  -d "callback_query_id=4382bfdwdsb323b2d9&text=Saved"

ОтветКопировать

{ "ok": true, "result": true }

Отвечает на inline-запрос списком результатов.

Поддерживаемые типы результатов: article, photo, gif, mpeg4_gif, video, audio, voice, document, sticker, location, venue и contact - каждый и в URL-, и в cached-варианте (*_file_id), как определяет Bot API. Игры не поддерживаются и возвращают 400.

ЗапросКопировать

curl "https://api.reyta.uz/bot<token>/answerInlineQuery" \
  -d inline_query_id=1234567890 \
  -d 'results=[{"type":"article","id":"1","title":"Hello","input_message_content":{"message_text":"Hello!"}}]'

ОтветКопировать

{ "ok": true, "result": true }

Актуальная информация о чате.

Возвращает полный ChatFullInfo. Объект pinned_message содержит id и чат закреплённого сообщения, но не его текст — при необходимости запросите его по id.

ЗапросКопировать

curl "https://api.reyta.uz/bot<token>/getChat" -d chat_id=-1001234567890

ОтветКопировать

{
  "ok": true,
  "result": {
    "id": -1001234567890,
    "type": "supergroup",
    "title": "Reyta devs",
    "username": "reytadevs",
    "description": "Server talk",
    "invite_link": "https://t.me/+abcdef",
    "member_count": 128,
    "permissions": { "can_send_messages": true, "can_send_photos": true, "can_pin_messages": false }
  }
}

Список администраторов чата.

Информация об одном участнике чата.

ЗапросКопировать

curl "https://api.reyta.uz/bot<token>/getChatMember" -d "chat_id=-1001234567890&user_id=1000100"

ОтветКопировать

{
  "ok": true,
  "result": {
    "status": "administrator",
    "user": { "id": 1000100, "is_bot": false, "first_name": "Johan" },
    "custom_title": "Founder"
  }
}

Число участников в чате.

Фотографии профиля пользователя.

Меняет название группы, супергруппы или канала.

Меняет описание группы, супергруппы или канала.

Устанавливает новое фото чата. Бот должен быть администратором.

Удаляет фото чата.

Закрепляет сообщение в чате.

Открепляет закреплённое сообщение. Без message_id снимается последнее закрепление.

Открепляет все закреплённые сообщения в чате.

Бот покидает группу, супергруппу или канал.

Банит пользователя в группе, супергруппе или канале.

ЗапросКопировать

curl "https://api.reyta.uz/bot<token>/banChatMember" \
  -d "chat_id=-1001234567890&user_id=1000100&revoke_messages=true"

ОтветКопировать

{ "ok": true, "result": true }

Блокирует канал, который пишет в супергруппу от своего имени.

Снимает блокировку канала в супергруппе.

Устанавливает набор стикеров супергруппы.

Убирает набор стикеров у супергруппы.

Открепляет все сообщения в теме General форума.

Снимает бан, чтобы пользователь мог вернуться по ссылке-приглашению.

Ограничивает права участника супергруппы.

Повышает или понижает участника, задавая права администратора.

Задаёт произвольное звание администратору, назначенному ботом.

Задаёт права по умолчанию для всех участников супергруппы.

ЗапросКопировать

curl "https://api.reyta.uz/bot<token>/setChatPermissions" \
  -d chat_id=-1001234567890 \
  -d 'permissions={"can_send_messages":true,"can_send_photos":false}'

ОтветКопировать

{ "ok": true, "result": true }

Создаёт новую основную ссылку-приглашение, отзывая предыдущую.

Создаёт дополнительную ссылку-приглашение со сроком действия или лимитом участников.

Изменяет ссылку-приглашение, созданную ботом.

Отзывает ссылку-приглашение, чтобы она перестала работать.

Одобряет заявку на вступление в чат.

Отклоняет заявку на вступление в чат.

Базовая информация о боте. Быстрый способ проверить токен.

Задаёт список команд бота.

ЗапросКопировать

curl "https://api.reyta.uz/bot<token>/setMyCommands" \
  -d 'commands=[{"command":"start","description":"Begin"},{"command":"help","description":"How it works"}]' \
  -d 'scope={"type":"all_private_chats"}'

ОтветКопировать

{ "ok": true, "result": true }

Текущий список команд бота.

Задаёт имя бота.

Текущее имя бота.

Задаёт описание бота.

Меняет кнопку меню бота в чате.

Тип кнопки web_app отклоняется с 400. Только для личных чатов.

Выходит из облачного Bot API перед переносом бота на свой сервер.

Удаляет список команд бота для указанной области и языка.

Возвращает описание бота, показываемое на пустом экране чата.

Задаёт краткое описание, показываемое в профиле бота.

Возвращает краткое описание бота.

Возвращает кнопку меню бота для чата или значение по умолчанию.

Возвращает только default или commands. Кнопка любого другого типа читается как default.

Задаёт права администратора, запрашиваемые при добавлении бота в чат.

Возвращает права администратора бота по умолчанию.

Устанавливает эмодзи-статус пользователя с помощью доступного боту кастомного эмодзи.

Закрывает экземпляр бота перед переносом между серверами.

Принимается и отвечает true, но ничего не делает – в Reyta нет модели локального сервера.

Готовит файл к загрузке и возвращает File с его путём.

ЗапросКопировать

curl "https://api.reyta.uz/bot<token>/getFile" -d file_id=CAQAAAABHQwcfJJAEAAQgUZMXHglLAAAAAEAAAAAAAAAAA

ОтветКопировать

{
  "ok": true,
  "result": {
    "file_id": "CAQAAAABHQwcfJJAEAAQgUZMXHglLAAAAAEAAAAAAAAAAA",
    "file_unique_id": "Ch0MHHySQBAA",
    "file_size": 888,
    "file_path": "sticker/CAQAAAABHQwcfJJAEAAQgUZMXHglLAAAAAEAAAAAAAAAAA"
  }
}

Набор стикеров по имени.

Информация о кастомных эмодзи-стикерах по id.

Создаёт новый набор стикеров, принадлежащий пользователю.

Владельцем набора становится создавший его бот, а не user_id — Reyta проставляет владельца по вызывающему API. Параметр needs_repainting принимается, но не сохраняется.

ЗапросКопировать

curl "https://api.reyta.uz/bot<token>/createNewStickerSet" \
  -F user_id=1000100 -F name=mypack_by_yourbot -F title="My pack" \
  -F 'stickers=[{"sticker":"attach://s1","format":"static","emoji_list":["🔥"]}]' \
  -F s1=@cat.webp

ОтветКопировать

{ "ok": true, "result": true }

Удаляет стикер из набора.

Удаляет набор стикеров, созданный ботом.

Переименовывает набор стикеров, созданный ботом.

Перемещает стикер на другую позицию в наборе.

Заменяет эмодзи, связанные со стикером.

Заменяет поисковые ключевые слова стикера.

Меняет положение маски-стикера на лице.

Загружает файл стикера для последующего использования в наборе.

Файл проверяется до сохранения: формат, размеры (одна сторона 512px), частота кадров и длительность TGS, кодек WebM. Отклонённый файл получает 400 с названием нарушенного правила.

ЗапросКопировать

curl "https://api.reyta.uz/bot<token>/uploadStickerFile" \
  -F user_id=1000100 -F sticker_format=static -F sticker=@cat.webp

ОтветКопировать

{
  "ok": true,
  "result": {
    "file_id": "CAQAAAABHQwcfJJAEAAQgUZMXHglLAAAAAEAAAAAAAAAAA",
    "file_unique_id": "Ch0MHHySQBAA",
    "file_size": 888
  }
}

Добавляет новый стикер в набор, созданный ботом.

Стикер, уже входящий в набор, отклоняется с 400, а не дублируется. Добавлять может только бот-владелец набора.

Заменяет существующий стикер в наборе.

Замена добавляется до удаления старого стикера, поэтому отклонённая замена оставляет набор нетронутым.

Задаёт обложку набора стикеров.

Обложкой может быть только стикер из этого же набора; загрузка отдельного изображения возвращает 400.

Задаёт обложку набора кастомных эмодзи.

Создаёт тему в форуме-супергруппе.

Изменяет имя/значок темы форума.

Удаляет тему форума вместе с её сообщениями.

Закрывает тему форума – новые сообщения отправить нельзя.

Снова открывает закрытую тему форума.

Открепляет все закреплённые сообщения в теме форума.

Переименовывает тему General в форуме.

Закрывает тему General в форуме.

Снова открывает тему General в форуме.

Скрывает тему General из списка тем форума.

Снова показывает тему General.

Возвращает стикеры, доступные как иконки тем форума.

В Reyta нет курируемого набора иконок тем. Оператор может указать серверу набор кастомных эмодзи; до этого метод возвращает пустой массив, и клиенты не показывают выбор иконок.