创建机器人

在Potato客户端中搜索@BotFather，然后完成下面的步骤:

• 打开BotFather聊天框，输入 /newbot 命令。
• 输入机器人的昵称。
• 输入机器人唯一的用户名。
• 收到创建成功消息及token时表示创建完成

机器人token

每个机器人在创建时都会获得一个唯一的token来标志身份。 例如 123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11， 机器人所有的接口调用都必须带上token， 请妥善保管。 参考创建机器人获取token。

所有机器人接口调用必须通过HTTPS，格式如下所示: https://api.rct2008.com:8443/<bot_token>/METHOD_NAME 例如机器人获取自身信息: https://api.rct2008.com:8443/123456909:ABC-DEF1234ghIkl-zyx57W2v1u123ew11/getMe

我们支持GET和POST HTTP方法。API请求中传递参数的三种方式:

• URL query string
• Application/json (最常用的json格式传递请求参数)
• Multipart/form-data (表单仅在上传文件时使用)

响应返回一个JSON对象，该对象始终有一个布尔字段“ok”和可能携带一个关于结果描述String字段“result”。 如果“ok”等于true，则请求成功，返回的数据在“result”字段中。 如果请求失败，则“ok”等于false，返回一个整数“error_code”字段，表示请求的错误码和返回一个“result”字段，包含错误描述。

• API中的所有接口名都区分大小写
• 所有请求必须使用UTF-8编码

机器人如何接收消息

• 有新消息发送到bot时， 机器人有两种方式获取消息:
• 主动模式: 机器人需要不停的的主动去调用getUpdates接口来获取消息，成功请求后，将收到一个包含消息更新列表的json对象。
• 被动模式: 机器人需要调用一次setWebhook接口，设置好回调地址。当有新消息时，Potato服务器会向机器人设置的地址POST消息，机器人同样收到一个包含消息更新列表的json对象

发给机器人的消息会在服务器上缓存一段时间，当机器人处理了消息立即删除，超过1个小时未处理也将清除。

获取更新时发出请求

如果您使用的是webhooks，可以在获取到内容的同时向机器人发送API请求。指定要调用的方法并使用application/json或application/x-www-form-urlencoded或multipart/form-data类型来传递参数，请求成功后将得到相应结果。

获取消息更新

Potato机器人目前支持两种互斥的方式来为您的机器人接收消息更新：一种是使用getUpdates方法，另一种是使用webhooks方法。机器人的消息先会存储在Potato服务器上，直到机器人开发者以任何一种方式收到它们为止(但它们的保存时间不会超过24小时)。无论选择哪个选项，都会收到JSON序列化的Update对象。

Update

机器人收到的消息结构体如下。 有四种消息类型，普通消息， 编辑消息， 内联查询消息，按钮回调消息， 每次只会收到其中一种类型的消息。

getUpdates

请求URL

• https://api.rct2008.com:8443/<bot_token>/getUpdates

请求方式

• GET

接口描述

• 机器人调用此接口主动拉取消息也叫长轮旬(wiki)。 返回 Update 结构的数组。

返回参数

返回 Update 结构的数组

返回结果

{ "ok": true, "result": [ { "update_id": 1, "message": { "message_id": 57, "chat": { "id": 11370003, "type": 2, "title": "group1" }, "from": { "id": 22800001, "first_name": "David", "last_name": "Smith", "username": "" }, "text": "123", "date": 1544440630 }, "inline_query": null, "lang": "en" } ] }

注意

• 当给机器人设置了 webhook 则getUpdates接口将失效

setWebhook

请求URL

• https://api.rct2008.com:8443/<bot_token>/setWebhook

请求方式

• POST

接口描述

• 调用这个接口来设置一个地址来接收来自Potato服务的消息。 当机器人有新消息时，Potato服务器会向机器人设置的地址发送POST请求，消息为Update。为确保请求可以成功，服务器有重试机制，如果多次向webhook地址发消息失败，机器人会放弃请求。
• 为确保webhook请求是来自Potato，我们推荐使用安全的地址， 例如 https://www.example.com/<bot_token> 因为没人知道你的机器人token，可以确定请求来自Potato。

请求参数

请求示例

{ "url": "https://127.0.0.1/web-mobile", "certificate": "00050000321djau921030213" }

注意

1. 如果设置了webhook机器人的getUpdates接口将失效。
2. 如果使用自签名的证书，必须通过certificate参数上传公钥。 通过文件的方式上传，发送文件ID不生效。

delWebhook

请求URL

