# 基础框架须知

## 接口通信基础说明
接口通信基础框架，BOT 开发者对接黑盒语音机器人开放平台提供的接口能力，开发出一款可用的机器人

![接口通信基础框架](https://imgheybox.max-c.com/oa/2025/08/22/2c5d39df28d2d496f17de643eb83cd8a.jpeg)

## 接口鉴权
在每次调用HTTP接口请求的时候，需要在 header 内引入 `token` 进行调用权限验证, token可在[机器人开发平台](https://open.xiaoheihe.cn/zh_cn/chat_robot/home)创建bot后获取

示例
```
{
  "headers": {
    "token": "ODYzNzY0NDM7MTc1NTc1OTk1NzYyODYzNjQ0NzsxNTU0MDM2NTkxNzk2OTM1OTY5"
  }
}

```

## 心跳
服务端需要定期发送心跳以保证连接存活 推荐以30s为周期进行心跳,发送文本`PING`,心跳发送成功之后会收到`PONG`作为响应