简介
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"
}