• https://api.rct2008.com:8443/<bot_token>/delWebhook

请求方式

• GET

接口描述

• 如果您决定切换回getUpdates方式接收消息，请使用此方法删除webhook地址。

Getting Information

getMe

请求URL

• https://api.rct2008.com:8443/<bot_token>/getMe

请求方式

• GET

接口描述

• 一种测试机器人token是否有效的简单方法, 不需要参数。 以User对象的形式返回该机器人的基本信息。

返回结果

{ "ok": true, "result": { "id": 10100427, "first_name": "ll_bot", "last_name": "", "username": "ll_bot" } }

返回参数

getFile

请求URL

• https://api.rct2008.com:8443/<bot_token>/getFile

请求方式

• POST

接口描述

• 使用此方法可获得有关文件的基本信息，并准备将其下载。 目前，机器人可以下载最大100MB的文件。 成功后，将返回一个File对象。 可以通过https://api.rct2008.com:8443/<bot_token>/<file_path>链接下载文件 。

请求参数

请求示例

{ "file_id": "000001009814fcd09659fdcd80bf5224" }

返回参数

返回结果

{ "ok": true, "result": { "url": "https://api.rct2008.com:8443/files/10000000:p6KKlJ7JWa6XKEj7cJ6/0000fcd09659fdcd80bf5224.mp3" } }

Send A Message

sendTextMessage

请求URL

• https://api.rct2008.com:8443/<bot_token>/sendTextMessage

请求方式

• POST

接口描述

• 发送消息接口，可以向用户，群组，频道发送消息，发送成功，则返回消息的ID。

请求参数

请求示例

{ "chat_type":1, "chat_id":20216742, "text":"aaqwerwqerwqerwerqwrqwerqwerqrqwerqwerwerqa", "markdown" : true, "reply_markup":{ "type": 4, "inline_keyboard": [ { "buttons": [ { "text": "Button1", "callback_data": "123" }, { "text": "Button2", "callback_data": "abcde" } ] }, { "buttons": [ { "text": "Button3", "callback_data": "22222" }, { "text": "Button4", "callback_data": "333" } ] } ] } }

返回参数

返回结果

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

Formatting options

• 机器人支持几种基本的markdown语法。包括字体加粗、倾斜、链接、代码段。
• 注意当您在Potato客户端打开一个链接时，客户端会弹出一个警告窗来提时您是否确认要打开链接。
• 关于markdown的详细内容请参考富文本。

forwardMessage

请求URL

• https://api.rct2008.com:8443/<bot_token>/forwardMessage

请求方式

• POST

接口描述

• 转发机器人或用户消息。 调用成功将返回消息的ID。

请求参数

请求示例

{ "chat_type": 1, "chat_id": 8000012, "from_chat_type": 1, "from_chat_id": 8000042, "message_id": 523621234 }

返回参数

返回结果

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

answerCallbackQuery

请求URL

• https://api.rct2008.com:8443/<bot_token>/answerCallbackQuery

请求方式

• POST

接口描述

• 当用户点击内联按钮时调用此方法来进行回复。 回复的内容将会以气泡弹窗的形式显示在客户端，如果按钮是链接，则以警告弹窗的形式显示在客户端。

请求参数

请求示例

{ "inline_message_id": "521521325217527362323", "text": "Alert", "show_alert": true }

返回结果

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

sendLocation

请求URL

• https://api.rct2008.com:8443/<bot_token>/sendLocation

请求方式

• POST

接口描述

• 使用此接口向用户发送地理位置，调用成功，返回消息ID

请求参数

请求示例

{ "chat_type": 1, "chat_id": 8000023, "latitude": 212.03, "longitude": 54.12 }

返回参数

返回结果

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

sendVenue

请求URL

• https://api.rct2008.com:8443/<bot_token>/sendVenue

请求方式

• POST

接口描述

• 发送详细的地理位置，调用成功返回消息ID。

请求参数

请求示例

{ "chat_type": 1, "chat_id": 8000023, "latitude": 33.6, "longitude": -111.9, "title": "Musical Instrument Museum", "address": "Phoenix,Arizona" }

返回参数

返回结果

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

sendPhoto

请求URL

• https://api.rct2008.com:8443/<bot_token>/sendPhoto

请求方式

• POST

接口描述

• 发送图片接口。 目前可以发送的最大图片不能超过3M，支持 JPEG/PNG/BMP/WEBP 等格式。调用成功，返回图片ID和消息ID。

请求参数

请求示例

