Archives: 13/12/2019

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

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

机器人token

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

我们支持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类型来传递参数，请求成功后将得到相应结果。