Skip to content

简介

SafeW API 是一套 HTTP 接口,允许开发者创建和管理聊天机器人。通过该 API,你可以:

  • 收发文本、图片、视频、音频、文件等多种类型的消息
  • 使用长轮询接收消息更新

API 模块

模块说明认证方式
Bot API核心机器人接口Bot Token

基本概念

Bot Token

每个机器人拥有唯一的 Token,用于 API 认证。Token 格式为一段字符串,在创建机器人时获取。

请求格式

所有 API 请求通过 HTTP 发送,支持 JSON 和 multipart/form-data 格式。URL 路径中包含 Token 用于认证。

响应格式

所有 Bot API 响应均为 JSON 格式:

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

错误响应:

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