{ "chat_type": 1, "chat_id": 8000012, "photo": "00000220aa47fca4bf5dfd5b49d552b9" }

返回参数

返回结果

{ "ok": true, "result": { "message_id": 27315, "file_id": "00050000321djau921030213" } }

sendDocument

请求URL

• https://api.rct2008.com:8443/<bot_token>/sendDocument

请求方式

• POST

接口描述

• 发送文件, 目前可以发送的最大图片不能超过100M。调用成功返回文件ID和消息ID

请求参数

请求示例

{ "chat_type": 1, "chat_id": 8000012, "document": "aaadeaamadf6knpuata7w2sceqpdjrpq" }

返回参数

返回结果

{ "ok": true, "result": { "message_id": 27315, "file_id": "00050000321djau921030213" } }

sendVideo

请求URL

• https://api.rct2008.com:8443/<bot_token>/sendVideo

请求方式

• POST

接口描述

• 发送视频， Potato客户支持MP4视频（其他格式也可以作为文档)发送）。 成功后，将返回发送的消息。 目前可以发送最大50 MB的视频文件，以后可能会更改此限制。

请求参数

请求示例

{ "chat_type": 1, "chat_id": 8000012, "video": "000002229ad7056e1e5ddc6018da56dc" }

返回参数

返回结果

{ "ok": true, "result": { "message_id": 27315, "file_id": "000002229ad7056e1e5ddc6018da56dc" } }

sendAudio

请求URL

• https://api.rct2008.com:8443/<bot_token>/sendAudio

请求方式

• POST

接口描述

• 发送音频文件，如果想在Potato客户端播放器中显示音频，则格式必须是MP3或者M4A， 目前最大支持发送50M的音频文件。

请求参数

请求示例

{ "chat_type": 1, "chat_id": 8000012, "audio": "000002229ad7056e1e5ddc6018da56dc" }

返回参数

返回结果

{ "ok": true, "result": { "message_id": 27315, "file_id": "000002229ad7056e1e5ddc6018da56dc" } }

Edit A Message

editMessageText

请求URL

• https://api.rct2008.com:8443/<bot_token>/editMessageText

请求方式

• POST

接口描述

• 编辑机器人发送的消息，成功返回 true。

请求参数

请求示例

{ "chat_type":1, "chat_id":20000009, "message_id": 16, "text":"abcde", "markdown" : true, "reply_markup":{ "type": 2, "resize_keyboard": true, "single_use": false, "selective": false, "keyboard": [ { "buttons": [ { "text": "new Button1" }, { "text": "new Button2" } ] }, { "buttons": [ { "text": "new Button3" }, { "text": "new Button4" } ] } ] } }

返回参数

返回结果

{ "ok": true }

editMessageCaption

请求URL

• https://api.rct2008.com:8443/<bot_token>/editMessageCaption

请求方式

• POST

接口描述

• 编辑机器人发送的消息，成功返回 true。

请求参数

请求示例

{ "chat_type":1, "chat_id":20000009, "message_id": 16, "caption" : "new text", "reply_markup":{ "type": 4, "inline_keyboard": [ { "buttons": [ { "text": "new Button1", "callback_data": "123" }, { "text": "new Button2", "callback_data": "" } ] }, { "buttons": [ { "text": "new Button3", "callback_data": "" }, { "text": "new Button4", "callback_data": "" } ] } ] } }

返回参数

返回结果

{ "ok": true }

deleteMessage

请求URL

• https://api.rct2008.com:8443/<bot_token>/deleteMessage

请求方式

• POST

接口描述

• 调用此接口删除一条消息，包括通知类的服务消息，接口使用需要注意一下几点:
• 私聊 机器人只能删除机器人自己发送的消息
• 群组或频道 如果机器人是管理员，则可以删除任何消息，如果不是管理员，则只能删除它自己发送的消息。

请求参数

请求示例

{ "chat_type": 1, "chat_id": 8000012, "message_id": 27315634 }

返回参数

返回结果

{ "ok": true }

Available methods

leaveChat

请求URL

• https://api.rct2008.com:8443/<bot_token>/leaveChat

请求方式

• POST

接口描述

• 调用此接口可以让机器人主动离开群组或频道, 如果离群成功则返回true。

请求参数

请求示例

{ "chat_type": 2, "chat_id": 8000012 }

返回参数

返回结果

{ "ok": true }

getChat

请求URL

• https://api.rct2008.com:8443/<bot_token>/getChat

请求方式

• POST

接口描述

• 获取会话的详细信息，可以是单聊，群组或频道， 调用成功返回一个 Chat 对象。

