Mivra Bot API

Mivra Bot API 是一套 HTTP 接口，允许开发者创建功能强大的聊天机器人：收发文本、图片、视频、音频、贴纸、文件等多种类型的消息，使用长轮询或 Webhook 接收更新，并支持 Mivra 特有的临时消息（阅后即焚）能力。接口风格兼容 Telegram Bot API，已有 Telegram 机器人开发经验可零成本迁移。

提示所有接口均通过 HTTPS 调用，消息在传输中全程加密。

快速开始

1. 在 Mivra 应用内打开 @BotFather，发送 /newbot 创建机器人，获得 Bot Token（格式如 123456:ABC-DEF...）。

2. 所有请求均为 https://mivra.im/bot<TOKEN>/<METHOD>，Token 放在 URL 路径中完成认证。支持 application/json 与 multipart/form-data（上传文件时）。

3. 调用 getMe 验证 Token：

curl "https://mivra.im/bot<TOKEN>/getMe"

成功响应格式：

{
  "ok": true,
  "result": { "id": 123456789, "is_bot": true, "first_name": "我的机器人", "username": "mybot" }
}

失败响应格式：

{ "ok": false, "error_code": 400, "description": "Bad Request: chat not found" }

接收更新

机器人更新可通过两种方式接收：长轮询（getUpdates）或 Webhook 推送（setWebhook），二者互斥。

全部方法

getUpdates — 更新

setWebhook — 更新

deleteWebhook — 更新

getWebhookInfo — 更新

sendMessage — 消息

sendRichMessage — 消息

sendPhoto — 消息

sendAnimation — 消息

sendAudio — 消息

sendDocument — 消息

sendLivePhoto — 消息

sendSticker — 消息

sendVideo — 消息

sendVideoNote — 消息

sendVoice — 消息

sendContact — 消息

sendLocation — 消息

sendVenue — 消息

editMessageText — 消息

deleteMessage — 消息

answerCallbackQuery — 消息

editEphemeralMessageText — 临时消息

editEphemeralMessageMedia — 临时消息

editEphemeralMessageCaption — 临时消息

editEphemeralMessageReplyMarkup — 临时消息

deleteEphemeralMessage — 临时消息

getMe — 机器人配置

setMyCommands — 机器人配置

getMyCommands — 机器人配置

deleteMyCommands — 机器人配置

setChatMenuButton — 机器人配置

getChatMenuButton — 机器人配置

setUserEmojiStatus — 机器人配置

answerWebAppQuery — 内联与支付

savePreparedInlineMessage — 内联与支付

answerShippingQuery — 内联与支付

answerPrecheckoutQuery — 内联与支付

getFile — 文件