Bot API 是一个基于 HTTP 的接口，专为希望为 SafeW 构建机器人的开发者而设计。要了解如何创建和设置机器人，请参阅我们的“机器人入门”和“机器人常见问题解答”。

让我

授权您的机器人

每个机器人创建时都会获得一个唯一的身份验证令牌。令牌的格式类似于 ` <token> 123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11`，但本文档中我们将使用`<token>`来代替。您可以在本文档中了解如何获取令牌和生成新令牌。

提出请求

所有对 SafeW Bot API 的查询都必须通过 HTTPS 协议发送，并且需要采用以下格式：

https://api.safew.org/bot<token>/METHOD_NAME。例如：

https://api.safew.org/bot123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11/getMe

我们支持GET和POST HTTP 方法。我们支持四种在 Bot API 请求中传递参数的方式：

• URL查询字符串 

• application/x-www-form-urlencoded

• application/json（文件上传除外）

• multipart/form-data（用于上传文件） 

响应包含一个 JSON 对象，该对象始终包含一个布尔字段“ok”，并且可能包含一个可选的字符串字段“description”，其中包含对结果的易读描述。如果“ok”等于True，则表示请求成功，查询结果位于“result”字段中。如果请求失败，“ok”等于 false，错误原因将在“description”字段中说明。此外，还会返回一个整数类型的“error_code”字段，但其内容将来可能会发生变化。某些错误可能还包含一个可选的“parameters”字段（类型为 ResponseParameters），该字段有助于自动处理错误。

Bot API 中的所有方法均不区分大小写。

所有查询必须使用 UTF-8 编码。