请求参数

请求示例

{ "chat_type": 2, "chat_id": 8000012 }

返回参数

返回结果

{ "ok": true, "result": { "id": 11190291, "type": 2, "title": "grpnaga" } }

getChatMembersCount

请求URL

• https://api.rct2008.com:8443/<bot_token>/getChatMembersCount

请求方式

• POST

接口描述

• 获取群成员人数

请求参数

请求示例

{ "chat_type": 3, "chat_id": 8000012 }

返回参数

返回结果

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

getChatAdministrators

请求URL

• https://api.rct2008.com:8443/<bot_token>/getChatAdministrators

请求方式

• POST

接口描述

• 获取群管理员列表。成功将返回一个ChatMember对象数组，包含有关所有群组管理员的信息。如果目标群组或频道中未添加管理员，则仅返回创建者。

请求方式

请求示例

{ "chat_type": 3, "chat_id": 8000012 }

返回参数

返回结果

{ "ok": true, "result": [ { "user": { "id": 20239276, "first_name": "ray", "last_name": "ray", "username": "" }, "status": "creator" }, { "user": { "id": 10100091, "first_name": "ABCD", "last_name": "", "username": "ABCD" }, "status": "administrator", "can_change_info": true, "can_post_messages": true, "can_edit_messages": true, "can_delete_messages": true, "can_invite_users": true, "can_restrict_members": true, "can_pin_messages": true, "can_promote_members": true } ] }

setChatTitle

请求URL

• https://api.rct2008.com:8443/<bot_token>/setChatTitle

接口描述

• 更改群标题。私人聊组无权限更改。机器人必须是群组中的管理员并且赋予相应的管理员权限才能正常调用。
• 注意：在常规聊组中，仅当目标组中的"所有成员都是管理员"设置关闭时，此接口才有效。

请求方式

• POST

请求参数

请求示例

{ "chat_type": 2, "chat_id": 8000012, "title": "plane" }

返回参数

返回结果

{ "ok": true }

setChatDescription

请求URL

• https://api.rct2008.com:8443/<bot_token>/setChatDescription

请求方式

• POST

接口描述

• 更改群组或频道简介。机器人必须是群组或频道中的管理员并且赋予相应的管理员权限才能正常调用。

请求参数

请求示例

{ "chat_type": 3, "chat_id": 8000012, "description": "plane" }

返回参数

返回结果

{ "ok": true }

setJoinGroups

请求URL

• https://api.rct2008.com:8443/<bot_token>/setJoinGroups

请求方式

• POST

接口描述

• 设置个人机器人是否允许添加到群组。

请求参数

请求示例

{ "enable":true }

返回参数

返回结果

{ "ok": true }

pinChatMessage

请求URL

• https://api.rct2008.com:8443/<bot_token>/pinChatMessage

请求方式

• POST

接口描述

• 置顶超级群或频道消息。 机器人必须是超级群组管理员且具有置顶消息权限或频道管理员且具有编辑消息权限才能正常调用。

请求参数

请求示例

{ "chat_type": 3, "chat_id": 8000012, "message_id": 6234, "disable_notification": false }

返回参数

返回结果

{ "ok": true }

unpinChatMessage

请求URL

• https://api.rct2008.com:8443/<bot_token>/unpinChatMessage

请求方式

• POST

接口描述

• 取消超级群或频道置顶消息。 机器人必须是超级群组管理员且具有置顶消息权限或频道管理员且具有编辑消息权限才能正常调用。

请求参数

请求示例

{ "chat_type": 3, "chat_id": 8000012 }

返回参数

返回结果

{ "ok": true }

kickChatMember

请求URL

• https://api.rct2008.com:8443/<bot_token>/kickChatMember

请求方式

• POST

接口描述

• 踢出超级群或频道普通成员。踢出用户将加入群或频道黑名单列表。机器人必须是群组或频道中的管理员并且赋予相应的管理员权限才能正常调用。
• 在常规组中，仅当目标组中的"所有成员都是管理员"设置关闭时才能正常调用。

请求参数

请求示例

{ "chat_type": 3, "chat_id": 8000012, "user_id": 80000001 }

返回参数

返回结果

{ "ok": true }

kickNotBan

请求URL

• https://api.rct2008.com:8443/<bot_token>/kickNotBan

请求方式

• POST

接口描述

• 踢出超级群或频道普通成员。踢出用户可重新加入原群组或频道。机器人必须是群组或频道中的管理员并且赋予相应的管理员权限才能正常调用。

请求参数

请求示例

{ "chat_type": 3, "chat_id": 8000012, "user_id": 80000001 }

返回参数

返回结果

{ "ok": true }

sendChatAction

请求URL

• https://api.rct2008.com:8443/<bot_token>/sendChatAction

请求方式

• POST

接口描述

• 发送机器人消息状态(状态设置为5秒)。
• 示例: StickerBot 需要一些时间来处理请求并上传图像。机器人无需发送"正在检索图像，请稍候…"的文本消息，而可以将action=upload_photo一起使用，用户将看到机器人的"正在发送图片"状态。
• 建议在机器人的响应需要大量时间才能到达时使用此方法。

请求参数

请求示例

{ "chat_type": 2, "chat_id": 8000012, "action":"upload_document" }

返回参数

返回结果

{ "ok": true }

getGroups

请求URL

• https://api.rct2008.com:8443/<bot_token>/getGroups

请求方式

• GET

接口描述

• 获取机器人所在群组/频道。

返回参数

返回结果

{ "ok": true, "result": { "Groups": [ { "PeerID": 10945523, "PeerName": "普通群" } ], "SuperGroups": [ { "PeerID": 11705614, "PeerName": "超级群" } ], "SuperGroups": [ { "PeerID": 11775614, "PeerName": "频道" } ] } }

getGroupBlackList

请求URL

• https://api.rct2008.com:8443/<bot_token>/getGroupBlackList

请求方式

• POST

接口描述

• 获取超组中的黑名单列表。成功返回User列表。机器人必须是群组或频道中的管理员并且赋予相应的管理员权限才能正常调用。

请求参数

请求示例

{

"chat_id": 11241496

}

返回参数

返回结果

{ "ok": true, "result": [ { "user": { "id": 20241232, "first_name": "James", "last_name": "", "username": "james" }, "kicked_by": 11240103 } ] }

editGroupBlackList

请求URL

• https://api.rct2008.com:8443/<bot_token>/editGroupBlackList

请求方式

• POST

接口描述

• 管理超级组中的黑名单，机器人可以禁止用户或取消禁止用户。机器人必须是群组或频道中的管理员并且赋予相应的管理员权限才能正常调用。

请求参数

请求示例

{ "action": 1, "chat_id": 11241496, "user_id": 20241232 }

返回参数

返回结果

{ "ok": true }

lipBlock

请求URL

• https://api.rct2008.com:8443/<bot_token>/lipBlock

请求方式

• POST

接口描述

• 禁止用户在群组发送消息。机器人必须是群组或频道中的管理员并且赋予相应的管理员权限才能正常调用。

请求参数

请求示例

{ "group_id": 11241496, "user_id": 20241232 }

返回参数

返回结果

{ "ok": true }

lipUnBlock

请求URL

• https://api.rct2008.com:8443/<bot_token>/lipUnBlock

请求方式

• POST

接口描述

• 解禁用户在群组发送消息限制。机器人必须是群组或频道中的管理员并且赋予相应的管理员权限才能正常调用。

请求参数

请求示例

{ "group_id": 11241496, "user_id": 20241232 }

返回参数

返回结果

{ "ok": true }

getUserProfilePhoto

请求URL

• https://api.rct2008.com:8443/<bot_token>/getUserProfilePhoto

请求方式

• POST

接口描述

• 获取用户头像信息。

请求参数

请求示例

{ "user_id":20216682 }

返回参数

返回结果

{ "ok": true, "result": [ { "file_id": "00b00224aba34dcc825e7cdaa70003dc", "file_size": 22191, "width": 160, "height": 160 }, { "file_id": "00b00224aba3c6cd825ee2daa700d1dc", "file_size": 75297, "width": 320, "height": 320 }, { "file_id": "00b00224aba31dce825e68daa700d8dc", "file_size": 249302, "width": 640, "height": 640 }, { "file_id": "00b00224aba316cf825e00daa7001edc", "file_size": 385720, "width": 820, "height": 820 } ] }

restrictChatMember

请求URL

• https://api.rct2008.com:8443/<bot_token>/restrictChatMember

请求方式

• POST

接口描述

• 设置群组内普通用户权限。机器人必须是群组或频道中的管理员并且赋予相应的管理员权限才能正常调用。

请求参数

请求示例

{ "chat_id": 11241950, "user_id": 20241232, "permissions": { "can_send_messages": true, "can_send_media_messages": false, "can_add_web_page_previews": true }, "until_date": 1737281111 }

返回参数

返回结果

{ "ok": true }

promoteChatMember

请求URL

• https://api.rct2008.com:8443/<bot_token>/promoteChatMember

请求方式

• POST

接口描述

• 升级或降级超群组中管理员权限，默认值为True。机器人必须是群组或频道中的管理员并且赋予相应的管理员权限才能正常调用。

请求参数

请求示例

{ "chat_id": 11241950, "user_id": 20241232, "can_change_info": true, "can_post_messages": true, "can_edit_messages": true, "can_delete_messages": true, "can_invite_users": true, "can_restrict_members": true, "can_pin_messages": true, "can_promote_members": true }

返回参数

返回结果

{ "ok": true }

游戏

说明

• 更多小程序内容请关注@app。

setGameScore

请求URL

• https://api.rct2008.com:8443/<bot_token>/setGameScore

请求方式

• POST

接口描述

• 设置游戏中指定用户的分数。 成功后，如果该消息是由漫游器发送的，则返回已编辑的消息，否则返回True。如果新分数不超过用户在聊天中的当前分数并且强制为False，则返回错误。

请求参数

请求示例

{ "message_id":204, "user_id":22800001, "chat_type":1, "chat_id":22800001, "bot_id":10006000, "score":70 }

返回参数

返回结果

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

getGameHighScores

请求URL

• https://api.rct2008.com:8443/<bot_token>/getGameHighScores

请求方式

• POST

接口描述

• 获取指定用户及其在游戏中的几个邻居的分数列表数据。

请求参数

请求示例

{ "message_id":204, "user_id":22800001, "chat_type":3, "chat_id":10856320, "bot_id":10060216, "score":70 }

返回参数

返回结果

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

内联模式

• 以下方法和对象使您的机器人可以以内联模式工作。
• 更多详细信息，请参见我们的内联机器人简介。
• 要启用此模式，请先将在BotFather中使用/setinline命令开启该功能。

InlineQuery

接口描述

• 内联查询，当用户使用机器人内联查询时将收到该消息推送。

answerInlineQuery

请求URL

• https://api.rct2008.com:8443/<bot_token>/answerInlineQuery

请求方式

• POST

接口描述

• 回复内联消息查询结果，每次查询的结果不得超过50个。

请求参数

InlineQueryResult

接口描述

内联查询的一个结果。 Potato当前支持以下6种类型的结果:

• InlineQueryResultArticle

• InlineQueryResultWebsite

• InlineQueryResultGif

• InlineQueryResultPhoto

• InlineQueryResultVideo

• InlineQueryResultCachedPhoto

InlineQueryResultArticle

接口描述

• 文章类型。

InlineQueryResultWebsite

接口描述

• 网址类型。

InlineQueryResultGif

接口描述

• GIF文件类型。

InlineQueryResultPhoto

接口描述

• 图片文件类型。

InlineQueryResultVideo

接口描述

• 视频文件类型，如果InlineQueryResultVideo消息包含嵌入式视频（例如YouTube），则必须使用input_message_content替换其内容。

InlineQueryResultCachedPhoto

接口描述

• Potato服务器上存储的图片类型。

基本数据类型

Chat Type

• Potato三种基本会话。

Entity Type

• 富文本Entity。

User

• 用户基本信息。

Sample code

{ "id": 1000, "first_name": "David", "last_name": "Smith", "username": "username" }

Chat

• 用户群组内基本信息。

Sample code

{ "id": 1000, "type": 3, "title": "超级群" }

ChatPermissions

• 群组内用户权限。

Entity

• 富文本结构。

ReplyMarkup

• 自定义自定义键盘: ForceReplyType，ReplyKeyboardMarkupType，ReplyKeyboardRemoveType和InlineKeyboardMarkup。

ForceReplyType

• 显示回复界面。

ReplyKeyboardMarkup

• 自定义输入框键盘。

ReplyKeyboardRemove

• 删除当前自定义键盘。

InlineKeyboardMarkup

• 自定义消息内键盘。

按钮

ReplyMarkup Type

• 自定义自定义键盘 ReplyMarkup。

KeyboardButtonRow

• 输入框自定义键盘按钮列表。

KeyboardButton

• 输入框键盘上的自定义按钮。

InlineKeyboardButtonRow

• 消息内自定义键盘按钮列表。

InlineKeyboardButton

• 消息内自定义键盘按钮。

InputMessageContent

• 内联查询结果要发送的消息的内容，Potato目前支持以下1种类型。

Location

Venue

PhotoSize

Audio

Document

Video